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

上篇用安装脚本跑起来了。但安装脚本只是七种方式之一------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 / pnpm

# 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

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

./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。

Podman

无根容器，比 Docker 更安全：

# 一次性配置
./setup-podman.sh

# 启动
./scripts/run-openclaw-podman.sh launch

# 注册 systemd 服务
./setup-podman.sh --quadlet

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

Nix

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

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

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

Ansible

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

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

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

Bun（实验性）

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

装完验证

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

怎么选

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

下一篇

升级、迁移与卸载。

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

GitHub 仓库：openclaw/openclaw

---

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