OpenClaw搭建教程之docker
OpenClaw的Docker搭建教程
环境准备
首先需要确认系统环境是否满足运行条件。确保已安装Docker和Docker Compose，其中Docker版本建议不低于19.03，Docker Compose版本推荐使用1.25.0及以上。可以通过以下命令快速验证当前版本：
docker --version
docker-compose --version
拉取OpenClaw镜像
这里推荐使用深度汉化的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错误。
正常情况下需要自行配置SSL证书，这里提供一个临时开发环境的解决方案：
在本地电脑上执行：
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)错误时，这意味着控制面板连接网关时没有携带正确的网关令牌。
解决方法是在运行OpenClaw的终端中执行：
openclaw dashboard --no-open
终端会输出一个类似http://localhost:18789/?token=xxxxxx的完整URL，直接访问这个链接即可解决问题。
另一个常见错误是disconnected (1008): pairing required，这表示OpenClaw的设备配对机制被触发。这是一种安全功能，当新的浏览器、CLI或其他客户端首次连接网关时，会生成待批准的"配对请求"，在管理员批准前连接会被拒绝。
可以通过以下命令临时关闭这个安全机制：
openclaw config set gateway.controlUi.allowInsecureAuth true
连接QQ
首先需要进入openclaw的bash环境：
openclaw onboard
选择yes后，默认选择快速配置模式，接着会弹出自定义服务商界面。
此时需要找到对应服务商的API和密钥进行配置：
保持默认设置继续，出现模型选择界面时，在对应的服务商平台找到想要使用的模型，将模型名称复制过来并回车：
配置成功后会出现确认界面：
这表明基础配置已经完成，接下来进行QQ机器人的安装配置。
首先需要前往QQ开放平台申请相应的权限：
申请完成后，回到bash环境执行以下三条命令：
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
openclaw channels add --channel qqbot --token "你的TOKEN"
openclaw gateway restart
这里有个技术细节需要注意：第一步安装过程中可能出现失败情况。如果安装失败，需要找到数据挂载的位置，删除执行第一条命令时安装的文件。
建议先检查运行环境：
node --version
openclaw --version
确认Node.js版本是否大于22，以及openclaw命令是否正常。通常情况下镜像制作者都会注意这些依赖关系。
如果遇到网络问题，可以尝试切换镜像源：
npm config set registry https://registry.npmmirror.com
npm cache clean --force
这个操作往往能解决大部分安装问题。
配置完成后，打开QQ就会发现已经添加了QQ机器人助手：
但可能会遇到新的问题：当前配置的模型上下文窗口（4096 tokens）小于OpenClaw运行所需的最小值（16000 tokens）。
这时需要找到openclaw挂载位置下的对应JSON配置文件进行编辑：
修改配置文件后，重启openclaw服务即可生效：
