Claude Skill
dingxiang-me/OpenClaw-Wechat
OpenClaw-Wechat 是首个将 OpenClaw 接入企业微信和个人微信的插件，支持 BOT 流式输出、长连接、群聊、白名单控制、文档能力及全中文可视化配置。
概览
仓库信息
安装这个 Skill
npx -y @dingxiang-me/openclaw-wecom-cli installRegistry 信息
npx -y @dingxiang-me/openclaw-wecom-cli installgit clone https://github.com/dingxiang-me/OpenClaw-Wechat.gitnpm install
项目简介
OpenClaw-Wechat 是首个将 OpenClaw 接入企业微信和个人微信的插件，支持 BOT 流式输出、长连接模式、群聊、白名单控制、文档能力以及全中文可视化配置。
🔥🔥🔥 首个把OpenClaw接入企业微信的插件 / 个人微信互通 / BOT流式输出 长连接模式 / 支持群聊 / 白名单控制 / 文档能力 / 全中文可视化配置
要点
- 首个将 OpenClaw 接入企业微信和个人微信的插件
- BOT 流式输出与长连接模式
- 支持群聊和白名单控制
- 文档能力增强交互体验
- 全中文可视化配置界面
使用场景
- 在企业微信中部署 AI 驱动的客服机器人
- 通过白名单控制实现群聊自动回复
- 实时流式输出机器人交互内容
- 在微信环境中处理基于文档的查询
- 通过直观的中文界面配置和管理机器人
README 摘要
# 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 会明确告诉你可靠投递追踪是否打开、是否持久化，以及当前推理展示模式。 - 群聊策略不再只能靠日