1. 项目定位与用途
openclaw-wechat 是 OpenClaw 平台的微信通道插件，作为平台扩展运行。其核心用途是为 OpenClaw 提供微信作为可用的 AI 对话通道，允许用户将个人微信账号接入平台，实现消息的自动接收与回复，从而构建基于微信的聊天机器人或自动化助理系统。
项目档案插件 / 扩展
openclaw-wechat 插件安装使用指南 - 通过代理 API 实现 OpenClaw 稳定连接微信
本文详细介绍 openclaw-wechat 插件的功能、安装配置步骤与使用方式。该插件为 OpenClaw 平台提供微信通道，支持多账号、私聊群聊消息收发，需配置 API Key 与代理服务。包含常见问题解答与云部署注意事项。
AI 总结
OpenClaw 平台的微信通道插件，通过外部代理 API 实现微信账号的稳定连接与消息收发，支持多账号、私聊群聊及文本图片消息处理。
中文项目介绍
openclaw-wechat 是 OpenClaw 自动化平台的官方微信通道扩展，旨在将个人微信账号稳定接入 OpenClaw 生态系统。它解决了微信协议的非标准性、消息双向同步复杂性以及登录状态维持等集成难题，使开发者能基于微信构建 AI 助手或自动化客服。适用场景包括：AI 助手通过微信进行私聊或群聊交互、企业使用多账号部署自动化客服、以及在云服务器上部署需公网回调的微信机器人。技术层面，插件采用代理通信模式，依赖外部代理服务处理微信协议细节；内置 HTTP 回调服务器接收微信事件；所有连接参数通过 OpenClaw 配置系统集中管理；支持二维码扫码登录流程。
详细信息与使用说明
2. 解决的问题
该插件解决了三大集成问题：一是微信协议的非标准性，通过外部代理 API 抽象协议细节；二是消息双向同步，确保微信消息能可靠传入 OpenClaw 并可将平台回复发回微信；三是登录状态维持与多账号管理，提供二维码登录流程及多账号配置方案，保证服务稳定性。
3. 适用场景
主要适用于：AI 助手通过微信与用户进行私聊或群聊交互；企业或个人使用多个微信账号部署自动化客服或助理系统；在云服务器上部署微信机器人，需公网地址接收微信回调消息。不支持商业大规模群控或违反微信协议的使用。
4. 安装方式
通过 OpenClaw 命令行工具安装：执行 `openclaw plugins install @canghe/openclaw-wechat`。安装前需向客服购买 API Key。升级使用 `openclaw plugins update wechat`。插件以 NPM 包形式分发，依赖 OpenClaw 版本 >=2026.2.9。
5. 使用方式
配置必填项：通过 `openclaw config set` 设置 `channels.wechat.apiKey`、`channels.wechat.proxyUrl` 和 `channels.wechat.webhookHost`（云部署必填）。启用通道后，运行 `openclaw gateway start` 首次启动会显示二维码，微信扫码登录。支持多账号通过在 `channels.wechat.accounts` 下配置多个账户实现。收发私聊、群聊的文本与图片消息。
6. 补充说明与实现特点
插件依赖外部代理服务（由 proxyUrl 指定）处理微信协议，自身不直接连接微信服务器。云部署时必须配置公网可访问的 webhookHost 与端口（默认 18790）以接收回调。内置 callback-server 提供 HTTP 服务，proxy-client 负责与代理通信。配置遵循 OpenClaw 统一配置系统，支持设备类型选择（ipad/mac）。项目遵循 MIT 许可，但 API Key 需单独获取，仅供学习研究使用。
思维导图
openclaw-wechat
核心模块
channel.ts
bot.ts
reply-dispatcher.ts
通信层
proxy-client.ts
callback-server.ts
配置与运行时
config-schema.ts
runtime.ts
工具
utils/qrcode.ts
常见问题
如何安装 openclaw-wechat 插件？
使用 OpenClaw 命令行工具执行：openclaw plugins install @canghe/openclaw-wechat。需提前向客服购买 API Key。
配置插件需要哪些必填项？
必填三项：channels.wechat.apiKey（API Key）、channels.wechat.proxyUrl（代理服务地址）、channels.wechat.webhookHost（云部署时服务器公网 IP 或域名）。
机器人收不到消息怎么办？
请依次检查：确保 webhookHost 配置了服务器公网 IP；确保 webhookPort（默认 18790）可从外网访问；检查 gateway 是否运行（openclaw gateway status）。
如何实现多账号配置？
在 OpenClaw 配置文件的 channels.wechat 下使用 accounts 字段，为每个账号分别设置 apiKey 和 webhookHost 等参数，示例见 README 多账号章节。
插件是否免费？使用有何限制？
插件本身遵循 MIT 开源许可，但连接微信所需的 API Key 需向客服购买。项目声明仅供学习研究使用，请勿用于非法用途。