dingxiang-me/OpenClaw-Wechat

Registry

Summary

OpenClaw-Wechat is the first plugin to integrate OpenClaw with WeCom (WeChat Work) and personal WeChat, enabling bot streaming output, long-connection mode, group chat support, whitelist control, document capabilities, and full Chinese visual configuration.

Key features

• First OpenClaw integration with WeCom and personal WeChat
• Bot streaming output with long-connection mode
• Group chat support and whitelist control
• Document capability for enhanced interactions
• Full Chinese visual configuration interface

Use cases

• Deploy AI-powered customer service bots in WeCom
• Automate group chat responses with whitelist control
• Stream real-time bot outputs for interactive sessions
• Manage document-based queries within WeChat environments
• Configure and manage bots via intuitive Chinese UI

README excerpt

# OpenClaw-Wechat 企业微信插件 [中文 README](./README.md) | [English README](./README.en.md) OpenClaw-Wechat 是一个面向 OpenClaw 的企业微信渠道插件，支持两种接入方式： - `Agent 模式`：企业微信自建应用（XML 回调，经典模式） - `Bot 模式`：企业微信智能机器人 API 模式（JSON 回调，原生 stream） - `Webhook 目标出站`：将消息主动投递到企业微信群 Webhook 或命名 Webhook 目标 适用于“个人微信扫码进入企业微信应用对话”、“企业内员工问答助手”、“多账户多业务线消息分流”等场景。 ## 目录 - [可靠投递更新（v2.2.0）](#可靠投递更新v220) - [功能概览](#功能概览) - [模式对比](#模式对比) - [5 分钟极速上手](#5-分钟极速上手) - [前置要求](#前置要求) - [安装与加载](#安装与加载) - [配置文件与路径职责](#配置文件与路径职责) - [快速开始](#快速开始) - [文档工具（WeCom Doc）](#文档工具wecom-doc) - [配置参考](#配置参考) - [消息能力矩阵](#消息能力矩阵) - [命令与会话策略](#命令与会话策略) - [环境变量速查](#环境变量速查) - [公网回调与 Gateway Auth](#公网回调与-gateway-auth) - [Webhook 与 Heartbeat 运维](#webhook-与-heartbeat-运维) - [与其他渠道并存建议](#与其他渠道并存建议) - [故障排查](#故障排查) - [开发与发布](#开发与发布) - [FAQ](#faq) - [版本与贡献](#版本与贡献) ## 可靠投递更新（v2.2.0） 这版重点不在接入元信息，而是把 WeCom 回复链路补成“可感知、可补发、可诊断”的可靠投递。 ### 这版新增了什么 | 项目 | 结果 | |---|---| | 可靠投递状态 | `/status` 新增 `24h 窗口 / 主动发送额度 / Pending Reply` 摘要 | | Pending Reply | 最终回复投递失败后自动入队，支持定时重试和下次入站补发 | | Pending Reply 持久化 | 可选落盘，gateway 重启后继续补发未送达的最终回复 | | 配额感知 | 统一区分 `窗口过期 / 额度不足 / 传输失败 / 目标无效` | | 推理展示策略 | `delivery.reasoning` 可控制 `<think>` 内容分离显示、合并到最终回复或隐藏 | | Selfcheck 摘要 | `wecom:selfcheck` / `wecom:agent:selfcheck` / `wecom:bot:selfcheck` 增加 `reliable-delivery` 摘要 | | 群策略诊断 | `/status` 与 selfcheck 会显示当前群规则来源、准入模式以及白名单是否生效 | | 最终回复格式 | `delivery.replyFormat` 支持 `auto / text / markdown`，会按链路选择纯文本或 markdown 能力 | | 媒体指令 | 模型最终回复支持 `MEDIA:` / `FILE:` 指令，自动回传图片/文件并隐藏指令行 | | Bot/Agent 收口 | Bot fallback 与 Agent 最终回复统一纳入可靠投递跟踪 | | 长连接日志降噪 | 正常的 connect / opened / subscribed 继续保持 `debug`，默认日志更安静 | ### 这版对接入有什么实际影响 - 现在能直接看出当前会话是否仍在 `24h` 回复窗口内，以及是否存在待补发的最终回复。 - Bot / Agent 不再只是超时兜底，而是会把失败结果分类并进入 Pending Reply 重试。 - selfcheck 会明确告诉你可靠投递追踪是否打开、是否持久化，以及当前推理展示模式。 - 群聊策略不再只能靠日

Topics