WecomTeam/wecom-openclaw-plugin

OpenClaw 的官方企业微信插件，由企业微信团队开发和维护。它将你的 OpenClaw Agent 无缝对接到企业微信工作流，集成文档、智能表格、日历能力。

WeCom OpenClaw 插件 – 快速概览

这是什么 – 一个官方渠道插件，使 OpenClaw AI 代理框架能够与 WeCom（腾讯的企业微信）通信。它提供了两种与 WeCom 用户通信的方式：

模式	连接方式	典型用途
Bot	WebSocket 长轮询或 HTTP Webhook（JSON）	快速、流式回复，设置简单。
Agent	HTTP Webhook 回调（XML，AES-256-CBC 加密）	企业级，API 驱动的消息通信。

该插件还附带一个 wecom-cli 命令行工具，将数十个 WeCom 业务 API（消息、邮件、文档、电子表格、日历、会议、文件存储、联系人等）作为“技能”暴露给 AI 调用。

主要特性（如 README 所述）

双模式运行 – Bot 和 Agent 可并行运行；系统优先使用 Bot 发送 outbound 消息，若 WebSocket 断开则自动降级至 Agent。
消息类型 – 支持纯文本、Markdown、图片、视频、语音、文件，以及混合“图文混排”消息。语音消息可自动转录。
主动消息推送 – Bot 可在无需用户触发的情况下，向特定用户、群组、部门或标签推送消息。
流式回复 – 在 LLM 思考期间，可发送占位符“思考中”消息（仅 Bot 模式支持）。
访问控制 – 支持细粒度的直接消息策略（配对、开放、白名单、禁用）和群聊策略，以及按账户的命令授权。
多账户支持 – 可在一个 OpenClaw 网关中运行多个 WeCom 账户，每个账户拥有独立的 Bot/Agent 配置。
动态代理 – 可选的按用户或按群组隔离的代理，实现会话隔离。
媒体处理 – 自动下载传入媒体，设置大小限制（图片/视频 10 MB，语音 2 MB），超出限制时自动降级为文件发送。
内置业务技能 – wecom-cli 提供以下命令：
- 消息、邮件、文档与电子表格的增删改查（CRUD）
- 智能表格与智能文档管理
- 待办事项、日历、会议安排、会议纪要与转录
- WeDrive 文件搜索/上传/下载
- 联系人查询
CLI 向导 – openclaw channels add 或 @wecom/wecom-openclaw-cli install 会引导你完成 Bot ID/Secret 的输入与配置。
健壮的网络连接 – 支持心跳检测、自动重连、防踢保护，以及可选的出口代理。

快速入门（来自 README）

前置条件 – OpenClaw ≥ 2026.3.28。

安装 – 一行命令：

npx -y @wecom/wecom-openclaw-cli install   # 如需强制安装可加 --force

配置 – 运行 openclaw channels add（交互式）或直接设置所需密钥，例如：

openclaw config set channels.wecom.botId <BOT_ID>
openclaw config set channels.wecom.secret <BOT_SECRET>
openclaw config set channels.wecom.enabled true
openclaw gateway restart

启用业务工具 – 将插件 ID 添加到 tools.alsoAllow 并重启网关。
选择模式 – 默认使用 WebSocket 的 Bot 模式；或通过配置 CorpID/Secret、AgentId、Token 和 EncodingAESKey，并在 WeCom 管理后台注册回调 URL 来启用 Agent 模式。

哪些人可能使用它？

企业：已运行基于 OpenClaw 的 AI 助手，希望其出现在 WeCom 聊天中。
开发者：构建内部机器人，需要发送主动通知、处理富媒体内容，或调用 WeCom 的文档、日历和会议 API。
运维团队：希望通过 Agent 通道以定时（cron）方式向部门或标签广播消息。

限制与注意事项（根据文档）

Bot 模式需要 Bot ID 和 Secret；Agent 模式需要完整的公司应用（CorpID/Secret）和 XML 加密回调。
超出限制的媒体将作为文件发送或被拒绝。
使用仅 Agent 账户时，必须在 WeCom 控制台保存回调 URL 之前先配置好 Agent（WeCom 会立即验证 URL）。
插件版本必须与 OpenClaw 版本匹配（例如 OpenClaw 2026.3.22 → 插件 2026.3.20；更新的 OpenClaw → 插件 2026.3.24+）。

总结

WeCom OpenClaw 插件 是一个生产就绪的桥梁，使 OpenClaw AI 代理能够与腾讯的企业微信通信，支持富媒体、主动消息和通过便捷 CLI 暴露的全套 WeCom 业务 API。它可在 Bot（WebSocket）或 Agent（加密 XML Webhook）模式下运行，支持多账户，包含访问策略和模式间自动降级等安全特性。