本地服务器使用 OpenClaw 与 Open WebUI 构建企业级多部门 AI 平台

在 OpenClaw 源码目录下，执行以下长命令启动【研发部专属节点】：

sudo OPENCLAW_GATEWAY_PORT=18776 \
OPENCLAW_BRIDGE_PORT=18777 \
OPENCLAW_CONFIG_DIR=$HOME/openclaw-cluster/rd-dept \
OPENCLAW_WORKSPACE_DIR=$HOME/openclaw-cluster/rd-dept/workspace \
COMPOSE_PROJECT_NAME=openclaw-rd \
./docker-setup.sh

避坑指南：

• 交互引导中，遇到 Gateway bind 选项时，务必选择 LAN，否则后续 Open WebUI 无法跨容器连接。
• 如果需要再给【运营部】建一个节点，只需把上面命令中的端口（例如改为 18770/18771）、目录和 PROJECT_NAME 改掉，再运行一次即可，完美实现物理隔离！

第三步：修改网关配置，开启 OpenAI 兼容接口 (Chat Completions)

部署完节点后，默认情况下 OpenClaw 的网关服务可能并没有显式开启标准的 HTTP API 通道。为了让 Open WebUI 能够顺畅地与它对话，需要让 OpenClaw 充当一个'OpenAI 兼容服务器'。

需要手动修改各个部门节点下的配置文件（例如我们刚才为研发部创建的 ~/openclaw-cluster/rd-dept/config.json）。

使用文本编辑器（如 nano 或 vim）打开该配置文件，向下滚动找到 "gateway" 属性块。避坑细节： 在很多默认生成的配置中，gateway 下方是没有 http 这个属性的。需要手动把这块代码补进去，开启对话补全端点：

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

(保存并退出后，切记使用 sudo docker compose -p openclaw-rd restart 重启一下该节点的容器，让新配置生效。)

提取部门专属'钥匙' (Token)

配置改完后，要把该节点的 API Token 提取出来，这相当于 Open WebUI 敲开该部门大门的'通行证'。

第四步：在 Open WebUI 中接入网关并分配权限 (终极联调)

当把各个部门的 OpenClaw 节点都跑起来，并拿到对应的 API Token 后，就到了将它们统一接入前端面板的最后一步。

1. 进入外部连接设置 使用管理员账户登录 Open WebUI，点击右上角头像进入 管理员面板 (Admin Panel)，在左侧菜单选择 设置 (Settings)，然后点击 外部连接 (Connections)。

2. 添加并配置 OpenAI 接口 在'OpenAI 接口'模块，点击'添加连接'（或编辑现有连接），严格按照以下格式进行填写：

• URL (API 地址)：填入 http://host.docker.internal:你的端口号/v1
  • 避坑提醒： 这里的端口号必须是你刚才为该部门分配的 Gateway 端口（例如研发部是 18776）。切记，URL 结尾只需要到 /v1，绝对不要画蛇添足加上 /chat/completions！
• 认证方式 (密钥/Bearer)：将你在第三步中 gateway.json 里提取出的超长 Token 粘贴到这里。
• HTTP 标头 (可选但极度推荐)：填入 {"x-openclaw-agent-id": "main"}。这行代码的作用是精准唤醒 OpenClaw 中名为 "main" 的主智能体。

3. 测试并保存 填写完毕后，点击右下角的保存。如果配置无误，URL 右侧的刷新按钮旁会亮起一个绿色的开关标志，代表打通成功！

4. 部门级隔离与权限分发 (RBAC) 重复上述步骤，可以把【研发部】、【运营部】等多个节点的 API 全部添加进来。接着，进入 WebUI 的 工作区 (Workspace) -> 模型 (Models)，利用刚接入的不同 API 接口，创建对应的专署大模型。最后，通过系统自带的用户组（Groups）权限管理，设定'研发部模型仅研发员工账号可见'。

至此，一个数据物理隔离、权限精准管控、对话可查可溯源的企业级多部门 AI 平台，就在你的服务器上彻底落成了！