基于 OpenClaw 与 Open WebUI 的企业多部门 AI 平台搭建及 Docker 部署指南
近期尝试使用 OpenClaw 框架，发现其作为 AI 个人助理工具颇具价值。针对企业多部门专属 AI 服务器的需求，特别是需要私有化部署且未全面普及协作软件的场景，独立搭建内部 AI 门户成为刚需。
初期方案存在缺陷：
- 权限越界：自带 Web 端配置权限过高，暴露给普通员工不安全。
- 无法溯源：多终端共用界面，无法追溯对话发起者。
- 缺乏隔离：无法按部门分配 API 额度或限制访问特定节点。
最终确定架构：前端使用 Open WebUI 统一接管登录与权限，后端通过 API 挂载多个互不干扰的 OpenClaw 容器。
部署环境： Ubuntu 系统
核心工具： Docker, Docker Compose
第一步：搭建 Open WebUI 统一前端
拉起 Open WebUI 容器，作为企业 AI 平台的门面，负责账号注册、鉴权及对话展示。
具体安装步骤请参考官方文档：https://docs.openwebui.com/
搭建完成后，将获得支持多用户管理的 ChatGPT 风格界面。
第二步：初始化并部署 OpenClaw 多节点网关
从官方 GitHub 拉取源码，使用 docker-setup.sh 脚本初始化。执行前需优化以下细节：
细节 1：解决 Docker 构建时的网络超时
Docker 构建时常卡在 pnpm install 阶段。修改 Dockerfile，在 USER node 下方注入淘宝镜像源：
USER node
ENV COREPACK_NPM_REGISTRY=https://registry.npmmirror.com
ENV npm_config_registry=https://registry.npmmirror.com
RUN pnpm install --frozen-lockfile
同时，打开 docker-setup.sh，在 docker build \ 后加上 --network host \ 参数。
细节 2：物理机目录权限交接
为实现部门隔离，需将宿主机文件夹权限移交给容器内的 node 用户（UID 1000）：
# 假设先为研发部创建专属目录
mkdir -p ~/openclaw-cluster/rd-dept
sudo chown -R 1000:1000 ~/openclaw-cluster/rd-dept
细节 3：执行终极多节点部署指令
官方默认脚本易导致端口冲突。通过环境变量赋予独立标识。
启动【研发部专属节点】命令：
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
