🦞 OpenClaw China — 中国 IM 渠道插件完整文档
面向中国 IM 平台的 OpenClaw 扩展插件集合
📋 项目概述
OpenClaw China 为 OpenClaw 提供面向中国常用通讯平台的渠道扩展，帮助你把 AI 助手接入以下平台：
- 钉钉 (DingTalk)
- 企业微信 (WeCom) - 自建应用/智能机器人/微信客服
- 微信客服 (WeCom KF)
- 微信公众号 (订阅号/服务号/测试号)
- QQ (QQBot)
- 飞书 (Feishu)
项目聚焦于：
- ✅ 稳定的消息收发
- ✅ 统一的插件接入面
- ✅ 尽量低门槛的配置流程
📊 项目状态
| 指标 | 数值 |
|---|---|
| Stars | 3.6k+ |
| Forks | 323+ |
| License | MIT |
| Issues | 16 |
| 最后更新 | 2026 年 3 月 23 日 |
项目链接: https://github.com/BytePioneer-AI/openclaw-china
🏢 谁在使用
目前已知有多家公司/团队在使用 OpenClaw China。
本项目开源且可免费使用。如果你的公司或团队也在使用，欢迎通过 Issue、PR、交流群或微信留下公司名称/Logo/使用场景。
🎯 功能支持
各渠道功能对比
| 渠道 | 消息类型 | 图片 | 文件 | 语音 | 视频 | 卡片消息 | Markdown |
|---|---|---|---|---|---|---|---|
| 钉钉 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 企业微信 (自建应用) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 企业微信 (微信客服) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 微信公众号 | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ | |
| 飞书 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
更多功能在努力开发中~
企业微信 3 个渠道 + 微信公众号怎么选
| 渠道类型 | 适用场景 | 外部用户 | 配置难度 |
|---|---|---|---|
| 企业微信 (自建应用) | 企业内部使用 | ❌ | ⭐⭐ |
| 企业微信 (微信客服) | 服务外部微信用户 | ✅ | ⭐⭐⭐ |
| 企业微信 (智能机器人) | 群聊机器人 | ❌ | ⭐ |
| 微信公众号 | 公众号粉丝互动 | ✅ | ⭐⭐⭐ |
🚀 快速开始
1) 安装
方式一：从 npm 安装
安装统一包（包含所有渠道）
bashopenclaw plugins install @openclaw-china/channels openclaw china setup
或者：安装单个渠道（不要和统一包同时安装）
bash# 钉钉 openclaw plugins install @openclaw-china/dingtalk openclaw china setup # 飞书 openclaw plugins install @openclaw-china/feishu-china openclaw china setup # QQ openclaw plugins install @openclaw-china/qqbot openclaw china setup # 企业微信 (自建应用) openclaw plugins install @openclaw-china/wecom-app openclaw china setup # 企业微信 (微信客服) openclaw plugins install @openclaw-china/wecom-kf openclaw china setup # 微信公众号 openclaw plugins install @openclaw-china/wechat-mp openclaw china setup # 企业微信 (智能机器人) openclaw plugins install @openclaw-china/wecom openclaw china setup
更新插件
bashopenclaw plugins update channels
方式二：从源码安装（全平台通用）
bashgit clone https://github.com/BytePioneer-AI/openclaw-china.git cd openclaw-china pnpm install pnpm build openclaw plugins install -l ./packages/channels openclaw china setup
更新源码
bashgit pull origin main pnpm install pnpm build
⚠️ 链接模式下构建后即生效，重启 Gateway 即可。
2) 配置渠道
安装完成后，运行 openclaw china setup 进入交互式配置向导，根据提示选择要配置的渠道：
- 钉钉 - 企业钉钉机器人
- 企业微信（自建应用 - 可接入微信） - 企业内部应用
- 企业微信（微信客服 - 外部微信用户） - 服务外部客户
- 微信公众号（订阅号/服务号/测试号） - 公众号互动
- QQ - QQ 机器人
- 企业微信（智能机器人） - 群聊机器人
- 飞书 - 飞书机器人
3) 调试模式启动
bashopenclaw gateway --port 18789 --verbose
📁 项目结构
openclaw-china/
├── doc/ # 文档目录
│ ├── design/ # 设计文档
│ ├── guides/ # 使用指南
│ ├── images/ # 图片资源
│ └── architecture.md # 架构说明
├── extensions/ # 扩展插件目录
│ ├── dingtalk/ # 钉钉插件
│ ├── feishu/ # 飞书插件
│ ├── qqbot/ # QQ 机器人插件
│ ├── wechat-mp/ # 微信公众号插件
│ ├── wecom-app/ # 企业微信自建应用插件
│ ├── wecom-kf/ # 企业微信客服插件
│ └── wecom/ # 企业微信智能机器人插件
├── packages/ # 核心包
│ ├── channels/ # 统一渠道包
│ └── shared/ # 共享工具库
├── scripts/ # 脚本工具
├── test/ # 测试文件
├── AGENTS.md # 代理配置
├── README.md # 项目说明
├── package.json # 项目配置
├── pnpm-lock.yaml # 依赖锁定
├── pnpm-workspace.yaml # 工作空间配置
└── tsconfig.base.json # TypeScript 配置
🔄 更新日志
最近更新 (2026 年 3 月)
- 2026-03-23: 更新 README.md
- 2026-03-22:
- 企业微信文档 MCP
- 合并主分支更新
- 2026-03-21:
- 微信公众号支持全量入站消息、ASR 语音识别与重试机制
- 企业微信修复空 WS 占位符
- 2026-03-20: 增加微信公众号 Markdown 渲染功能
- 2026-03-19:
- 钉钉传递 message-channel 和 session-key 头信息到 gateway
- 修复版本配置问题
- 优化企业微信客服设置向导
- 2026-03-18: 增强 QQBot 的 Markdown 处理能力
💡 演示效果
钉钉渠道示例
ps: 此为最初版本的演示效果，当前已完美支持 Markdown 格式。
钉钉机器人支持完整的 Markdown 渲染，包括：
- 标题、列表、代码块
- 表格、引用
- 链接、图片
🛠️ 开发指南
架构设计
OpenClaw China 采用统一的插件架构：
- extensions/ - 各渠道的具体实现
- packages/channels/ - 统一的渠道抽象层
- packages/shared/ - 共享工具函数
开发流程
- Fork 项目
- 创建分支
- 在
extensions/下开发新渠道或改进现有渠道 - 运行测试
- 提交 PR
开发资源
- 架构文档:
doc/architecture.md - 设计文档:
doc/design/ - 使用指南:
doc/guides/
💗 支持我们
这是一个公益项目，由开发者利用业余时间持续开发和维护。
如何支持
- 点亮 Star - 在项目右上角点击 Star
- 帮忙宣传 - 分享给需要的朋友
- 提交 PR - 参与代码贡献
- 反馈问题 - 提交 Issue 帮助改进
👥 加入交流群
对 OpenClaw 用法、插件感兴趣的可以扫码加入微信群交流：
- ✅ 安装问题可以加群询问
- ✅ 提 PR 时遇到开发问题加群询问
- ✅ 项目架构细节加群询问
微信群二维码:
- 如二维码过期，可添加微信：
a28417416（备注说明来意）
📈 Star 趋势
项目自发布以来持续增长，目前已获得 3.6k+ Stars。
📄 License
MIT License
本项目采用 MIT 开源许可证，可免费用于个人和商业项目。
🔗 相关链接
- GitHub 仓库: https://github.com/BytePioneer-AI/openclaw-china
- OpenClaw 官方文档: https://docs.openclaw.ai
- LINUX DO 讨论区: 项目在社区有活跃讨论
- Star History: https://star-history.com/#BytePioneer-AI/openclaw-china
📝 总结
OpenClaw China 是一个专注于中国本土 IM 平台的 OpenClaw 扩展项目，具有以下特点：
✅ 多渠道支持 - 覆盖钉钉、企业微信、微信、QQ、飞书等主流平台
✅ 开箱即用 - 简单的安装和配置流程
✅ 稳定可靠 - 持续更新维护，已有众多企业使用
✅ 开源免费 - MIT 许可证，可自由使用
✅ 社区活跃 - 有微信群和技术支持
如果你想把 AI 助手接入中国的通讯平台，OpenClaw China 是一个值得考虑的选择。
文档整理时间：2026 年 3 月 25 日
基于 GitHub 仓库内容整理
具体参考： https://github.com/BytePioneer-AI/openclaw-china
可以直接将文档丢给claude code自动接入，自己只需配置对应的key