🦞 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 渠道配置指南

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🦞 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

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

🦞 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