📖 项目介绍
OpenClaw China 是 OpenClaw（AI 网关）的国内 IM 扩展插件集合。OpenClaw 是一个强大的 AI 网关，可以将各种 AI 模型（如 Claude、GPT、DeepSeek 等）统一接入并对外提供服务。
而 OpenClaw China 解决了国内用户无法直接使用 Slack、Discord 等海外 IM 的问题，让你直接在钉钉、飞书、QQ、企业微信、普通微信等国内平台上与 AI 对话。
核心亮点：支持流式响应（像 ChatGPT 一样打字效果）、文件收发、语音识别、定时任务，是目前国内最完善的 AI 接入方案之一。
🔌 支持平台
🔔
钉钉
✅ 可用
🐧
QQ机器人
✅ 可用
💼
企业微信
✅ 可用
💼
企微自建
✅ 可用
📱
飞书
✅ 可用
💡 推荐新手从钉钉开始：无需材料，5 分钟内完成配置，是最容易上手的平台。
⚡ 功能支持一览
| 功能 | 钉钉 | 飞书 | 企微机器人 | 企微自建 | |
|---|---|---|---|---|---|
| 文本消息 | ✅ | ✅ | ✅ | ✅ | ✅ |
| Markdown | ✅ | ✅ | ✅ | ✅ | ✅ |
| 流式响应 | ✅ | - | ❌ | ✅ | ❌ |
| 图片/文件 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 语音消息 | ✅ | - | ✅ | ✅ | ✅ |
| 定时任务 | ✅ | ✅ | ✅ | ❌ | ✅ |
| 群聊 | ✅ | ✅ | ✅ | ✅ | ❌ |
| 私聊 | ✅ | ✅ | ✅ | ✅ | ✅ |
🛠️ 环境要求
✅ Node.js 18+
✅ OpenClaw 已安装
📦 npm / pnpm
🌐 公网可访问（企微/飞书回调需要）
⚠️ Windows 用户注意：OpenClaw 存在 Windows npm 安装兼容问题（spawn npm ENOENT），请使用方式二（源码安装）。
📦 安装方式一：npm 安装（推荐 Linux/Mac）
安装统一包（包含所有渠道）：
# 安装所有渠道插件 openclaw plugins install @openclaw-china/channels # 启动配置向导 openclaw china setup
或安装单个渠道（不要和统一包同时安装）：
# 仅安装钉钉 openclaw plugins install @openclaw-china/dingtalk # 仅安装QQ openclaw plugins install @openclaw-china/qqbot # 仅安装飞书 openclaw plugins install @openclaw-china/feishu-china # 仅安装企业微信自建应用 openclaw plugins install @openclaw-china/wecom-app
💻 安装方式二：源码安装（全平台通用/Windows 推荐）
1
克隆仓库并安装依赖
git clone https://github.com/BytePioneer-AI/openclaw-china.git cd openclaw-china pnpm install pnpm build
2
以链接模式安装
openclaw plugins install -l ./packages/channels
链接模式安装后，修改源码后无需重新安装，重启 Gateway 即可生效。
3
运行配置向导
openclaw china setup
交互式配置向导会引导你完成所有配置，无需手动编辑配置文件。
💡 更新源码时执行：
git pull origin main && pnpm install && pnpm build🔔 钉钉配置（新手推荐）
📖 推荐：无需企业认证，个人即可注册，5 分钟完成配置！
1
前往钉钉开发者平台创建应用
访问 open.dingtalk.com → 创建企业内部应用 → 开启机器人能力
2
配置插件
openclaw config set channels.dingtalk.enabled true openclaw config set channels.dingtalk.clientId dingxxxxxx openclaw config set channels.dingtalk.clientSecret your-app-secret openclaw config set channels.dingtalk.enableAICard false openclaw config set gateway.http.endpoints.chatCompletions.enabled true
3
启动网关
openclaw gateway --port 18789 --verbose
💼 企业微信自建应用配置（可接入普通微信）
💡 企微自建应用支持主动发送消息、支持接入普通微信用户，功能最强大！
openclaw config set channels.wecom-app.enabled true openclaw config set channels.wecom-app.webhookPath /wecom-app openclaw config set channels.wecom-app.token your-token openclaw config set channels.wecom-app.encodingAESKey your-43-char-key openclaw config set channels.wecom-app.corpId your-corp-id openclaw config set channels.wecom-app.corpSecret your-app-secret openclaw config set channels.wecom-app.agentId 1000002
可选：开启语音转文字（腾讯云 ASR）
openclaw config set channels.wecom-app.asr.enabled true openclaw config set channels.wecom-app.asr.appId your-tencent-app-id openclaw config set channels.wecom-app.asr.secretId your-secret-id openclaw config set channels.wecom-app.asr.secretKey your-secret-key
🔄 更新插件
# npm 安装方式更新 openclaw plugins update channels # 源码安装方式更新 git pull origin main pnpm install pnpm build
❓ 常见问题
Q: Windows 上 npm 安装报错 "spawn npm ENOENT"？
这是 OpenClaw 的已知 Windows 兼容性问题。请改用方式二（源码安装）。
Q: 企业微信回调校验失败？
检查 Token / EncodingAESKey 是否与后台一致，确保 encodingAESKey 为 43 位字符。同时检查 webhookPath 是否公网 HTTPS 可访问。
Q: 钉钉配置后消息没有回复？
确保开启了 HTTP 端点：openclaw config set gateway.http.endpoints.chatCompletions.enabled true，然后重启 Gateway。
Q: 如何让 AI 回复只回最终结果不要中间思考过程？
在配置中设置 replyFinalOnly: true 即可。
🔗 相关链接
🌐 GitHub: BytePioneer-AI/openclaw-china
📖 钉钉配置指南: doc/guides/dingtalk/configuration.md
📖 企微配置指南: doc/guides/wecom-app/configuration.md
💬 微信交流群: 见 GitHub README 扫码
💬 加入交流群
和志同道合的朋友一起交流学习
抖音扫码加入