本文档描述在 Linux 服务器上使用 Docker 容器部署 OpenClaw 时的常见问题及解决方法。
部署后初始化配置
1. 网关认证配置
首次访问 OpenClaw Dashboard 时，可能显示以下错误信息：
disconnected (1008): unauthorized: gateway token missing
(open a tokenized dashboard URL or paste token in Control UI settings)
解决方法：
1. 定位配置文件：
cat ~/.openclaw/config.json
2. 获取认证令牌，查找以下配置项：
{
"gateway": {
"auth": {
"token": "xxxx"
}
}
}
3. 使用带令牌的 URL 重新访问 Dashboard：
https://hostname?token=xxxx
2. 设备配对授权
完成网关认证后，Dashboard 可能显示以下警告：
disconnected (1008): pairing required
解决方法：
1. 进入 OpenClaw Gateway 容器：
docker exec -it openclaw-gateway /bin/bash
2. 查看待配对的设备请求：
ls -la ~/.openclaw/devices
cat ~/.openclaw/devices/pending.json
3. 批准设备配对请求：
node /app/dist/index.js devices approve <device-id>
3. 示例：
node /app/dist/index.js devices approve 28e16401-98f9-4d0a-bac9-xxxxx
4. 退出容器并刷新浏览器：
https://hostname
故障排查流程图
首次访问 Dashboard
│
▼
unauthorized token missing
│
├──> 从 config.json 获取 token
├──> 使用 token 参数访问 URL
│
▼
pairing required
│
├──> 进入容器检查 pending.json
├──> 执行 devices approve 命令
│
▼
配置完成