1 安装方法介绍
此前采用Node.js + GitHub方式安装,存在两大现实障碍:
- Windows环境下Node安装易出现依赖、权限及编译错误;
- GitHub源码下载受网络影响,常超时或失败。
这些问题源于环境链路过长,并非OpenClaw本身缺陷。
为此,我们构建了预配置的Docker镜像,实现开箱即用:
- 无需安装Node.js;
- 无需手动下载GitHub源码;
- 无需处理任何依赖配置。
仅需安装Docker,执行两条命令即可完成部署。
2 安装Docker
请前往Docker官网下载并安装Docker Desktop(Windows/macOS通用)。安装完成后启动Docker服务。
打开终端(Windows使用PowerShell,macOS使用Terminal),运行以下命令验证安装:
docker --version
若返回版本号,说明Docker已就绪:
3 两行命令安装并启动OpenClaw
执行以下命令拉取预构建镜像(首次下载约1–2分钟):
docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest
Mac运行效果:
Windows运行效果:
镜像下载完成后,启动OpenClaw服务:
macOS终端命令:
docker run -d -p 18789:18789 -v openclaw-data:/data \
sgccr.ccs.tencentyun.com/openclaw/openclaw:latest \
sh -c 'openclaw gateway run --bind lan --port 18789 --allow-unconfigured & sleep 3 && openclaw devices approve-all || true && wait'
Windows PowerShell/CMD命令:
docker run -d -p 18789:18789 -v openclaw-data:/data sgccr.ccs.tencentyun.com/openclaw/openclaw:latest sh -c "openclaw gateway run --bind lan --port 18789 --allow-unconfigured & sleep 3 && openclaw devices approve-all || true && wait"
执行无报错即表示启动成功。Mac与Windows运行效果分别如下:
打开浏览器访问:http://localhost:18789,即可进入OpenClaw Web界面,所有设备连接状态正常:
至此,OpenClaw已在本地成功部署,可立即投入自动化任务使用。
为什么Docker方案更可靠?
该方案将全部环境依赖前置封装进镜像,用户完全规避以下操作:
- 安装Node.js;
- 配置开发环境;
- 下载与编译源码;
- 解决兼容性与权限问题。
仅需安装Docker,再执行两条标准命令,即可完成全流程部署——这是目前最简捷、最稳定的OpenClaw本地安装方式。

