[其他] OpenClaw：Docker 化部署全能 AI 机器人网关，支持多平台

你是否曾想过为团队或社群部署一个智能助手，却在主流即时通讯(IM)平台的适配与复杂部署流程前望而却步？一个开源项目或许能改变这一局面——OpenClaw-Docker-CN-IM。

这是一个开箱即用的 Docker 镜像，它预集成了飞书、钉钉、QQ机器人、企业微信等国内主流 IM 平台插件，让你能通过简单的环境变量配置，一键启动一个功能强大的 AI 机器人网关，轻松将前沿的 人工智能 模型能力接入日常工作流。

项目地址位于 github.com/justlovemaki/OpenClaw-Docker-CN-IM。

告别 Token 成本焦虑：最佳搭档 AIClient-2-API

在深入了解前，需要了解一个关键优化方案。OpenClaw 功能强大，但其依赖的大语言模型(LLM)会消耗大量 Token，可能带来高昂成本。

为此，项目作者推荐搭配另一个工具 AIClient-2-API (github.com/justlovemaki/AIClient-2-API) 使用。该项目能将各大 AI 客户端转换为标准 API 接口，可能实现近乎无限的 Token 调用，从而显著降低成本。OpenClaw 已原生支持 OpenAI 和 Claude 两种协议，可与 AIClient-2-API 无缝对接。

核心特性：一个全面的 AI 能力网关

OpenClaw-Docker-CN-IM 不止于简单的聊天转发，它是一个功能全面的 AI 能力网关，具备以下核心特性：

• 开箱即用：预装所有中国主流 IM 平台插件，无需手动安装调试。
• 灵活配置：通过环境变量即可配置各大平台凭证和 AI 模型参数。
• Docker 部署：一条命令启动服务，告别复杂环境配置。
• 数据持久化：支持配置文件和工作空间数据持久化，重启不丢失。
• OpenCode AI：内置强大的 AI 代码助手，支持智能代码生成、分析和执行。
• Playwright：预装浏览器自动化工具，机器人可执行网页操作、截图等复杂任务。
• 中文 TTS：支持中文语音合成(Text-to-Speech)，让机器人能“开口说话”。

支持平台一览

• IM 平台:
  • 飞书 (Feishu/Lark)
  • 钉钉 (DingTalk)
  • QQ 机器人 (QQ Bot)
  • 企业微信 (WeCom)
• 集成工具:
  • OpenCode AI - AI 代码助手
  • Playwright - 浏览器自动化
  • 中文 TTS - 语音合成

快速开始：三步部署你的 AI 机器人

部署过程简单，几分钟即可完成。

第一步：下载配置文件

首先，在服务器上准备好 docker-compose.yml 和环境变量模板文件。

wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/docker-compose.yml
wget https://raw.githubusercontent.com/justlovemaki/OpenClaw-Docker-CN-IM/main/.env.example

第二步：配置环境变量

复制模板文件并进行编辑。至少需要配置 AI 模型相关的参数。

# 复制环境变量模板
cp .env.example .env
# 编辑配置文件
nano .env

以下是一个最小化配置示例：

环境变量	说明	示例值
MODEL_ID	AI 模型名称	gpt-4
BASE_URL	AI 服务 API 地址	https://api.openai.com/v1
API_KEY	AI 服务 API 密钥	sk-xxx...

提示：IM 平台的配置是可选的。可以先启动服务，确保 AI 模型连接正常后，再逐一配置所需 IM 平台。

第三步：启动服务

一切就绪，启动容器。

docker-compose up -d

可使用 docker-compose logs -f 查看实时日志，确保服务正常运行。停止服务执行 docker-compose down。

详细配置指南

1. AI 模型配置

本项目同时支持 OpenAI 协议 和 Claude 协议，兼容性强。

模型推荐：项目作者推荐使用 gemini-3-flash-preview 模型。它拥有 100 万 Token 的超大上下文窗口、响应速度快且性价比高，是 OpenClaw 的理想后端。

基础配置参数：

参数	说明
MODEL_ID	模型名称
BASE_URL	AI 服务的基础 URL
API_KEY	AI 服务的 API 密钥
API_PROTOCOL	API 协议类型 (openai-completions 或 anthropic-messages)
CONTEXT_WINDOW	模型上下文窗口大小
MAX_TOKENS	模型最大输出 Tokens

配置示例 (OpenAI 协议 - 如 Gemini):
注意 BASE_URL 需要以 /v1 结尾。

MODEL_ID=gemini-3-flash-preview
BASE_URL=http://localhost:3000/v1
API_KEY=your-api-key
API_PROTOCOL=openai-completions
CONTEXT_WINDOW=1000000
MAX_TOKENS=8192

配置示例 (Claude 协议):
注意 BASE_URL 不需要 /v1 结尾。

MODEL_ID=claude-sonnet-4-5
BASE_URL=http://localhost:3000
API_KEY=your-api-key
API_PROTOCOL=anthropic-messages
CONTEXT_WINDOW=200000
MAX_TOKENS=8192

2. IM 平台配置

根据使用的平台，在 .env 文件中添加相应的环境变量即可。以下是各平台配置的关键点。

飞书配置

1. 在飞书开放平台 (open.feishu.cn) 创建自建应用并开启机器人能力。
2. 获取 App ID 和 App Secret。
3. 关键步骤：配置正确的权限和事件订阅。
   • 权限：确保添加了 im:message、contact:user.base:readonly 等核心权限。
   • 事件订阅：这是最容易出错的地方！ 务必在“事件与回调”页面，选择“使用长连接接收事件”，并添加 im.message.receive_v1 事件。机器人能发消息但收不到，大概率是此问题。
4. 在 .env 中配置：

   FEISHU_APP_ID=your-app-id
   FEISHU_APP_SECRET=your-app-secret

钉钉配置

1. 在钉钉开发者后台 (open-dev.dingtalk.com) 创建企业内部应用，并添加机器人能力。
2. 关键步骤：消息接收模式选择 Stream 模式。
3. 获取 Client ID (AppKey) 和 Client Secret (AppSecret)。
4. 在 .env 中配置：

   DINGTALK_CLIENT_ID=your-dingtalk-client-id
   DINGTALK_CLIENT_SECRET=your-dingtalk-client-secret

QQ 机器人配置

1. 访问 QQ 开放平台 (q.qq.com) 创建机器人应用。
2. 获取 AppID 和 AppSecret (ClientSecret)。
3. 将服务器公网 IP 添加到 IP 白名单中。
4. 在 .env 中配置：

   QQBOT_APP_ID=你的AppID
   QQBOT_CLIENT_SECRET=你的AppSecret

企业微信配置

1. 在企业微信管理后台，以 API 模式创建“智能机器人”应用。
2. 在应用的“接收消息”配置中，设置 Token 和 EncodingAESKey。
3. 关键步骤：设置“接收消息”URL 为公网可访问的服务地址。
4. 在 .env 中配置：

   WECOM_TOKEN=your-token
   WECOM_ENCODING_AES_KEY=your-aes-key

常见问题 (FAQ)

• Q: 修改了 .env 文件，但配置没有生效？
  A: 容器仅在初次启动且配置文件不存在时，才会根据环境变量生成新配置。如需强制刷新，请先删除旧的配置文件 rm ~/.openclaw/openclaw.json，然后重启容器 docker-compose restart。

• Q: 连接 AIClient-2-API 失败？
  A: 请检查：1. AIClient-2-API 服务是否正常运行。2. BASE_URL 是否正确（OpenAI 协议需要 /v1 后缀，Claude 协议不需要）。3. 尝试用 127.0.0.1 替代 localhost。

• Q: 启动时遇到 Permission denied 错误？
  A: 这是由于宿主机挂载目录的所有者(UID/GID)与容器内运行用户不一致导致的。最直接的解决方案是修改宿主机目录的所有权：

  # 假设容器内用户 UID/GID 为 1000:1000
  sudo chown -R 1000:1000 ~/.openclaw

总结

OpenClaw-Docker-CN-IM 是一个强大的项目，它极大地降低了在国内主流 IM 平台上部署和管理 AI 机器人的门槛。通过 Docker 化的方式，实现了真正的“一键部署”。结合 AIClient-2-API，更能让你在享受强大 AI 能力的同时，有效管理成本。

无论是开发者、运营人员还是技术爱好者，这个项目都值得尝试。访问 github.com/justlovemaki/OpenClaw-Docker-CN-IM 获取源码，或使用 Docker 镜像 hub.docker.com/r/justlikemaki/openclaw-docker-cn-im 快速体验。

参考资料

[1] OpenClaw-Docker-CN-IM：一键部署，轻松打造全能型 AI 机器人网关， 微信公众号：mp.weixin.qq.com/s/ZeJU4OXNArxM_XXY_Gl9wQ

版权声明：本文由 云栈社区 整理发布，版权归原作者所有。