项目档案插件 / 扩展

OpenClaw 微信通路插件：支持 QClaw/WorkBuddy 双模式登录，一键安装配置，让 AI 助手接入微信服务号

wechat-openclaw-channel 是 OpenClaw 平台的微信通道插件，支持 QClaw 与 WorkBuddy 双模式登录。本页提供完整安装指南、CLI 使用命令、配置说明及技术架构解析，帮助开发者在微信服务号中快速部署 AI 助手，实现实时消息通信与设备绑定流程。

636TypeScriptStar 于 2026年3月10日2026年9月18日更新

查看 GitHub 仓库

AI 总结

OpenClaw 微信通路插件，支持 QClaw 与 WorkBuddy 双模式登录，通过 WebSocket 实时通信与 HTTP webhook 回调，使 OpenClaw Agent 能无缝集成微信服务号，实现 AI 助手的企业级部署。

中文项目介绍

wechat-openclaw-channel 是 OpenClaw 平台的官方微信通道插件，旨在将 OpenClaw Agent 的 AI 能力通过微信生态触达终端用户。该项目解决了 OpenClaw 平台缺乏微信集成渠道的问题，创新性地同时支持 QClaw（微信平台 OAuth）和 WorkBuddy（CodeBuddy OAuth）两种主流企业微信登录方式，为开发者提供统一的接入体验。插件采用模块化架构，核心包含四大模块：认证模块（auth）处理双模式 OAuth 流程与设备绑定；WebSocket 通信模块（websocket）实现 QClaw WebSocket 和 WorkBuddy Centrifuge 客户端，保障实时消息双向传输；HTTP webhook 模块（http）处理微信服务号回调，包括签名验证、消息加解密与业务逻辑处理；公共模块（common）提供运行时管理、事件订阅与消息上下文构建。适用场景涵盖：在微信服务号中部署 AI 对话助手；企业通过 WorkBuddy 或 QClaw 平台管理微信客服机器人；需将 OpenClaw Agent 能力通过微信渠道触达用户的各类业务系统。技术特征上，插件基于 TypeScript 开发，通过 OpenClaw 扩展点动态加载，凭证集中存储于 ~/.openclaw/openclaw.json，并实现 AGP 协议到 OpenClaw 标准消息格式的适配层。

详细信息与使用说明

1. 项目定位与用途

wechat-openclaw-channel 是 OpenClaw 开源平台的微信通道专用插件，作为 OpenClaw 生态的官方扩展组件，其核心定位是为 OpenClaw Agent 提供完整的微信服务号集成能力。该插件使 OpenClaw Agent 能够通过微信渠道与用户进行实时对话交互，将 AI 助手能力延伸至微信生态。主要用途包括：支持企业通过微信服务号提供智能客服、实现基于微信的 AI 对话机器人、以及将 OpenClaw 的 Agent 工作流通过微信界面触达终端用户。插件已发布至 GitHub 仓库，可通过 OpenClaw CLI 直接安装使用。

2. 解决的问题

该插件主要解决 OpenClaw 平台在微信生态接入方面的核心痛点：首先，统一支持 QClaw 和 WorkBuddy 两种企业微信登录方案，避免开发者需为不同平台重复实现认证逻辑；其次，提供完整的微信消息处理管道，包括 webhook 接收、签名验证、消息解密、AGP 协议转换等复杂流程的封装；第三，实现设备绑定机制，确保微信用户与 OpenClaw Agent 的安全关联；最后，通过 WebSocket 长连接保障微信与 OpenClaw 之间的实时双向通信，满足对话机器人的低延迟需求。

3. 适用场景

本插件适用于以下典型场景：企业希望在微信服务号中集成 AI 客服助手，提供 7×24 小时智能问答；组织使用 WorkBuddy 或 QClaw 平台管理企业微信客服机器人，需将现有 OpenClaw Agent 能力迁移至微信渠道；开发者需要将基于 OpenClaw 构建的 Agent 工作流通过微信界面暴露给终端用户；以及任何需要将 OpenClaw 的 LLM 调用、工具执行等能力通过微信消息形式触达用户的业务系统。插件支持生产与测试环境，满足开发与上线全周期需求。

4. 安装方式

插件支持两种安装方式：标准 npm 安装通过 OpenClaw CLI 执行 `openclaw plugins install @henryxiaoyang/wechat-openclaw-channel`，插件将从 GitHub Packages 自动下载；本地开发安装可使用 `openclaw plugin add ./路径` 命令，指向仓库本地目录。安装依赖 OpenClaw 版本 >= 2026.1.26。插件发布包包含 dist/ 编译产物、openclaw.plugin.json 插件清单及 README.md 文档，确保 OpenClaw 能正确识别并加载插件扩展点。构建依赖 TypeScript 5.9.3 与 tsup 8.5.1。

5. 使用方式

使用流程分为三步：首先执行 `openclaw wechat login` 进行交互式登录，在 QClaw 与 WorkBuddy 模式间选择并完成 OAuth 授权，凭证将自动存储至 ~/.openclaw/openclaw.json 的 channels.wechat-openclaw-channel 节点；其次运行 `openclaw gateway restart` 重启网关使插件生效；最后首次使用需执行 `openclaw wechat bind` 获取设备绑定链接，在微信中打开完成绑定。绑定成功后，用户即可通过微信对话与 OpenClaw Agent 交互。插件提供 `openclaw wechat logout` 命令清除登录态，支持模式切换与环境配置（production/test）。

6. 实现特点

插件采用清晰的模块化设计：认证模块（auth/）封装 QClaw JPRX 网关 API 与 CodeBuddy OAuth 客户端，实现设备 GUID 生成、扫码登录流程与设备绑定；WebSocket 模块（websocket/）提供 QClaw WebSocket 客户端与 WorkBuddy Centrifuge 客户端，通过消息适配层将微信 AGP 协议转换为 OpenClaw 标准消息格式；HTTP 模块（http/）处理微信服务号 webhook，包含签名验证、消息加解密、上下文构建与回调服务；公共模块（common/）管理 OpenClaw 运行时单例与 Agent 事件订阅。技术栈使用 TypeScript 开发，依赖 ws、centrifuge、fast-xml-parser 等库，通过 tsup 构建为 ESM 模块。

思维导图

wechat-openclaw-channel

认证模块 (auth)

types.ts - 登录模式与凭证类型

qclaw-api.ts - QClaw OAuth 客户端

codebuddy-api.ts - WorkBuddy OAuth 客户端

wechat-login.ts - 扫码登录流程

device-bind.ts - 设备绑定

device-guid.ts - 设备 ID 生成

environments.ts - 环境配置

WebSocket 通信 (websocket)

websocket-client.ts - QClaw WebSocket 客户端

centrifuge-client.ts - WorkBuddy Centrifuge 客户端

message-handler.ts - 消息处理与 Agent 调用

message-adapter.ts - AGP ↔ OpenClaw 消息适配

types.ts - AGP 协议类型定义

HTTP webhook (http)

webhook.ts - 微信回调主入口

message-handler.ts - 同步与流式消息处理

crypto-utils.ts - 签名验证与加解密

message-context.ts - 上下文构建

callback-service.ts - 外部回调服务

公共模块 (common)

runtime.ts - OpenClaw 运行时单例

agent-events.ts - Agent 事件订阅

message-context.ts - 消息上下文

CLI 命令与配置

openclaw wechat login - 交互式登录

openclaw wechat bind - 设备绑定

openclaw wechat logout - 清除登录态

openclaw gateway restart - 重启网关

openclaw.plugin.json - 插件元数据

常见问题

插件支持哪些微信登录方式？

插件同时支持 QClaw（微信平台 OAuth）和 WorkBuddy（CodeBuddy OAuth）两种登录模式，通过 `openclaw wechat login` 命令交互式选择，凭证自动存储于配置文件。

如何安装和配置插件？

使用 `openclaw plugins install @henryxiaoyang/wechat-openclaw-channel` 安装，依赖 OpenClaw >= 2026.1.26。登录后凭证自动保存至 ~/.openclaw/openclaw.json，首次使用需运行 `openclaw wechat bind` 完成设备绑定。

插件是否支持生产环境？

支持，配置中包含 `environment` 字段可设置为 `production`（默认）或 `test`，两种模式均经过验证可用，生产环境建议使用正式账号与配置。

消息如何从微信传递到 OpenClaw Agent？

微信消息通过 webhook 接收，经签名验证和解密后，由消息处理器转换为 OpenClaw 标准格式，通过事件订阅机制调用 Agent 处理，结果再通过 WebSocket 或回调返回微信，支持同步与流式（SSE）响应。

是否支持流式响应（打字机效果）？

支持，HTTP 模块实现 `handleMessageStream()` 方法，可通过 Server-Sent Events 方式向微信返回流式消息，实现类似 ChatGPT 的打字机效果，提升用户体验。