AI Hub Icon
AIBit 发现开源项目
首页 / 实用开源项目

OpenClaw Docker CN-IM：部署一个中国即时通讯 AI 网关

February 07, 2026
类别: 实用开源项目
标签:
Open Source AI Gateway Docker OpenClaw Chinese IM

OpenClaw Docker CN-IM：部署一个中国即时通讯 AI 网关

如果您正在构建一个跨中国主流即时通讯服务（飞书、钉钉、QQ、企业微信）的 AI 助手——那么您需要一个强大、模块化的后台。OpenClaw‑Docker‑CN‑IM 正是满足这一需求：一键 Docker 镜像，内置 AI 网关、主流平台插件，开箱即用的 AI 编码助手。

为什么选择 OpenClaw‑CN‑IM？

  • 零配置，Docker 驱动：拉取镜像，执行 docker-compose up -d，即可几乎完成准备。
  • 一键全插件：飞书、钉钉、QQ、企业微信已预装并自动启用。
  • AI 优先：只需一行环境变量即可替换任何兼容 OpenAI/Claude 的模型。
  • 持久存储：配置与工作区保存在 Docker 卷中；重启不丢失数据。
  • 开源：GPL‑3.0 许可，欢迎社区贡献。

先决条件

  1. Docker 与 Docker‑Compose（v1+）。
  2. 合作 AI 提供商的 API 密钥（OpenAI、Gemini、Claude 等）。
  3. 可选：您计划使用的任何即时通讯平台的凭据。

分步安装

  1. 克隆仓库（您也可以直接使用 wget 下载 docker‑compose.yml）： 

    git clone https://github.com/justlovemaki/OpenClaw-Docker-CN-IM.git
cd OpenClaw-Docker-CN-IM

  2. 复制环境模板并为您的环境进行编辑： 

    cp .env.example .env
nano .env
    至少，设置您的 AI 模型： 
    MODEL_ID=gemini-3-flash-preview
BASE_URL=https://api.gemini.google/v1
API_KEY=sk-…
API_PROTOCOL=openai-completions
CONTEXT_WINDOW=1000000
MAX_TOKENS=8192

  3. 添加 IM 凭据（可选但建议，如果您想支持多平台）。例如，飞书： 

    FEISHU_APP_ID=your-app-id
FEISHU_APP_SECRET=your-app-secret
    钉钉、QQ、企业微信按需重复。

  4. 启动栈： 

    docker compose up -d
    第一次运行将从您的 .env 生成 ~/.openclaw/openclaw.json。

  5. 验证网关： 

    docker compose logs -f
    您应能看到 OpenClaw 启动并在网关端口监听（默认 18789）。打开浏览器访问 http://<your-host>:18789 以测试连通性。

配置 AI 客户端

OpenClaw 支持 OpenAI 与 Claude 协议。若您使用 Gemini，请选择 OpenAI 协议：

API_PROTOCOL=openai-completions
BASE_URL=https://api.gemini.google/v1

若使用 Claude：

API_PROTOCOL=anthropic-messages
BASE_URL=http://localhost:3000

API_KEY 字段仅转发给 AI 供应商；若想避免外部调用，亦可搭建本地 AIClient‑2‑API 服务。

持久化数据

Docker 卷公开两个关键文件夹：

  • /home/node/.openclaw – 配置与插件数据。
  • /home/node/.openclaw/workspace – OpenCode AI 及其他服务的工作区。

若需要全部重置，删除主机卷后重启： 

docker compose down -v

故障排除技巧

问题 可能原因 解决方案
docker-compose logs 显示 “permission denied” 卷权限不匹配 确保主机文件夹归容器内 node 用户所有，或使用 --user 标志
飞书未收到消息 IM 凭证缺失 OR 未订阅事件 仔细检查 FEISHU_APP_ID/SECRET 并在飞书应用后台启用 im.message.receive_v1
调用 AI API 时出现 401 错误 API_KEY 错误或缺少作用域 验证密钥；检查供应商是否支持所选模型
网关端口冲突 端口 18789/18790 已被占用 修改环境变量 OPENCLAW_GATEWAY_PORT / OPENCLAW_BRIDGE_PORT

超越基础

  • AIClient‑2‑API：运行本地 API 聚合器，避免将 AI 密钥暴露到互联网。
  • Playwright 集成：使用捆绑的 Playwright 工具自动化浏览器操作，添加更丰富的 AI 能力。
  • TTS：启用中文文本转语音，为语音准备的机器人。
  • 自定义插件：在 /plugins 下放置 Node‑JS 包并更新 openclaw.json，即可添加新频道。

结语

OpenClaw‑Docker‑CN‑IM 将复杂的多平台 AI 网关转变为一句 docker-compose 命令。无论您是将 AI 加入飞书工作区的业余爱好者，还是为小型企业部署跨平台助手的业务者，这套方案显著降低了上手门槛。

祝部署愉快——欢迎在 GitHub 仓库提交 PR 或 issue，助力社区成长！

原创文章: 查看原文

分享本文