本文梳理了 Docker 部署 OpenClaw 时的典型环境与配置问题,涵盖 Web UI 访问、飞书机器人配对及接入公司自定义大模型节点的解决方案。
一、问题一:安装成功但 Web UI 无法访问
1. 现象描述
- 终端提示安装成功,但在浏览器中访问 http://127.0.0.1:18789 时,页面提示连接被重置。
- 使用具体的局域网 IP(如 192.168.5.30:18789)访问时,同样提示无法连接或无法访问此网站。

2. 原因分析
- 在排除了代理服务器和系统防火墙的干扰后,根本原因在于 OpenClaw 核心网关的跨域访问(CORS)安全机制。
- 系统默认包含白名单配置,它的作用是告诉 OpenClaw 的核心网关:'只有从这些特定的网址(域名或 IP)打开的控制台网页,才被允许连接我并下发控制指令'。
3. 解决方案
修改 OpenClaw 的配置文件 ~/.openclaw/openclaw.json,在 gateway.controlUi.allowedOrigins 节点中加上 * 作为通配符(或添加你实际访问的 URL)。具体配置参考如下:
{
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
"controlUi": {
"allowedOrigins": [
"*"
],
"dangerouslyDisableDeviceAuth": true
}
}
}





