OpenClaw的Docker搭建教程

环境准备

确保系统已安装Docker和Docker Compose。Docker版本需不低于19.03，Docker Compose版本建议使用1.25.0及以上。可通过以下命令验证版本：

docker --version
docker-compose --version

拉取OpenClaw镜像

我在这里找的镜像：https://1ms.run/

OpenClaw (Clawdbot/Moltbot) 中文汉化版，CLI 和 Dashboard 均已深度汉化，每小时自动同步上游官方更新。

# 初始化配置
docker run --rm -v openclaw-data:/root/.openclaw   jerryan999/openclaw-zh:latest openclaw setup

# 设置网关本地模式
docker run --rm -v openclaw-data:/root/.openclaw   jerryan999/openclaw-zh:latest openclaw config set gateway.mode local

# 绑定到局域网 允许外部设备访问
docker run --rm -v openclaw-data:/root/.openclaw   jerryan999/openclaw-zh:latest openclaw config set gateway.bind lan

# 设置访问令牌（远程访问必须）
docker run --rm -v openclaw-data:/root/.openclaw   jerryan999/openclaw-zh:latest openclaw config set gateway.auth.token "zxszuiniu6666"

# 启动容器
docker run -d --name openclaw -p 18789:18789   -v openclaw-data:/root/.openclaw   --restart unless-stopped   jerryan999/openclaw-zh:latest   openclaw gateway run

如此就启动了，可以通过浏览器访问一下

http://localhost:18789/

注意这里只能在本地访问，可以看到OpenClaw的网关控制台，如果需要外部设备访问的话，需要带上域名+ssl证书

如果您使用 http://你的服务器IP:18789这种方式直接访问，浏览器会因安全限制而断开连接，可能提示 disconnected (1008): control ui requires HTTPS or localhost

正常证书什么的自己配置一下就ok，这里给一个没有证书情况的临时开发环境的使用

在自己本地电脑上

ssh -N -L 18789:loaclhost:18789 root@你的服务器IP

执行后，终端会进入等待状态，请勿关闭。

openclaw网关控制台显示 disconnected (1008): unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)

这个报错 disconnected (1008): unauthorized: gateway token missing意味着 控制面板 (Control UI) 连接网关时，没有携带正确的网关令牌 (Gateway Token)。

在运行 OpenClaw 的终端中执行以下命令：

openclaw dashboard --no-open

终端会输出一个类似 http://localhost:18789/?token=xxxxxx的完整 URL

直接进就解决了这个情况

disconnected (1008): pairing required

报错 disconnected (1008): pairing required表示 OpenClaw 的设备配对机制已被触发。

这是一种安全功能。当一个新的浏览器、CLI 或其他客户端首次连接网关时，会生成一个待批准的“配对请求”。在管理员批准前，连接会被拒绝并返回此错误。

openclaw config set gateway.controlUi.allowInsecureAuth true

连接QQ

首先要进入openclaw的bash

openclaw onboard

选择yes

然后默认选择快速配置

然后弹出自定义服务商

然后找到我们对应的服务商的api，和key

然后一直默认，出现下图，就在我们对应的服务商那边找到你想使用的模型，把模型名称拷贝过来回车

然后

出现上图就说明ok了

我们安装QQ先暂时跳过

首先去QQ开放平台申请

然后重新回到bash执行以下3条命令

openclaw plugins install @tencent-connect/openclaw-qqbot@latest

openclaw channels add --channel qqbot --token "你的TOKEN"

openclaw gateway restart

注意我在第一步的时候出现过安装失败的情况，安装失败需要找到数据挂载的位置，删除掉执行第一条命令安装的文件

node --version

openclaw --version

检查以下node是否大于22，以及openclaw命令是否正常，这里正常都没问题，制作镜像的人都会注意到这个，

npm config set registry https://registry.npmmirror.com

npm cache clean --force

切换镜像源，这个概率非常大，我就是在这里解决的

然后正常执行

打开自己的QQ就会发现有一个QQ机器人助手

又出现新的问题，这这意味着您当前配置的模型上下文窗口（4096 tokens）小于 OpenClaw 运行所需的最小值（16000 tokens）

所以找openclaw挂载的位置找到下面的json，编辑

修改之后重启你的openclaw就好