OpenClaw 中文文档 — 安装方式全解

科技前沿 • 2026-04-22 23:00 • 阅读 1

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

上篇用安装脚本跑起来了。但安装脚本只是七种方式之一——Docker、Podman、Nix、Ansible 都有，选适合你的。

Node 24（推荐）或 Node 22 LTS（22.16+）
macOS / Linux / Windows（WSL2）

方式一句话适合谁安装脚本一行命令，自动检测环境大多数人 npm/pnpm 手动管理 Node 的开发者精确版本控制源码编译 clone + build + link 贡献者 Docker 容器化网关服务器部署 Podman 无根容器安全优先 Nix 声明式+可回滚 NixOS 用户 Ansible 一键生产部署运维

# 标准安装 curl -fsSL https://openclaw.ai/install.sh | bash # 只装不引导 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard # 试运行 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --dry-run

Windows：

iwr -useb https://openclaw.ai/install.ps1 | iex

还有个 install-cli.sh，把 Node + OpenClaw 装到本地前缀，不碰系统环境：

curl -fsSL https://openclaw.ai/install-cli.sh | bash

# npm npm install -g openclaw@latest openclaw onboard --install-daemon # pnpm（多一步审批构建脚本） pnpm add -g openclaw@latest pnpm approve-builds -g openclaw onboard --install-daemon

sharp 编译报错？多半是全局 libvips 冲突：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install && pnpm ui:build && pnpm build pnpm link --global openclaw onboard --install-daemon

这个设计我觉得挺巧妙的——一个脚本搞定构建、引导、启动：

./docker-setup.sh

需要 Docker Desktop + Compose v2，至少 2 GB 内存。

也可以用远程镜像跳过构建：

OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest ./docker-setup.sh

几个实用环境变量：

OPENCLAW_SANDBOX=1 — 启用 Agent 沙箱
OPENCLAW_EXTRA_MOUNTS — 额外挂载
OPENCLAW_HOME_VOLUME — 命名卷持久化

启动后访问 http://127.0.0.1:18789/，Token 在 .env 文件里。

注意：gateway.bind 用 lan 或 loopback，不要写 0.0.0.0。

无根容器，比 Docker 更安全：

# 一次性配置 ./setup-podman.sh # 启动 ./scripts/run-openclaw-podman.sh launch # 注册 systemd 服务 ./setup-podman.sh --quadlet

创建专用 openclaw 用户，配置隔离。

声明式管理，最大亮点是可回滚：

home-manager switch --rollback # 一秒回退

用 nix-openclaw 模块，锁定版本 + Launchd 自启 + 声明式插件。

生产部署首选，四层安全架构：

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

一条命令装好：UFW 防火墙 + Tailscale VPN + Docker 沙箱 + Systemd 服务。部署完 nmap -p- 只有 22 端口开放。

不推荐用于 Gateway 运行时，WhatsApp/Telegram 有 Bug。开发测试可以试试。

openclaw doctor # 检查配置 openclaw status # 网关状态 openclaw dashboard # 打开面板

快速体验 → 安装脚本
精确控制 → npm/pnpm
服务器 → Docker 或 Ansible
安全优先 → Ansible（四层防御）
NixOS → Nix
贡献代码 → 源码编译

升级、迁移与卸载。

完整中文文档：OpenClaw 中文文档

GitHub 仓库：openclaw/openclaw

OpenClaw 中文文档系列第三篇，后面会一篇篇写完。觉得有用点个赞，有问题评论区聊。

OpenClaw 中文文档 — 安装方式全解

相关推荐