从零到可用：OpenClaw 详细安装指南（含常见问题）

OpenClaw 是一个可扩展的个人助理框架。下面这篇文章会从最推荐的安装方式开始，覆盖多种环境（macOS / Linux / Windows/WSL2 / Docker），并附带验证与故障排查。

TL;DR： 推荐用官方安装脚本 + 一条 onboarding 命令。

✅ 一、安装前准备（系统与依赖）

系统要求：

• Node.js ≥ 22
• macOS / Linux / Windows（推荐 WSL2）
• 若从源码安装，需要 pnpm

✅ 二、推荐安装方式（官方安装脚本）

这是官方推荐方法，脚本会：

• 自动安装/升级 Node.js
• 安装 OpenClaw CLI
• 运行 onboarding

macOS / Linux

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

如果你跳过了 onboarding，可以手动运行：

openclaw onboard --install-daemon

Windows（PowerShell）

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

✅ 三、手动全局安装（适合已有 Node）

如果你已经有 Node 22+，可以直接 npm 安装：

npm install -g openclaw@latestopenclaw onboard --install-daemon

如果遇到 sharp 编译问题（常见于 macOS）：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

✅ 四、从源码安装（开发者/贡献者）

适合需要修改源码或二次开发的人：

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm ui:buildpnpm buildopenclaw onboard --install-daemon

小提示： 如果你还没全局安装 OpenClaw，可以用：

pnpm openclaw onboard --install-daemon

✅ 五、Docker 安装（可选）

如果你希望隔离环境或部署到服务器，可以用 Docker。

快速安装（推荐）

./docker-setup.sh

脚本会：

• 构建镜像
• 运行 onboarding
• 启动 gateway
• 生成 token

安装后打开：

http://127.0.0.1:18789/

✅ 六、安装完成后检查

常用检查命令：

openclaw doctoropenclaw statusopenclaw healthopenclaw dashboard

❗常见问题排查

1. 终端提示：openclaw: command not found

可能是 npm 全局 bin 没进 PATH：

npm prefix -gecho "$PATH"

在 ~/.bashrc 或 ~/.zshrc 加：

export PATH="$(npm prefix -g)/bin:$PATH"

然后重开终端。

2. npm install -g 报权限错误

通常是 npm 全局目录权限问题。官方安装脚本会自动修复。

建议直接使用：

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

3. Windows 提示 openclaw 不存在

在 PowerShell 中运行：

npm config get prefix

然后把输出路径的 \bin 加进系统 PATH。

✅ 结语

如果你想最省事、最快跑通，直接用官方安装脚本。
如果你要定制或部署到服务器，则用源码或 Docker 更合适。

需要进一步教程（如配置 Telegram/微信/Discord 接入，或插件开发）也可以继续问。