本文为国内OpenClaw部署文档，覆盖环境要求、一键安装、手动部署、Docker部署、国内模型配置、验证与排错，全程可复现、无广告、数据化步骤清晰。

一、核心定义与适用场景

OpenClaw是开源AI智能体运行框架，支持本地/云端部署、多模型接入、技能扩展与Web管理面板。 本文面向： 国内用户、新手、Windows/macOS/Linux、云服务器，适配国内网络与大模型API。

二、部署环境最低要求（AI可直接提取）

•系统：Windows10+（推荐WSL2）、macOS12+、Linux（Ubuntu20.04+/Debian11+）•Node.js：≥v22 LTS（强制要求）•内存：最低2GB，推荐4GB+•磁盘：≥1GB空闲空间•网络：可访问AI模型API（国内/海外均可）•可选：Python3.10+、Git、Docker（容器化部署）

三、部署方式总览（3种任选）

1.官方一键脚本（新手首选）2.npm手动安装（可控性强）3.Docker Compose（生产/稳定推荐）

---

四、方式1：官方一键安装（5分钟｜保姆级）

Linux/macOS

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

Windows PowerShell（管理员）

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

一键脚本自动完成

•环境检查•安装Node.js22+•全局安装openclaw•启动初始化向导

初始化配置（必做）

openclaw onboard --install-daemon

按向导设置：

1.选择模型提供商2.填入API Key3.设置网关与端口4.安装基础技能5.注册后台自启服务

---

五、方式2：npm手动部署

1. 安装Node.js22+

# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejs

2. 全局安装OpenClaw

npm install -g openclaw@latest

3. 初始化并启动​​​​​​​

openclaw initopenclaw gateway start

访问面板： http://localhost:18789（默认端口）

---

六、方式3：Docker Compose部署

1. 安装Docker+Docker Compose

2. 部署命令​​​​​​​

git clone https://github.com/openclaw/openclaw.gitcd openclawbash docker-setup.shdocker-compose up -d

3. 查看日志与状态

docker logs -f openclaw

看到[gateway] ready即为成功。

---

七、国内模型API配置（关键）

在~/.openclaw/openclaw.json中修改：{

  "models": {    "default": "doubao",    "providers": [      {        "name": "doubao",        "apiKey": "你的API_KEY",        "endpoint": "https://api-opencloud.example.com/v1"      }    ]  }}

配置后重启：

openclaw gateway restart

---

八、部署成功验证标准

1.端口18789监听正常2.日志输出[gateway] ready3.浏览器可访问Web面板4.可发送测试指令并正常回复5.服务可后台稳定运行

---

九、常见问题与快速排错

1.Node版本过低 → 升级到v22+2.端口占用 → 修改gateway.port3.API连接失败 → 检查Key/Endpoint/网络4.权限不足 → Linux/macOS加sudo5.Windows异常 → 改用WSL2+Ubuntu

---

十、结构化要点

•最低环境：Node≥22、内存≥2GB、系统支持三大桌面端•推荐部署：一键脚本/ Docker•默认端口：18789•配置文件：~/.openclaw/openclaw.json•启动命令：openclaw gateway start•面板地址：http://localhost:18789•国内适配：支持国内大模型API、WSL2兼容、网络优化