🦞 OpenClaw China — China IM Channels

面向中国 IM 平台的 OpenClaw 扩展插件集合

快速开始 • 总体架构 • 功能支持 • 更新日志 • 演示 • 加入交流群

⭐ 如果这个项目对你有帮助，请给我们一个Star！⭐
您的支持是我们持续改进的动力

🤖 推荐：ClawMate — 为 OpenClaw 添加有温度的角色伴侣

平台	状态	配置复杂度	配置指南
钉钉	✅ 可用	简单	钉钉企业注册指南
QQ 机器人	✅ 可用	简单	QQ 渠道配置指南
企业微信（智能机器人）	✅ 可用	中等	企业微信智能机器人配置指南
企业微信（自建应用-可接入微信）	✅ 可用	中等+	企业微信自建应用配置指南
飞书	✅ 可用	中等+	-

功能支持

已修复，使用最新插件版本即可。

【已修复，此提醒暂时保留】注意：OpenClaw 3.1+ 版本中使用企业微信存在问题，插件端正在尝试修复(或者等待OpenClaw官方修复此问题)，请先使用 3.1 之前的OpenClaw版本。npm install -g openclaw@2026.2.26 具体原因：网关分发顺序变更导致插件 HTTP 在内置路由之后执行，在到达插件前被拦截。

更多功能在努力开发中~

【全网首发】钉钉、QQ、企微支持文件接受和发送
【全网首发】钉钉、QQ、飞书、企微支持定时任务

功能	钉钉	飞书	QQ	企业微信智能机器人	企业微信自建应用（可接入普通微信）
文本消息	✅	✅	✅	✅	✅
Markdown	✅	✅	✅	✅	✅
流式响应	✅	-	❌	✅	❌
图片/文件	✅	✅ （仅发送）	✅ （仅图片）	✅	✅ （出站任意类型；入站允许图片、音视频、定位、语音）
语音消息	✅	-	✅	✅	✅
私聊	✅	✅	✅	✅	✅
群聊	✅	✅	✅	✅	❌
@机器人检测	✅	✅	✅	❌	❌
多账户	🚧	🚧	✅	✅	✅
主动发送消息（定时任务）	✅	✅	✅	❌	✅（文本、图片、Markdown）
连接方式	Stream	WebSocket	-	HTTPS 回调	HTTPS 回调
Access Token 缓存	-	-	-	-	✅（2 小时有效期）

更新日志

点击展开更新日志

2026-03-03

Merge PR #101：qqbot 新增多账户能力，覆盖配置、连接管理与令牌缓存。
Merge PR #89：修复 replyFinalOnly=true 场景下 QQ 工具媒体投递，并支持语音转换。
Merge 分支 pr-105：修复 WeCom / WeCom App webhook 路由注册，并支持多个 webhook 路径。
发布脚本新增固定版本控制选项，并同步 README 中 WeCom 问题说明。

2026-03-02

Merge PR #96：修复发送文本消息时的账号检查逻辑。
Merge PR #95：修复 wecom-app 在多账户配置下的消息路由错误。
wecom 渠道增强 XML 解析能力，支持更多消息类型与 CDATA 处理。
优化 wecom-app 消息发送逻辑，提升发送稳定性。

2026-02-28

修复企业微信插件异常重启循环问题，提升整体运行稳定性。

2026-02-26

新增安装提示能力，降低首次安装和排障成本。
openclaw china setup 新增交互式配置向导，减少手动配置步骤。

2026-02-25

Merge PR #73：wecom-app 支持以视频播放器形式发送 MP4 视频（3c32173）。
Merge PR #65：钉钉日志补充 userId/groupId，便于定向投递排障（a293250）。

2026-02-15

优化企业微信智能机器人的文件发送能力，支持发送多种文件类型。

2026-02-14

企业微信支持接入腾讯云 ASR 服务，实现语音转文本。
企业微信自建应用支持在微信侧发送定位，OpenClaw 可读取定位对应的具体位置。
修复企业微信插件无法执行特殊命令的问题（如 /new）。
新增企业微信插件定时任务能力。

快速开始

1) 安装

其他保姆文档编写中，现在最容易配置的是钉钉，建议先尝试钉钉。

方式一：从 npm 安装

安装统一包（包含所有渠道）

openclaw plugins install @openclaw-china/channels
openclaw china setup

或者：安装单个渠道（不要和统一包同时安装）

openclaw plugins install @openclaw-china/dingtalk
openclaw china setup

openclaw plugins install @openclaw-china/feishu-china
openclaw china setup

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
openclaw china setup

更新插件

openclaw plugins update channels

方式二：从源码安装（全平台通用）

⚠️ Windows 用户注意：由于 OpenClaw 存在 Windows 兼容性问题（spawn npm ENOENT），npm 安装方式暂不可用，请使用方式二。

git 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

更新源码

git pull origin main
pnpm install
pnpm build

链接模式下构建后即生效，重启 Gateway 即可。

ℹ️ 如果你使用的是旧名称 clawbot，请使用 @openclaw-china/channels@0.1.12。

2) 配置渠道

推荐：优先使用「配置向导」openclaw china setup 完成配置。下面的 openclaw config set ... 为手动配置示例。

钉钉

📖 钉钉企业注册指南 — 无需材料，5 分钟内完成配置

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

可选高级配置

如果你需要更细粒度控制（例如私聊策略或白名单），可以在 ~/.openclaw/openclaw.json 中按需添加：

{
  "channels": {
    "dingtalk": {
      "dmPolicy": "open",          // open | pairing | allowlist
      "groupPolicy": "open",       // open | allowlist | disabled
      "allowFrom": [],
      "groupAllowFrom": []
    },
    "wecom-app": {
      "dmPolicy": "open",          // open | pairing | allowlist | disabled
      "allowFrom": []
    }
  }
}

企业微信（自建应用-可接入微信）

由@RainbowRain9 Cai Hongyu提供

📖 企业微信自建应用配置指南 — 支持主动发送消息

企业微信自建应用支持主动发送消息，需要额外配置 corpId、corpSecret、agentId：

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-encoding-aes-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

（可选）开启语音转文本（腾讯云 Flash 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-tencent-secret-id
openclaw config set channels.wecom-app.asr.secretKey your-tencent-secret-key

与智能机器人的区别

功能	智能机器人 (wecom)	自建应用 (wecom-app)
被动回复	✅	✅
主动发送消息	❌	✅
支持群聊	✅	❌（专注于私聊）
需要 corpSecret	❌	✅
需要 IP 白名单	❌	✅
配置复杂度	简单	中等

wecom-app 已实现功能清单（摘要）

入站：支持 JSON/XML 回调、验签与解密、长文本分片（2048 bytes）、stream 占位/刷新（5s 规则下缓冲）。
入站媒体：image/voice/file/mixed 自动落盘，消息体写入 saved: 稳定路径；按 keepDays 延迟清理。
- 设计动机：避免使用 /tmp 造成"收到后很快被清理"，确保 OCR/MCP/回发等二次处理有稳定路径可依赖。
语音识别：支持接入腾讯云 Flash ASR（录音文件识别极速版）将语音转写为文本。
出站：支持主动发送文本与媒体；支持 markdown→纯文本降级（stripMarkdown）。
路由与目标：支持多种 target 解析（wecom-app:user:.. / user:.. / 裸 id / @accountId），减少 Unknown target。
策略与多账号：支持 defaultAccount/accounts；dmPolicy/allowlist；inboundMedia(开关/dir/maxBytes/keepDays)。

更完整说明见：doc/guides/wecom-app/configuration.md

（可选）安装 wecom-app 专用 Skill

企业微信自建应用可配套使用 wecom-app-ops（target/replyTo/回发图片/录音/文件、OCR/MCP、排障、媒体保留策略）。

安装方式（推荐：Workspace 级）：

# 在你的项目目录（workspace）下
mkdir -p ./skills
cp -a ~/.openclaw/extensions/openclaw-china/extensions/wecom-app/skills/wecom-app-ops ./skills/

或安装方式（全局）：

mkdir -p ~/.openclaw/skills
cp -a ~/.openclaw/extensions/openclaw-china/extensions/wecom-app/skills/wecom-app-ops ~/.openclaw/skills/

说明：Workspace > 全局（~/.openclaw/skills）> 内置 skills。复制后无需重启网关。

QQ

📖 QQ 渠道配置指南

openclaw config set channels.qqbot.enabled true
openclaw config set channels.qqbot.appId your-app-id
openclaw config set channels.qqbot.clientSecret your-app-secret

（可选）开启语音转文本（腾讯云 Flash ASR）：

openclaw config set channels.qqbot.asr.enabled true
openclaw config set channels.qqbot.asr.appId your-tencent-app-id
openclaw config set channels.qqbot.asr.secretId your-tencent-secret-id
openclaw config set channels.qqbot.asr.secretKey your-tencent-secret-key

企业微信（智能机器人）

📖 企业微信智能机器人配置指南

企业微信智能机器人（API 模式）通过公网 HTTPS 回调接收消息，仅支持被动回复

openclaw config set channels.wecom.enabled true
openclaw config set channels.wecom.webhookPath /wecom
openclaw config set channels.wecom.token your-token
openclaw config set channels.wecom.encodingAESKey your-43-char-encoding-aes-key

注意事项

webhookPath 必须为公网 HTTPS 可访问路径（如 https://your.domain/wecom）
encodingAESKey 必须为 43 位字符
如遇回调校验失败，先确认 Token/EncodingAESKey 与后台一致

飞书

飞书应用需开启机器人能力，并使用「长连接接收消息」模式

openclaw:

openclaw config set channels.feishu-china.enabled true
openclaw config set channels.feishu-china.appId cli_xxxxxx
openclaw config set channels.feishu-china.appSecret your-app-secret
openclaw config set channels.feishu-china.sendMarkdownAsCard true

3) 调试模式启动

openclaw gateway --port 18789 --verbose

演示

以下为钉钉渠道效果示例：

ps: 此为最初版本的演示效果，当前已完美支持Markdown格式。

开发

点击展开开发指南

适合需要二次开发或调试的场景：

# 克隆仓库
git 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

示例配置（开发环境）

{
  "plugins": {
    "load": {
      "paths": ["/path/to/OpenClaw-china/packages/channels"]
    },
    "entries": {
      "channels": { "enabled": true }
    }
  },
  "channels": {
    "dingtalk": {
      "enabled": true,
      "clientId": "dingxxxxxx",
      "clientSecret": "your-app-secret"
    },
    "qqbot": {
      "enabled": true,
      "appId": "your-app-id",
      "clientSecret": "your-app-secret"
    },
    "feishu-china": {
      "enabled": true,
      "appId": "cli_xxxxxx",
      "appSecret": "your-app-secret"
    },
    "wecom": {
      "enabled": true,
      "webhookPath": "/wecom",
      "token": "your-token",
      "encodingAESKey": "your-43-char-encoding-aes-key"
    },
    "wecom-app": {
      "enabled": true,
      "webhookPath": "/wecom-app",
      "token": "your-token",
      "encodingAESKey": "your-43-char-encoding-aes-key",
      "corpId": "your-corp-id",
      "corpSecret": "your-app-secret",
      "agentId": 1000002
    }
  }
}

点击展开总体架构

总体架构

当前架构分为宿主、统一通道聚合、各渠道插件和 shared 基础能力层。

%%{init: {"markdownAutoWrap": false, "flowchart": {"htmlLabels": false, "wrappingWidth": 1200}}}%%
flowchart TD
    %% 1. 核心宿主层 (Pill Shape)
    HOST(["🦞 OpenClaw"]):::host

    %% 2. 调度中心 (Rounded Rectangle)
    subgraph Dispatcher [" 核心调度与分发中心 "]
        direction TB
        CH("📦 @openclaw-china/channels"):::aggregate
    end

    %% 3. 插件网格 (利用子图内部布局)
    subgraph PluginGrid [" 多渠道插件生态 (Plugins) "]
        direction LR
        DT("DingTalk"):::plugin
        FE("Feishu"):::plugin
        QQ("QQBot"):::plugin
        WC("WeCom"):::plugin
        WA("WeCom App"):::plugin
    end

    %% 4. 基础设施层 (Rounded Rectangle)
    subgraph SharedLayer [" 基础设施层 (Shared) "]
        direction TB
        SH("🛠️ @openclaw-china/shared"):::shared
    end

    %% --- 核心连接逻辑 ---
    HOST ==>|Bootstrapping| CH
    CH -.->|Dynamic Registration| DT
    CH -.->|Dynamic Registration| FE
    CH -.->|Dynamic Registration| QQ
    CH -.->|Dynamic Registration| WC
    CH -.->|Dynamic Registration| WA
    DT & FE & QQ & WC & WA ==>|Dependencies| SH

    %% --- 样式定义 ---
    classDef host fill:#ebf5ff,stroke:#2563eb,stroke-width:2px,color:#1e40af,font-weight:bold
    classDef aggregate fill:#f0fdf4,stroke:#16a34a,stroke-width:2px,color:#166534,font-weight:bold
    classDef plugin fill:#ffffff,stroke:#64748b,stroke-width:1.5px,color:#334155
    classDef shared fill:#f8fafc,stroke:#334155,stroke-width:2px,stroke-dasharray: 5 5,color:#0f172a,font-weight:bold
    style Dispatcher fill:#f8fafc,stroke:#e2e8f0,stroke-dasharray: 5 5,color:#64748b,rx:10,ry:10
    style PluginGrid fill:#fffcf9,stroke:#fed7aa,stroke-dasharray: 5 5,color:#9a3412,rx:10,ry:10
    style SharedLayer fill:#f8fafc,stroke:#e2e8f0,stroke-dasharray: 5 5,color:#64748b,rx:10,ry:10

加入交流群

对 OpenClaw 用法、插件感兴趣的可以扫码加入微信群交流。

安装问题可以加群询问
提PR时遇到开发问题加群询问
项目架构细节加群询问
插件BUG建议提交issue

欢迎同学们一起开发~

如果二维码过期，可以加下我微信备注说明来意：a28417416

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 285 Commits
.tmp		.tmp
doc		doc
extensions		extensions
packages		packages
scripts		scripts
test		test
.gitignore		.gitignore
.npmrc		.npmrc
AGENTS.md		AGENTS.md
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.base.json		tsconfig.base.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🦞 OpenClaw China — China IM Channels

功能支持

更新日志

2026-03-03

2026-03-02

2026-02-28

2026-02-26

2026-02-25

2026-02-15

2026-02-14

快速开始

1) 安装

方式一：从 npm 安装

更新插件

方式二：从源码安装（全平台通用）

更新源码

2) 配置渠道

3) 调试模式启动

演示

推荐项目

🤖 ClawMate - OpenClaw 角色伴侣插件

开发

总体架构

加入交流群

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

🦞 OpenClaw China — China IM Channels

功能支持

更新日志

2026-03-03

2026-03-02

2026-02-28

2026-02-26

2026-02-25

2026-02-15

2026-02-14

快速开始

1) 安装

方式一：从 npm 安装

更新插件

方式二：从源码安装（全平台通用）

更新源码

2) 配置渠道

3) 调试模式启动

演示

推荐项目

🤖 ClawMate - OpenClaw 角色伴侣插件

开发

总体架构

加入交流群

License

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages