故障排查

问题1：origin not allowed

错误提示：origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)

原因：访问的域名不在allowedOrigins白名单中

解决：

编辑 /root/.openclaw/openclaw.json
找到 gateway.controlUi.allowedOrigins 数组
添加你的域名（http和https都要添加）：

"allowedOrigins": [
  "https://xiachaoqing.com",
  "https://ai.xiachaoqing.com",
  "http://ai.xiachaoqing.com",
  "http://127.0.0.1:18789",
  "http://localhost:18789"
]

清除缓存并重启：

rm -f /root/.openclaw/agents/main/agent/models.json
systemctl restart openclaw-gateway

问题2：401 Missing Authentication header

原因：API Key配置错误或缺失

解决：

检查API Key是否正确：grep apiKey /root/.openclaw/openclaw.json
清除缓存：rm -f /root/.openclaw/agents/main/agent/models.json
重启Gateway：systemctl restart openclaw-gateway

问题3：Gateway无响应

原因：Gateway进程未运行

解决：

systemctl status openclaw-gateway
systemctl restart openclaw-gateway

问题4：无法访问Web UI

原因：Nginx配置错误或Gateway未启动

解决：

/www/server/nginx/sbin/nginx -t
ps aux | grep openclaw

问题5：内存不足（OOM）

原因：Swap空间不足

解决：检查并增加Swap：free -h

问题6：新浏览器提示配对

原因：设备未配对

解决：

openclaw devices list
openclaw devices approve REQUEST_ID

获取帮助

查看日志：journalctl -u openclaw-gateway -f
健康检查：openclaw doctor
官方文档：docs.openclaw.ai