安装部署

本章介绍 OpenClaw 的主流安装方式：一键脚本、npm 手动安装、Docker 部署。

方式一：一键安装脚本（推荐）

macOS / Linux / WSL2

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

Windows PowerShell

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

如果只想安装、不立即进入向导：

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

方式二：npm 手动安装

# 确保 Node.js 22+
node --version

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 运行配置向导（同时安装守护进程）
openclaw onboard --install-daemon

方式三：Docker 部署

docker pull openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=sk-ant-xxx \
  openclaw/openclaw:latest

安装后验证

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

如果 openclaw dashboard 能正常打开，说明网关已可用。

常见问题

命令找不到

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

sharp 编译失败（macOS 常见）

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

端口冲突

lsof -i :18789
openclaw gateway --port 19000

网关无法启动

openclaw doctor
openclaw doctor --fix
openclaw logs --follow

下一步

继续阅读《基础配置》，完成模型、渠道和工作空间设置。