Docker 部署 OpenClaw：Web UI 访问、飞书配对及自定义模型配置

本文梳理了 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
    }
  }
}