1. 项目定位与用途
openclaw-wechat-plugin 是 OpenClaw 框架的企业微信集成插件,用于在 OpenClaw 中接收、解密和发送企业微信消息。它作为 OpenClaw 的一个通道(channel),将企业微信纳入 OpenClaw 的消息处理生态,使开发者能够基于 OpenClaw 构建企业微信机器人或自动化系统。插件通过 OpenClaw 的扩展机制加载,依赖 fast-xml-parser 处理 XML 格式消息,实现与企业微信官方 API 的对接。
magicwang1111/openclaw-wechat-plugin:openclaw-wechat-plugin 是 OpenClaw 框架的企业微信集成插件,实现消息接收解密、多类型消息发送及文件附件支持,通过本页整理它解决什么问题、适用场景、安装方式和使用方法。
openclaw-wechat-plugin 是 OpenClaw 框架的企业微信集成插件,实现消息接收解密、多类型消息发送及文件附件支持,通过配置即可快速集成企业微信渠道。
openclaw-wechat-plugin 是 OpenClaw 框架的企业微信集成插件,用于在 OpenClaw 中接收、解密和发送企业微信消息。它作为 OpenClaw 的一个通道(channel),将企业微信纳入 OpenClaw 的消息处理生态,使开发者能够基于 OpenClaw 构建企业微信机器人或自动化系统。插件通过 OpenClaw 的扩展机制加载,依赖 fast-xml-parser 处理 XML 格式消息,实现与企业微信官方 API 的对接。
从当前仓库信息可见,该插件旨在为 OpenClaw 框架提供企业微信消息处理能力,但未明确阐述其解决的具体问题。从功能推断,它可能解决以下问题:在 OpenClaw 中集成企业微信作为消息来源和发送目标;处理企业微信消息的加解密以确保安全;支持多种消息格式的解析与生成;提供文件附件处理能力;支持多账号以管理多个企业微信应用。然而,仓库中未明确给出问题定义,以上为基于代码证据的合理推测。
仓库中未明确给出适用场景。但根据插件功能,可推断适用于以下场景:需要将企业微信作为消息渠道的 OpenClaw 应用,如客服机器人、群组管理助手、消息通知系统;需要接收并处理用户通过企业微信发送的文本、图片、语音等消息;需要向企业微信用户或群组发送消息,包括文本、文件等;需要管理多个企业微信应用账号的场景。由于 OpenClaw 框架通常用于构建 AI Agent 或自动化工作流,该插件可扩展这些系统到企业微信平台。
插件提供两种安装方式:一是通过 OpenClaw 命令行工具安装发布包,执行 `openclaw plugins install magicwang1111/openclaw-wechat-plugin`;二是从源码目录加载,具体取决于 OpenClaw 的插件加载机制,可将插件目录放置于 OpenClaw 的插件路径或通过配置指定。安装后需启用插件:`openclaw plugins enable openclaw-wechat-plugin`。注意:插件声明对 OpenClaw 框架的 peerDependency 版本为 ^2026.2.1,需确保 OpenClaw 环境满足要求。仓库中未明确给出其他安装细节,如依赖安装或构建步骤。
使用插件需完成以下配置步骤:首先,在企业微信管理后台创建应用并获取参数:CorpID(企业ID)、AgentId(应用ID)、Secret(应用密钥)、Token 和 EncodingAESKey(用于消息加解密)。然后通过 OpenClaw 配置命令设置参数:`openclaw config set channels.openclaw-wechat.corpid "xxx"`、`corpsecret`、`token`、`encodingAESKey` 并启用 `enabled true`。接着配置网关回调:设置网关模式为 local,绑定地址和端口(如 18789),并重启网关 `openclaw gateway restart`。最后在企业微信应用设置中配置回调 URL 为 `http://your-gateway-host:18789/openclaw-wechat/message`。验证可通过 `openclaw channels status` 查看通道状态。插件支持同步和异步模式,具体使用方式未在 README 中详细展开,但可通过 OpenClaw 的技能系统调用消息发送功能。
插件实现上,核心文件包括 src/channel.ts(通道实现)、src/client.ts(企业微信 API 客户端)、src/crypto.ts(加解密)、src/message-parser.ts(消息解析)、src/official-api.ts(官方 API 调用)等。依赖 fast-xml-parser 库解析企业微信 XML 消息。通过 OpenClaw 配置系统管理所有参数,支持环境变量或配置文件。消息接收流程:企业微信推送 XML 到网关回调,插件验证签名并解密消息,解析为结构化数据后传递给 OpenClaw 核心;消息发送流程:通过官方 API 发送,支持文本、图片、语音、视频、位置、链接及文件附件。插件还提供去重(dedupe)、S3 上传(s3-upload)等辅助功能,并包含技能示例(skills/wecom-helper)展示如何使用插件能力。注意:部分功能如 road2all-image 可能为特定技能,非核心插件功能。
可通过 `openclaw plugins install magicwang1111/openclaw-wechat-plugin` 安装发布包,或从源码目录加载(需符合 OpenClaw 插件加载方式,如将插件目录置于指定路径)。安装后需启用插件:`openclaw plugins enable openclaw-wechat-plugin`。
登录企业微信管理后台,进入应用管理:在应用详情页获取 AgentId(应用ID)和 Secret(点击查看Secret);在接收消息设置中点击随机获取 Token 和 EncodingAESKey;在企业信息中查看 CorpID(企业ID)。
使用命令 `openclaw channels status` 查看通道状态,确保 openclaw-wechat 通道显示为启用且无错误。也可向企业微信应用发送测试消息,观察 OpenClaw 是否正常接收和处理。
支持文本、图片、语音、视频、位置、链接等消息类型的接收与发送,同时支持文件附件上传。消息接收时自动解密,发送时可通过官方 API 调用。
支持多账号管理,可配置多个企业微信应用参数。但具体多账号配置方式未在 README 中详细说明,可能需要参考 OpenClaw 的多通道配置或插件扩展机制。