🔧 INSTALL GUIDE

OpenClaw 安装教程

10 分钟搞定部署，支持 macOS / Windows / Linux / Docker。
下面选择你的安装方式，照着做就行。

选择你的安装方式

安装前准备

系统要求

系统	支持版本	推荐
Linux	Ubuntu 20.04+ / Debian 11+	Ubuntu 22.04 ⭐
macOS	macOS 12+	macOS 14+ ⭐
Windows	Win10 21H2+ / Win11	WSL2 + Ubuntu ⭐

必须安装的软件

软件	版本	说明
Node.js	≥ v22	nodejs.org 下载
Git	2.30+	代码管理

验证 Node.js 版本：

node --version
# 输出必须 ≥ v22

GitHub / npm / Telegram / 海外模型 API 经常超时？

如果国内镜像解决不了，先把海外 AI 工具的网络环境配好，再安装 OpenClaw 会省很多排错时间。

查看网络方案 →

💻 LOCAL INSTALL

方式一：本地安装（推荐）

1全局安装 OpenClaw

npm install -g openclaw@latest

国内网络慢？先切换镜像源：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

2运行安装向导

openclaw onboard --install-daemon

向导会引导你选择模型、输入 API Key、配置渠道。按提示操作即可，大约 3 分钟。

3启动 Gateway

openclaw gateway start

看到 🦞 Gateway started on port 18789 就成功了！

4发送第一条指令

请告诉我北京今天的天气，并给出穿衣建议。

收到 AI 回复 = 安装成功 🎉

5验证安装

openclaw status       # 查看运行状态
openclaw doctor       # 自动诊断问题

🐳 DOCKER

方式二：Docker 部署

适合有 Docker 经验的用户，隔离性更好，适合服务器部署。

1克隆仓库并启动

git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker-compose up -d

2必须挂载的目录

volumes:
  - ~/.openclaw:/root/.openclaw        # 配置与数据
  - ~/openclaw/workspace:/workspace    # 工作区

3端口映射

端口	用途
18789	Gateway WebSocket
3000	Web UI

Docker 资源要求

资源	最低	推荐
CPU	1 vCPU	2 vCPU+
RAM	2 GB	4 GB+
磁盘	5 GB	20 GB+

☁️ CLOUD

方式三：云厂商一键部署

云厂商	特点	适合
阿里云	稳定、文档完善	企业用户
腾讯云	活动多、价格低	个人用户
九章智算云	OpenClaw 官方合作	新手首选

💡 免部署方案：九章智算云在线产品，首月 45 元，不需要任何技术操作。

🔥 TROUBLESHOOTING

常见安装报错

❌ Node.js 版本太低：SyntaxError: Unexpected token '?'

OpenClaw 需要 Node.js ≥ 22。用 nvm 升级：

nvm install 22 && nvm use 22 && nvm alias default 22
node -v  # 应显示 v22.x.x

❌ 权限不足：EACCES permission denied

不要用 sudo，改用 nvm 管理 Node.js：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22
nvm use 22
npm install -g openclaw

❌ npm 安装超时（国内网络）

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

❌ Windows 直接安装报错

OpenClaw 不支持 Windows 原生环境，必须用 WSL2：

# PowerShell 管理员模式
wsl --install -d Ubuntu-22.04
# 进入 WSL 后按 Linux 步骤安装

❌ macOS M1/M2/M3 报错：sharp: Installation error

export SHARP_IGNORE_GLOBAL_LIBVIPS=1
npm install -g openclaw

❌ 端口被占用：EADDRINUSE

lsof -i :18789  # 查看谁占用了端口
# 或者换端口启动
openclaw gateway start --port 18790

❌ Docker 权限问题：EACCES

在 docker-compose.yml 里加 user: "1000:1000"，或用命名卷替代 bind mount。

更多问题排查 →

查看完整避坑指南

安装后常用命令

# ===== 安装 =====
npm install -g openclaw@latest          # 安装/更新
openclaw onboard --install-daemon       # 初始化向导

# ===== 网关管理 =====
openclaw gateway start                  # 启动网关
openclaw gateway restart                # 重启网关
openclaw status                         # 查看运行状态

# ===== 诊断 =====
openclaw doctor                         # 环境诊断
openclaw doctor --fix                   # 自动修复
openclaw logs                           # 查看日志

# ===== 更新 =====
openclaw update                         # 更新到最新版本

搞不定？¥99 帮你远程装好

🦞 一对一远程安装

✅ 远程帮你部署好 OpenClaw
✅ 确保能正常运行
✅ 赠送 3 个热门场景配置
✅ 搞不定全额退款

扫码加微信，备注「99部署」。二维码过期就添加 深夜开发者LND，发送报错截图即可。

安装完成？下一步

🦞 加入虾农大家庭

300+ OpenClaw 玩家在群里分享经验、互相帮忙