\n\n
\n 打破信息孤岛，用一套系统驱动企业增长
\n 加速企业用户向全场景人工智能机器人转变\n
| 🏫 教学机构 | 逸寻智库 |
| 👨🏫 讲师 | Job |
| 📧 联系方式 | support@huo15.com |
| 💬 QQ群 | 1093992108 |
| 📺 配套视频 | B站视频：https://space.bilibili.com/400418085 |
\n ![\"npm\"](\"https://img.shields.io/npm/v/@huo15/wechat-service?style=flat-square&logo=npm&color=blue\")
![\"ClawHub\"](\"https://img.shields.io/badge/ClawHub-published-orange?style=flat-square\"){kind=icon}
![\"OpenClaw\"](\"https://img.shields.io/badge/OpenClaw-2026.3.23%2B-green?style=flat-square\"){kind=icon}
![\"License\"](\"https://img.shields.io/badge/License-MIT-blue?style=flat-square\"){kind=icon}
![\"Stable\"](\"https://img.shields.io/badge/Status-v2.3.x%20Stable-success?style=flat-square\"){kind=icon}
\n\n## 📖 正文内容\n\n> **OpenClaw 微信服务号（公众号）渠道插件**：把微信公众号变成你的 AI 协作入口。\n> 一粉一会话隔离 · 12 个 agent tool · 覆盖 60+ 个微信公众平台官方 API · 多账号矩阵路由 · 知识库双写\n\n```\n@huo15/wechat-service v2.3.3\n└─ 12 个 agent tool / 60+ 个 WeChat MP API / 架构按 @huo15/wecom 同构\n```\n\n### ✨ 能力总览\n\n| 维度 | 说明 |\n|------|------|\n| **🚀 一粉一会话**（v2.3.0+ 默认开启） | 动态 Agent 派生：每个 openid 自动一个独立 agent + 独立 session / 记忆；管理员名单可旁路 |\n| **📨 消息全栈** | 客服消息（10 类）/ 模板消息（CRUD + 公模板库）/ 一次性 + **长期订阅通知** |\n| **📰 内容发布** | 素材管理 + 草稿箱 + `freepublish` 流水线 + 群发（按标签/openid，预览，撤回） |\n| **🔐 网页授权** | OAuth2.0 全流程（snsapi_base / snsapi_userinfo） + JS-SDK 签名 |\n| **📊 数据分析** | datacube 17 项指标（用户增减、图文阅读分享、消息分析、接口调用） |\n| **🤖 智能开放** | OCR 7 类（身份证/银行卡/驾驶证/行驶证/营业执照/车牌/通用） + 图像处理 3 项 |\n| **🎫 卡券精简** | create / get / batchget / delete / consume / decrypt encrypt_code |\n| **🧠 多账号矩阵** | `accounts.
\n\n**公司名称：** 青岛火一五信息科技有限公司\n**联系邮箱：** postmaster@huo15.com | **QQ群：** 1093992108\n\n
\n\n
\n 关注逸寻智库公众号，获取更多资讯\n
\n\n\n\n## 📄 License\n\nMIT © 青岛火一五信息科技有限公司（jobzhao / zhaobod1@163.com）\n\n详见 [`LICENSE`](./LICENSE)。\n\nFile v2.3.5:_meta.json\n\n{\n \"ownerId\": \"kn7byevkn40d6z4p7ghdb097z983tj33\",\n \"slug\": \"huo15-openclaw-wechat-service\",\n \"version\": \"2.3.5\",\n \"publishedAt\": 1778603601213\n}\n\nFile v2.3.5:CHANGELOG.md\n\n# Changelog\n\n## 2.3.5 — 2026-05-13（hotfix：errcode 45002 — 字节 vs 字符截断）\n\n### 触发\n\n用户截图反馈：升级 v2.3.x 之后粉丝在公众号发消息**只收到 placeholder「收到，正在为你处理...」**，**收不到 LLM 真回复**（agent 第二条消息丢失）。\n\n### 根因诊断\n\nGateway log 出现关键错误：\n\n```\n[wechat-service] customer_service_send failed accountId=default:\n API cgi-bin/message/custom/send failed:\n errcode=45002 errmsg=content size out of limit\n```\n\n**errcode 45002 是「消息内容超长」**——微信公众号客服消息 `cgi-bin/message/custom/send` 的 `text.content` 字段限制是 **UTF-8 字节 2048**，**不是字符 2048**。\n\n我在 v2.3.0 写的渲染器：\n\n```ts\ntruncateForWechatText(rendered, 2000) // ← 按字符截 2000\n```\n\n中文 1 字在 UTF-8 占 **3 字节**：2000 中文字 = 6000 字节，远超 2048 字节限制。LLM 用 `huo15-customer` persona + KB 答得稍微详细一点（≥ 700 中文字），整段被微信拒绝下发。\n\nplaceholder 是另一条独立的被动回复 XML，不走这条路径，所以粉丝先收到 placeholder 后**第二条客服消息静默丢失**——这是最难诊断的失败模式。\n\n### 改动\n\n#### 1) `truncateForWechatText` 改字节截断 — `src/shared/markdown-to-wechat.ts`\n\n```ts\n// v2.3.5+ 改成按 UTF-8 字节截断\nexport function truncateForWechatText(text: string, maxBytes = 1900): string {\n const encoder = new TextEncoder();\n const bytes = encoder.encode(text);\n if (bytes.length <= maxBytes) return text;\n\n // 二分找最大 char index 使 utf-8 bytes <= maxBytes - 3\n let lo = 0, hi = text.length;\n while (lo < hi) {\n const mid = (lo + hi + 1) >>> 1;\n if (encoder.encode(text.slice(0, mid)).length <= maxBytes - 3) lo = mid;\n else hi = mid - 1;\n }\n let cut = lo;\n\n // 不截在 标签内部（避免 XML 错乱）\n const prefix = text.slice(0, cut);\n const lastOpen = prefix.lastIndexOf(\"<\");\n const lastClose = prefix.lastIndexOf(\">\");\n if (lastOpen > lastClose) cut = lastOpen;\n\n return text.slice(0, cut) + \"…\";\n}\n```\n\n默认值 **1900 字节**（留 148 字节余量给 envelope 开销 / `` 标签）。实际可用区间：\n- 纯中文：≤ 600 汉字\n- 纯英文：≤ 1900 字符\n- 中英混合：取中间\n- emoji（4 字节）也正确处理\n\n#### 2) `dispatcher.ts` + `customer-service.ts` 去掉硬编码 `2000`\n\n两处调用都不再传 maxChars，让函数走默认 1900 字节。\n\n#### 3) 测试\n\n新增 6 个用例覆盖：\n- 纯英文按字节截断\n- 纯中文按字节截断\n- emoji（4 字节 UTF-8）正确处理\n- 默认 maxBytes=1900：600 汉字（1800 字节）原样返回\n- 默认 maxBytes=1900：700 汉字（2100 字节）会被截\n- `` 标签不被截在内部（开闭标签数对齐）\n\n**287/287 全绿**（v2.3.4 的 282 + 5 个新增）。\n\n### 兼容性\n\n- 零 API breaking：`truncateForWechatText(text)` 直接调（不传 maxBytes 用新默认 1900 字节）\n- 老调用 `truncateForWechatText(text, 2000)` 参数语义变了（之前是字符数，现在是字节数）—— **重要变化**，但只有 plugin 内部调用，外部用户不会传这个参数\n- LLM 输出超过 600 中文字现在能正常下发（之前直接被微信拒）\n\n### 升级（强烈建议）\n\nv2.3.0 ~ v2.3.4 都有这个 bug。升级路径：\n\n```bash\nopenclaw plugins install @huo15/wechat-service@2.3.5\nopenclaw gateway restart\n```\n\n升级后验证：\n- 给公众号发个消息触发 LLM 答详细一点（≥ 600 中文字的回答）\n- 看 gateway log：`grep \"customer_service_send\\|errcode=45002\" /tmp/openclaw/openclaw-$(date +%F).log`\n- 不再出现 `errcode=45002` 即成功\n\n### 教训\n\n微信 / 企微 / 飞书等 IM 平台的消息长度限制**几乎都是字节不是字符**：\n\n| 平台 | 限制 | 备注 |\n|------|------|------|\n| 微信公众号客服 text | 2048 字节 | `errcode 45002` |\n| 微信公众号被动回复 XML | 2048 字节 | |\n| 企业微信 markdown_v2 | 4096 字节 | |\n| 企微 text | 2048 字节 | |\n| 飞书 text | 2048 字节 | |\n\n中文 1 字 = UTF-8 3 字节是基础常识但容易在写代码时遗忘——尤其是 JavaScript 的 `string.length` 是 UTF-16 code units 数，跟 UTF-8 字节数无关。已沉淀 memory `feedback_wechat_text_byte_limit_not_char.md`。\n\n## 2.3.4 — 2026-05-12（huo15-customer persona 增强 + B 站 111 视频 KB）\n\n### 触发\n\n用户要求把 B 站官方账号（UID 400418085，「逸寻智库AI」）的视频抓进 KB。WebFetch / B 站 wbi API 都被风控；改用 **yt-dlp** 绕过——成功抓到 **111 个完整视频元数据**（标题 / 发布时间 / 时长 / 播放量 / 描述 / tags）。\n\n### 改动\n\n#### 1) 新增共享 KB：`~/.openclaw/kb/shared/wiki/huo15-B站视频清单.md`\n\n按主题分 6 类 + 最新发布前 20 + 最热门前 15 + 客服推荐话术模板 + 维护说明（yt-dlp 命令）：\n\n| 主题 | 视频数 |\n|------|------|\n| 🤖 AI / 具身智能 / OpenClaw / 大模型 | 11 |\n| 🏢 Odoo / ERP / 企业管理（**最强项**） | 36 |\n| 📱 移动开发 / uniapp / Android / 鸿蒙 | ~15 |\n| 👁️ 视觉 AI / OCR / 质检 | ~5 |\n| 🥽 XR / 数字孪生 / UE5 / Unity | ~3 |\n| ⛓️ Web3 / 区块链 / 溯源 | ~2 |\n| 🛠️ DevOps / Linux / 部署 / 工具 | ~10 |\n| 🎬 其他 / 影视杂谈 | ~29 |\n\n热门 Top 3：\n1. `2025年最新odoo18 企业版/社区版部署与安装` — 6801 播放\n2. `Odoo19开发：用源代码方式部署odoo19[Win11操作系统]` — 1687 播放\n3. `odoo18利用deepseek和chatGPT修改合同模板` — 1250 播放\n\n#### 2) `huo15-customer` persona instructions 增强 — `src/shared/personas/it-support.ts`\n\n知识库引用从 6 份扩到 **7 份**，**每份附一句话定位**便于 agent 知道何时查哪份。\n\n新增**防幻觉**指令：\n\n> 「推荐具体视频（粉丝问\"某主题怎么学\" / \"有视频吗\"）一定查 huo15-B站视频清单.md 拿真实 BV 号，**不要瞎编 BV**。」\n\nBV 号是 8-12 位字母数字混合（如 `BV1XaRtBiE8z`），LLM 容易幻觉。把\"不要编\"明确写进 prompt 比抽象描述有效得多（沉淀 memory `feedback_tool_description_vs_prompt_level_constraint.md`）。\n\n#### 3) 更新 `huo15-逸寻智库课程库.md` 共享 KB\n\n「配套视频频道」段从\"提一句 B 站链接\"扩成\"主题覆盖 + 热门 Top 3 + 引流话术 + 指向 huo15-B站视频清单.md\"完整对接。\n\n### 兼容性\n\n零 breaking。纯 persona prompt + KB 内容增强。\n\n### 测试\n\n282/282 全过（无新增测试用例，仅 prompt 文本扩展）。\n\n### 升级\n\n```bash\nopenclaw plugins install @huo15/wechat-service@2.3.4\nopenclaw gateway restart\n# KB 已自动同步到 ~/.openclaw/kb/shared/wiki/，OpenClaw 启动后自动重新索引\n```\n\n### 维护脚本（每月跑一次更新 B 站清单）\n\n```bash\nyt-dlp --flat-playlist -J --no-warnings \\\n 'https://space.bilibili.com/400418085' > /tmp/bili_list.json\n# 提取 BV 号 → 批量拉单视频 metadata（节流防风控） → 重新生成 huo15-B站视频清单.md\n```\n\n完整脚本见 KB 文件末尾「维护说明」段。\n\n## 2.3.3 — 2026-05-12（关键词通配 glob 匹配 + README 大扩 + ignore 重组）\n\n### 触发\n\n用户：\"综合这些目的，帮我配置关注自动回复、自动关键词触发的一些回复。还有这里的也抓：https://space.bilibili.com/400418085 帮我维护好 readme, ignore\"\n\n发现两个产品问题：\n1. **关键词匹配过死**：v2.2.0 ~ v2.3.2 仅支持完全匹配（`content === keyword`），\"Odoo 怎么学\" 不会命中 \"Odoo\"。运营要列举每个变体，工作量大且漏覆盖。\n2. **README 没跟上 v2.3.x**：菜单短路 / markdown 降级 / persona preset / 共享 KB / 关注欢迎语 + 关键词 全没提到，新用户装上不知道怎么用。\n\n### 改动\n\n#### 1) matchKeyword 支持 glob 通配 — `src/auto-reply.ts`\n\n新规则：\n\n| keyword 配置 | 匹配模式 | 命中示例 |\n|------|------|------|\n| `\"你好\"` | exact 完全匹配（旧版语义） | \"你好\" ✓；\"你好吗\" ✗ |\n| `\"*Odoo*\"` | contains 包含（**大小写不敏感**） | \"Odoo 怎么学\"、\"ODOO\" 都 ✓ |\n| `\"价格*\"` | prefix 前缀 | \"价格多少\" ✓；\"问下价格\" ✗ |\n| `\"*多少钱\"` | suffix 后缀 | \"Odoo 实施多少钱\" ✓ |\n\n匹配优先级（向后兼容）：\n1. 先按 keys 顺序扫所有 **exact** 关键词\n2. 都未命中，再按 keys 顺序扫 **通配** 关键词\n3. 第一个命中即返回\n\n这样运营可以「精确短句走快回复 + 通配模糊兜底」共存：\n\n```yaml\nkeywords:\n \"价格\": \"固定问候\" # 用户发\"价格\"两个字走这里\n \"*价格*\": \"通用引导兜底\" # 用户发\"我想问下价格多少\"走这里\n```\n\n测试：`src/auto-reply.test.ts` 新增 5 个通配匹配用例。\n\n#### 2) README.md 大幅扩 — 5 个新章节 + 1 个完整章节重写\n\n- **能力总览表新增 4 行**：内置 persona preset / 菜单事件短路 / Markdown 自动降级 / 自动回复（含 v2.3.3 通配）\n- **配置 Schema 块** 加 `defaultInstructionsPreset` + `autoReply` 字段示例\n- **新章节「🔁 自动回复实战」**：welcomeText / keywords（含 v2.3.3 glob 通配完整说明 + 43 组 huo15 实战示例）/ businessHours / 执行顺序流图\n- **新章节「🤖 内置 Persona Preset + 共享 KB」**：preset 切换 + 6 份共享 KB md 引用路径 + 自定义 instructions SOP\n- **最小可用配置** 补 `autoReply` + `dynamicAgents.defaultInstructionsPreset`\n- **演进路线** 补 v2.2.0 ~ v2.3.3 全部条目\n- **License 段** 改 MIT（v2.2.x 已改）\n\n#### 3) .gitignore / .npmignore 重组\n\n- `.gitignore`：补齐凭据 / pem / bak / tgz / .npm / vitest cache / IDE swp 等漏项，结构化分组（依赖/构建/测试/打包/日志/IDE/系统/凭据/备份/本地）\n- `.npmignore`：明确\"package.json.files 是白名单优先级最高\"的注释，补 .git/ / .cnb.cool/ / *.pem / credentials.json 等防误打包\n\n验证：`npm pack --dry-run` → 303 KB / 317 文件，无 .test.ts / .env / coverage / .github 等垃圾。\n\n### 兼容性\n\n- ✅ 完全向后兼容\n- ✅ 老用户的 `keywords: {\"帮助\": \"...\"}` 继续完全匹配\n- ⚠️ 如果有 keyword 字面量本身包含 `*`，旧版会失败匹配（因为 v2.3.3 把 `*` 当通配符）。极小概率边界，若实际踩到可用 `\\\\*` 转义未来扩展，但目前无人反馈\n\n### 测试\n\n282/282 全绿（277 + 5 条新增通配用例）。\n\n### 升级\n\n```bash\nopenclaw plugins install @huo15/wechat-service@2.3.3\nopenclaw gateway restart\n\n# 配置示例（OpenClaw 配置编辑器或直接 ~/.openclaw/openclaw.json）：\n# channels[\"wechat-service\"].autoReply = {\n# \"welcomeText\": \"...\",\n# \"keywords\": { \"你好\": \"...\", \"*Odoo*\": \"...\", \"价格*\": \"...\" },\n# \"businessHours\": { \"timezone\": \"Asia/Shanghai\", \"schedule\": [...] }\n# }\n```\n\n## 2.3.2 — 2026-05-12（新增 huo15-customer persona preset + 6 份共享 KB md）\n\n### 触发\n\n用户要求：「帮我配置下服务号聊天这块，单独隔离一个 agent。做客服。帮我在这个 agent 里面做个知识库。主要内容：https://chatai.huo15.com/slides，涉及领域就是公司的 6 个产品 4 个服务（www.huo15.com）能够涉及的 IT 技术和工商管理相关的知识。目的是打造逸寻智库在线教育平台的智能客服。」\n\n### 改动\n\n#### 1) 新增 `huo15-customer` persona preset — `src/shared/personas/it-support.ts`\n\n继 v2.3.0 内置的通用 `it-support` 后，新增专属 preset：**火一五·逸寻智库公众号客服**。\n\n涵盖 system instructions：\n- 公司一句话定位 + Mission（10 年 / 100+ 客户 / AI-First）\n- **6 大产品**导流：辉火云企业套件 / 辉火云管家 / XR-IoT / 机器视觉 / 镜像世界 / 逸寻智库\n- **4 大服务**导流：Odoo 实施 / OpenClaw 增强 / 安全架构 / 高校 XR\n- IT 技术领域白名单（Odoo 10~19 全栈 / Python / AI 工程 / 鸿蒙 / Web3 / XR）\n- 工商管理领域白名单（ERP 各模块 / 中国本地化 / 数字化转型 / 合规）\n- 黑名单（涉政 / 黑灰产 / 医法金具体决策 / 实时新闻）\n- **留资转化 4 步路径**：理解需求 → 匹配产品 → 给资源 → 留联系方式\n- 课程库引用：https://chatai.huo15.com/slides\n- 联系方式：18554898815 / postmaster@huo15.com\n\n启用方式（用户配置）：\n\n```yaml\nchannels:\n wechat-service:\n dynamicAgents:\n enabled: true\n defaultInstructionsPreset: \"huo15-customer\" # ← 切到逸寻智库客服\n```\n\n#### 2) 配套共享知识库 — `~/.openclaw/kb/shared/wiki/huo15-*.md`（6 份）\n\n跟随 v2.3.2 发布同时落盘到本机 OpenClaw 共享 KB，所有动态客服 agent 通过 `corpus=\"kb\"` 检索：\n\n| 文件 | 内容 |\n|------|------|\n| `huo15-公司概览.md` | 公司基本信息 / Mission / 客户画像 / JOSS 活动 |\n| `huo15-6大产品.md` | 6 大产品定位 / 适合谁 / 友商差异 / 推荐路径表 |\n| `huo15-4大服务.md` | 4 大服务交付内容 / 周期 / 价格沟通流程 |\n| `huo15-IT技术知识范畴.md` | IT 领域白名单（Odoo / Python / 前端 / AI / DevOps / XR / Web3 / 视觉 AI） |\n| `huo15-工商管理知识范畴.md` | 工商管理领域白名单 + 不答清单 + 自然链接产品技巧 |\n| `huo15-逸寻智库课程库.md` | 5 门课程详细信息 + 学习路径推荐 + 客服回答模板 |\n\n#### 3) 配置示例（运营同学复制即用）\n\n```yaml\n# ~/.openclaw/config.json 或 OpenClaw config 编辑器中配\nchannels:\n wechat-service:\n enabled: true\n accounts:\n default:\n appId: wx...\n appSecret: ${WECHAT_SERVICE_APP_SECRET}\n token: ${WECHAT_SERVICE_TOKEN}\n encodingAESKey: ${WECHAT_SERVICE_AES_KEY}\n encryptMode: safe\n name: \"逸寻智库\"\n replyMode: async\n replyPlaceholderText: \"收到，正在为你处理...\"\n dynamicAgents:\n enabled: true # 一粉一会话独立 session\n dmCreateAgent: true\n defaultInstructionsPreset: \"huo15-customer\" # ← 逸寻智库客服 persona\n adminUsers: [] # 配上你的 openid 可绕过动态路由\n```\n\n### 兼容性\n\n- 完全向后兼容\n- 老用户继续用 `it-support` preset 不变\n- 想切到逸寻智库客服 → 改一行 `defaultInstructionsPreset = \"huo15-customer\"` + 重启 gateway / 重装 plugin\n\n### 测试\n\n277/277 全绿（preset 注册表加 1 项，原有测试全过）。\n\n### 升级 + 启用步骤\n\n```bash\n# 1. 升级 plugin\nopenclaw plugins install @huo15/wechat-service@2.3.2\n\n# 2. 重启 gateway 让新 persona 生效\nopenclaw gateway restart\n\n# 3. 配置切到 huo15-customer preset（OpenClaw 配置编辑器或直接改 config.json）\n# channels[\"wechat-service\"].dynamicAgents.defaultInstructionsPreset = \"huo15-customer\"\n\n# 4. 共享 KB 已落盘到 ~/.openclaw/kb/shared/wiki/huo15-*.md，OpenClaw 启动后自动索引\n# 验证：openclaw kb-ingest --scope shared 或 memory_search \"火一五 6 大产品\"\n```\n\n## 2.3.1 — 2026-05-11（hotfix：markdown 渲染下沉到 sendCustomerServiceMessage 底层 + 表格/br/幂等）\n\n### 触发\n\nv2.3.0 升级后用户反馈：\"回复中还是有 markdown 语法，没有解析成排版。\"\n\n根因排查：v2.3.0 只在 `dispatcher.ts:dispatchInboundEvent` 一处接了 markdown 渲染（LLM agent 回复路径）。**绕过 dispatcher 的 4 条 outbound 路径仍发原始 text**：\n\n| 路径 | 谁会发 |\n|------|--------|\n| `handler.ts:subscribe 欢迎语` | 配置的 `autoReply.welcomeText` |\n| `handler.ts:autoReply 关键词回复` | 配置的 `autoReply.keywords[*]` |\n| `outbound.ts:sendOutboundText` | 插件主动消息接口（运营广播 / 业务通知）|\n| `tools/message-tool.ts` | agent 通过 message tool 主动发的 text |\n\n只要这些路径上有 markdown（用户配的、LLM 通过 tool 调的），粉丝就看到 `**` `#` 等字符。\n\n### 改动\n\n#### 1) 渲染下沉到 sendCustomerServiceMessage 内部 — `src/api/customer-service.ts`\n\n新增 `renderTextMessage()` 内部辅助：所有 `msgtype === \"text\"` 的客服消息在发往 `cgi-bin/message/custom/send` 之前，content 都会被强制过一遍 `renderMarkdownForWechatText` + `truncateForWechatText(2000)`。\n\n这是**最后一道闸**：\n\n- dispatcher.ts 仍然提前过一次（早转早好，避免后续传 envelope 时携带 markdown 字符）\n- 渲染器对纯文本是**幂等**的：`render(render(x)) === render(x)`\n- 双层渲染**不会出 bug**：第二次跑时 markdown 标记已被去除，正则不再命中\n\n#### 2) 渲染器增强 — `src/shared/markdown-to-wechat.ts`\n\n新增支持：\n\n- **`
` / `
` 换行**：LLM 偶尔会输出 HTML 换行\n- **GFM 表格降级**：\n\n ```\n | 列1 | 列2 |\n |---|---|\n | A | B |\n ```\n\n → 分隔行 `|---|---|` 整行删掉；数据行 `| a | b |` → `a ｜ b`（全角分隔保留可读性，公众号 text 没法渲染网格）\n\n- **幂等保护**：测试新增 2 用例验证 `render(render(x)) === render(x)`、a 标签不会被二次解析\n\n### 兼容性\n\n- 零 breaking change\n- 已经升 v2.3.0 的用户**强烈建议**升 v2.3.1（v2.3.0 只盖了 dispatcher 一条路径，运营配的 welcome / keyword 仍会漏渲染）\n\n### 测试\n\n277/277 全绿（v2.3.0 273 + 4 条新增：`
` / 表格 / 幂等 / a 标签二次解析）。\n\n### 升级生效\n\n```bash\n# OpenClaw 内升级\nopenclaw plugins install @huo15/wechat-service@2.3.1\n\n# 或重启 gateway 让新 plugin manifest 加载\nopenclaw gateway restart\n```\n\n## 2.3.0 — 2026-05-11（菜单事件不回复 + markdown 自动降级 + 默认 IT 学习客服 persona）\n\n### 触发\n\n用户三个诉求：\n1. 用户**点击底部菜单不要回复**——之前每次菜单 CLICK/VIEW 都被当成\"用户问题\"丢给 LLM\n2. 回复**自动解析 markdown 排版**——LLM 输出 `**bold**` `# 标题` `- list` 粉丝看到一堆原符号\n3. 现在的插件**是不是动态 agent**？想默认配好 IT 客服 persona 四件套\n\n### 改动\n\n#### 1) 菜单事件 short-circuit — `src/transport/webhook/handler.ts`\n\n`runAgentDispatch` 被调用前，对 `inbound.msgType === \"event\"` 的消息做\"路由检查\"：\n\n- 当且仅当 `routing.events.
` + slogan 段（\"打破信息孤岛...\"）+ 5 行信息表（教学机构/讲师/邮箱/QQ群/B 站）+ badges |\n| 中间 | `## 📖 正文内容` 大标题 + 全部技术内容（20 节）|\n| 结尾 | `
` + 公司全称 + 邮箱 + QQ群 + `
` + \"关注逸寻智库公众号\" + `
` + License |\n\n### 改动\n\n- **顶部**：从 v2.1.2 的 npm/openclaw badges 居前，重排成 slogan 段 + 信息表（5 行）+ badges\n- **底部**：原 \"🏢 维护方\" 段重写为模板要求的\"公司名称 + 联系邮箱 + QQ群\"两行 + \"关注逸寻智库公众号\"提示\n- **正文**：所有 20 节技术内容（能力总览 / 安装 / 配置 / bindings / replyMode / 48h / 工具 / 路线图 / 权限 / 路由 / 知识库 / 加密 / 后台 6 件事 / 故障排查 / 完整配置 / 脚本 / 资源）100% 保留，仅在前面套了一个 `## 📖 正文内容` 总标题\n\n### 文件统计\n\n- README 从 544 → **568 行**（+24 行，纯模板要素）\n- 段落从 20 → **21**（多了\"正文内容\"总标题）\n\n### 兼容性\n\n- 纯文档变更，无代码 / schema / 测试改动\n- npm + cnb + clawhub 同步发 v2.1.3，让所有渠道展示模板化的 README\n\n---\n\n## 2.1.2 — 2026-04-29 `[DOCS]`\n\n> 大幅扩展 README 配置说明，把生产部署一路踩过的坑全部沉淀成 SOP。**无代码改动**。\n\n### 新增 4 节运维文档\n\n1. **🔗 顶层 `bindings`（必须配！）** —— 把 channel→agent 反向路由说清楚。不配会导致\"agent 跑完了但回复消息被静默丢弃\"（这是最常踩的坑）。给出多账号 / 多渠道场景的完整配法\n2. **📨 回复模式详解** —— `replyMode: async` vs `passive` 行为对比，`replyPlaceholderText` 配法，event 类回调为啥不发占位符，何时该用哪个\n3. **⏰ 客服消息「48 小时窗口」硬性约束** —— 解释 `errcode 45015` 来源、超 48h 怎么办（模板 / 订阅消息）\n4. **📡 公众号后台必做的 6 件事** —— URL / Token / EncodingAESKey / 加密模式 / **IP 白名单** / 接口权限。带 `curl ifconfig.me` 取出口 IP 教程\n5. **🧰 故障排查表** —— 11 条常见错误码对照 + 日志 grep 模板 + \"期待的成功链路\"日志参考\n6. **🚦 完整最小可用配置（一键复制）** —— 包含 agents.list + bindings + channels.wechat-service + plugins.entries 的合规配置范例，直接覆盖 `~/.openclaw/openclaw.json` 就能跑\n\n### 章节统计\n\n- README 从 320 行扩到 **544 行**（+70%）\n- 段落数从 14 增到 **20**\n\n### 兼容性\n\n- 纯文档变更，无代码 / schema / 测试改动\n- npm + cnb + clawhub 同步发 v2.1.2，让 ClawHub 上的安装页也展示新 README\n\n---\n\n## 2.1.1 — 2026-04-29 `[UX]`\n\n> **修复粉丝消息无反应感** —— v0.1.0 起 `replyPlaceholderText` 字段定义了但**从未被注入响应**（dead code）。粉丝发完消息到 agent LLM 跑完之间几秒到几十秒，粉丝那边\"啥反应都没有\"，体验差。本版本激活 placeholder。\n\n### 现象\n\n```\n粉丝发消息 → 微信 → webhook → 立即返 \"success\" → 粉丝看不到任何反馈 ......（5~30 秒静默）...... → agent 终于回复 → 客服消息发到 → 粉丝看到回复\n```\n\n客户体验：「我刚发完是不是没收到啊？」\n\n### 修复\n\n`src/transport/webhook/handler.ts` —— `replyMode === \"async\"` 且消息是用户主动发的（text/image/voice/video/location/link），立即用被动回复 XML 返回 `replyPlaceholderText`：\n\n```xml\n
\n\n
\n 打破信息孤岛，用一套系统驱动企业增长
\n 加速企业用户向全场景人工智能机器人转变\n
| 🏫 教学机构 | 逸寻智库 |
| 👨🏫 讲师 | Job |
| 📧 联系方式 | support@huo15.com |
| 💬 QQ群 | 1093992108 |
| 📺 配套视频 | B站视频：https://space.bilibili.com/400418085 |
\n
\n\n## 📖 正文内容\n\n> **OpenClaw 微信服务号（公众号）渠道插件**：把微信公众号变成你的 AI 协作入口。\n> 一粉一会话隔离 · 12 个 agent tool · 覆盖 60+ 个微信公众平台官方 API · 多账号矩阵路由 · 知识库双写\n\n```\n@huo15/wechat-service v2.3.3\n└─ 12 个 agent tool / 60+ 个 WeChat MP API / 架构按 @huo15/wecom 同构\n```\n\n### ✨ 能力总览\n\n| 维度 | 说明 |\n|------|------|\n| **🚀 一粉一会话**（v2.3.0+ 默认开启） | 动态 Agent 派生：每个 openid 自动一个独立 agent + 独立 session / 记忆；管理员名单可旁路 |\n| **📨 消息全栈** | 客服消息（10 类）/ 模板消息（CRUD + 公模板库）/ 一次性 + **长期订阅通知** |\n| **📰 内容发布** | 素材管理 + 草稿箱 + `freepublish` 流水线 + 群发（按标签/openid，预览，撤回） |\n| **🔐 网页授权** | OAuth2.0 全流程（snsapi_base / snsapi_userinfo） + JS-SDK 签名 |\n| **📊 数据分析** | datacube 17 项指标（用户增减、图文阅读分享、消息分析、接口调用） |\n| **🤖 智能开放** | OCR 7 类（身份证/银行卡/驾驶证/行驶证/营业执照/车牌/通用） + 图像处理 3 项 |\n| **🎫 卡券精简** | create / get / batchget / delete / consume / decrypt encrypt_code |\n| **🧠 多账号矩阵** | `accounts.
\n\n**公司名称：** 青岛火一五信息科技有限公司\n**联系邮箱：** postmaster@huo15.com | **QQ群：** 1093992108\n\n
\n\n
\n 关注逸寻智库公众号，获取更多资讯\n
\n\n\n\n## 📄 License\n\nMIT © 青岛火一五信息科技有限公司（jobzhao / zhaobod1@163.com）\n\n详见 [`LICENSE`](./LICENSE)。\n\nFile v2.3.4:_meta.json\n\n{\n \"ownerId\": \"kn7byevkn40d6z4p7ghdb097z983tj33\",\n \"slug\": \"huo15-openclaw-wechat-service\",\n \"version\": \"2.3.4\",\n \"publishedAt\": 1778568790848\n}\n\nFile v2.3.4:CHANGELOG.md\n\n# Changelog\n\n## 2.3\n\nArchive v2.3.3: 93 files, 298009 bytes\n\nFiles: CHANGELOG.md (58958b), CLAUDE.md (7836b), index.ts (1916b), openclaw.plugin.json (23497b), package-lock.json (302775b), package.json (2772b), README.md (35086b), scripts/release.sh (11010b), SKILL.md (4149b), src/access-token.test.ts (3357b), src/access-token.ts (4298b), src/api/analytics.test.ts (4004b), src/api/analytics.ts (8445b), src/api/card.test.ts (5237b), src/api/card.ts (5770b), src/api/customer-service.ts (5026b), src/api/draft.ts (7374b), src/api/intelligent.test.ts (3974b), src/api/intelligent.ts (5814b), src/api/jssdk.ts (3791b), src/api/mass-send.ts (5897b), src/api/material.ts (9433b), src/api/menu.ts (4293b), src/api/oauth.test.ts (6105b), src/api/oauth.ts (5179b), src/api/qrcode.ts (4099b), src/api/subscribe-message.test.ts (8760b), src/api/subscribe-message.ts (6600b), src/api/template-message.ts (6732b), src/api/user-tag.ts (6561b), src/api/user.ts (2272b), src/app/account-runtime.test.ts (6020b), src/app/account-runtime.ts (3985b), src/app/index.ts (4072b), src/auto-reply.test.ts (8862b), src/auto-reply.ts (9049b), src/channel.ts (7221b), src/config/accounts.test.ts (3599b), src/config/accounts.ts (8864b), src/config/derived-paths.ts (725b), src/config/index.ts (600b), src/crypto.test.ts (3165b), src/crypto.ts (6468b), src/dynamic-agent.test.ts (12246b), src/dynamic-agent.ts (8811b), src/gateway-monitor.ts (4276b), src/http-client.ts (5824b), src/knowledge/index.ts (1603b), src/knowledge/local-sync.ts (2977b), src/knowledge/odoo-sync.ts (6761b), src/monitor.ts (486b), src/onboarding.test.ts (8125b), src/onboarding.ts (12888b), src/outbound.ts (8449b), src/runtime.ts (296b), src/runtime/dispatcher.ts (8266b), src/shared/authorization.test.ts (14268b), src/shared/authorization.ts (11230b), src/shared/guard.test.ts (7420b), src/shared/guard.ts (8250b), src/shared/markdown-to-wechat.test.ts (5531b), src/shared/markdown-to-wechat.ts (6246b), src/shared/personas/it-support.ts (11511b), src/shared/roles.test.ts (10504b), src/shared/roles.ts (10229b), src/shared/xml-parser.test.ts (3492b), src/shared/xml-parser.ts (7421b), src/tools/analytics-tool.ts (5078b), src/tools/article-tool.ts (11821b), src/tools/card-tool.ts (7615b), src/tools/index.ts (2567b), src/tools/intelligent-tool.ts (4439b), src/tools/jssdk-tool.ts (4750b), src/tools/mass-send-tool.ts (9012b), src/tools/material-tool.ts (11251b), src/tools/menu-tool.ts (6447b), src/tools/message-tool.ts (27404b), src/tools/oauth-tool.ts (7776b), src/tools/qrcode-tool.ts (6332b), src/tools/shared.ts (5108b)\n\nArchive v2.3.2: 93 files, 290399 bytes\n\nFiles: CHANGELOG.md (55200b), CLAUDE.md (7836b), index.ts (1916b), openclaw.plugin.json (23497b), package-lock.json (302775b), package.json (2629b), README.md (22848b), scripts/release.sh (11010b), SKILL.md (4290b), src/access-token.test.ts (3357b), src/access-token.ts (4298b), src/api/analytics.test.ts (4004b), src/api/analytics.ts (8445b), src/api/card.test.ts (5237b), src/api/card.ts (5770b), src/api/customer-service.ts (5026b), src/api/draft.ts (7374b), src/api/intelligent.test.ts (3974b), src/api/intelligent.ts (5814b), src/api/jssdk.ts (3791b), src/api/mass-send.ts (5897b), src/api/material.ts (9433b), src/api/menu.ts (4293b), src/api/oauth.test.ts (6105b), src/api/oauth.ts (5179b), src/api/qrcode.ts (4099b), src/api/subscribe-message.test.ts (8760b), src/api/subscribe-message.ts (6600b), src/api/template-message.ts (6732b), src/api/user-tag.ts (6561b), src/api/user.ts (2272b), src/app/account-runtime.test.ts (6020b), src/app/account-runtime.ts (3985b), src/app/index.ts (4072b), src/auto-reply.test.ts (7198b), src/auto-reply.ts (6444b), src/channel.ts (7221b), src/config/accounts.test.ts (3599b), src/config/accounts.ts (8864b), src/config/derived-paths.ts (725b), src/config/index.ts (600b), src/crypto.test.ts (3165b), src/crypto.ts (6468b), src/dynamic-agent.test.ts (12246b), src/dynamic-agent.ts (8811b), src/gateway-monitor.ts (4276b), src/http-client.ts (5824b), src/knowledge/index.ts (1603b), src/knowledge/local-sync.ts (2977b), src/knowledge/odoo-sync.ts (6761b), src/monitor.ts (486b), src/onboarding.test.ts (8125b), src/onboarding.ts (12888b), src/outbound.ts (8449b), src/runtime.ts (296b), src/runtime/dispatcher.ts (8266b), src/shared/authorization.test.ts (14268b), src/shared/authorization.ts (11230b), src/shared/guard.test.ts (7420b), src/shared/guard.ts (8250b), src/shared/markdown-to-wechat.test.ts (5531b), src/shared/markdown-to-wechat.ts (6246b), src/shared/personas/it-support.ts (11511b), src/shared/roles.test.ts (10504b), src/shared/roles.ts (10229b), src/shared/xml-parser.test.ts (3492b), src/shared/xml-parser.ts (7421b), src/tools/analytics-tool.ts (5078b), src/tools/article-tool.ts (11821b), src/tools/card-tool.ts (7615b), src/tools/index.ts (2567b), src/tools/intelligent-tool.ts (4439b), src/tools/jssdk-tool.ts (4750b), src/tools/mass-send-tool.ts (9012b), src/tools/material-tool.ts (11251b), src/tools/menu-tool.ts (6447b), src/tools/message-tool.ts (27404b), src/tools/oauth-tool.ts (7776b), src/tools/qrcode-tool.ts (6332b), src/tools/shared.ts (5108b)\n\nArchive v2.3.1: 93 files, 285857 bytes\n\nFiles: CHANGELOG.md (51033b), CLAUDE.md (7836b), index.ts (1916b), openclaw.plugin.json (23385b), package-lock.json (302775b), package.json (2629b), README.md (22848b), scripts/release.sh (11010b), SKILL.md (4163b), src/access-token.test.ts (3357b), src/access-token.ts (4298b), src/api/analytics.test.ts (4004b), src/api/analytics.ts (8445b), src/api/card.test.ts (5237b), src/api/card.ts (5770b), src/api/customer-service.ts (5026b), src/api/draft.ts (7374b), src/api/intelligent.test.ts (3974b), src/api/intelligent.ts (5814b), src/api/jssdk.ts (3791b), src/api/mass-send.ts (5897b), src/api/material.ts (9433b), src/api/menu.ts (4293b), src/api/oauth.test.ts (6105b), src/api/oauth.ts (5179b), src/api/qrcode.ts (4099b), src/api/subscribe-message.test.ts (8760b), src/api/subscribe-message.ts (6600b), src/api/template-message.ts (6732b), src/api/user-tag.ts (6561b), src/api/user.ts (2272b), src/app/account-runtime.test.ts (6020b), src/app/account-runtime.ts (3985b), src/app/index.ts (4072b), src/auto-reply.test.ts (7198b), src/auto-reply.ts (6444b), src/channel.ts (7221b), src/config/accounts.test.ts (3599b), src/config/accounts.ts (8864b), src/config/derived-paths.ts (725b), src/config/index.ts (600b), src/crypto.test.ts (3165b), src/crypto.ts (6468b), src/dynamic-agent.test.ts (12246b), src/dynamic-agent.ts (8811b), src/gateway-monitor.ts (4276b), src/http-client.ts (5824b), src/knowledge/index.ts (1603b), src/knowledge/local-sync.ts (2977b), src/knowledge/odoo-sync.ts (6761b), src/monitor.ts (486b), src/onboarding.test.ts (8125b), src/onboarding.ts (12888b), src/outbound.ts (8449b), src/runtime.ts (296b), src/runtime/dispatcher.ts (8266b), src/shared/authorization.test.ts (14268b), src/shared/authorization.ts (11230b), src/shared/guard.test.ts (7420b), src/shared/guard.ts (8250b), src/shared/markdown-to-wechat.test.ts (5531b), src/shared/markdown-to-wechat.ts (6246b), src/shared/personas/it-support.ts (4833b), src/shared/roles.test.ts (10504b), src/shared/roles.ts (10229b), src/shared/xml-parser.test.ts (3492b), src/shared/xml-parser.ts (7421b), src/tools/analytics-tool.ts (5078b), src/tools/article-tool.ts (11821b), src/tools/card-tool.ts (7615b), src/tools/index.ts (2567b), src/tools/intelligent-tool.ts (4439b), src/tools/jssdk-tool.ts (4750b), src/tools/mass-send-tool.ts (9012b), src/tools/material-tool.ts (11251b), src/tools/menu-tool.ts (6447b), src/tools/message-tool.ts (27404b), src/tools/oauth-tool.ts (7776b), src/tools/qrcode-tool.ts (6332b), src/tools/shared.ts (5108b)\n\nArchive v2.3.0: 93 files, 283771 bytes\n\nFiles: CHANGELOG.md (48505b), CLAUDE.md (7836b), index.ts (1916b), openclaw.plugin.json (23385b), package-lock.json (302775b), package.json (2652b), README.md (22848b), scripts/release.sh (11010b), SKILL.md (4345b), src/access-token.test.ts (3357b), src/access-token.ts (4298b), src/api/analytics.test.ts (4004b), src/api/analytics.ts (8445b), src/api/card.test.ts (5237b), src/api/card.ts (5770b), src/api/customer-service.ts (3913b), src/api/draft.ts (7374b), src/api/intelligent.test.ts (3974b), src/api/intelligent.ts (5814b), src/api/jssdk.ts (3791b), src/api/mass-send.ts (5897b), src/api/material.ts (9433b), src/api/menu.ts (4293b), src/api/oauth.test.ts (6105b), src/api/oauth.ts (5179b), src/api/qrcode.ts (...","readmeExcerpt":"Skill: Huo15 Openclaw Wechat Service Owner: zhaobod1 Summary: OpenClaw 微信服务号（公众号）渠道插件 v2.3.5 hotfix —— **修 errcode 45002 content size out of limit**：truncateForWechatText 改字节截断（微信限 2048 字节不是字符，中文 1 字 = 3 字节），默认 1900 字节留... Tags: latest:2.3.5, plugin:2.3.5 Version history: v2.3.5 | 2026-05-12T16:33:21.213Z | auto v2.3.5 hotfix: 修复 LLM 回复被微信拒收的问题 - truncateForWechatText 改为按字节截断，严格适配微信 2048 字节限制（而非字符），默认保留 1900 字节安全余量 -","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# 通过 OpenClaw 安装（推荐）\n/install @huo15/wechat-service\n\n# 或 npm\nnpm install @huo15/wechat-service"},{"language":"yaml","snippet":"channels:\n wechat-service:\n dynamicAgents:\n enabled: true\n dmCreateAgent: true # 每个 openid 一个 agent\n adminUsers: [oABC123xyz] # 管理员旁路走 main agent"},{"language":"yaml","snippet":"channels:\n wechat-service:\n accounts:\n main:\n appId: wx1234567890abcdef\n appSecret: ${WECHAT_SERVICE_APP_SECRET}\n token: ${WECHAT_SERVICE_TOKEN}\n encodingAESKey: ${WECHAT_SERVICE_AES_KEY}\n encryptMode: safe"},{"language":"text","snippet":"v0.1.0 初始版本\nv0.2.0 ✅ Phase 0 动态 Agent 框架\nv0.3.0 ✅ Phase 1 通知能力补全\nv0.4.0 ✅ Phase 2 OAuth + 数据统计\nv1.0.0 ✅ Phase 3 智能开放 + 卡券（latest）"},{"language":"text","snippet":"@huo15/wechat-service v2.3.3\n└─ 12 个 agent tool / 60+ 个 WeChat MP API / 架构按 @huo15/wecom 同构"},{"language":"bash","snippet":"# 通过 OpenClaw 安装（推荐）\n/install @huo15/wechat-service\n\n# 或直接 npm\nnpm install @huo15/wechat-service"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: huo15-openclaw-wechat-service\ndescription: \"OpenClaw 微信服务号（公众号）渠道插件 v2.3.5 hotfix —— **修 errcode 45002 content size out of limit**：truncateForWechatText 改字节截断（微信限 2048 字节不是字符，中文 1 字 = 3 字节），默认 1900 字节留余量；保护 标签不截在内部避免 XML 错乱；中文 / emoji / 混合场景全覆盖。症状：v2.3.0~v2.3.4 粉丝只收 placeholder 不收 LLM 真回复——根因 LLM 输出 > 600 中文字超 2048 字节被微信拒。承袭 v2.3.x 全部能力。287 vitest 用例全过。\"\nversion: 2.3.5\nhomepage: https://cnb.cool/huo15/ai/huo15-openclaw-wechat-service\nmetadata: { \"openclaw\": { \"emoji\": \"💬\", \"kind\": \"channel-plugin\", \"channelId\": \"wechat-service\", \"requires\": { \"bins\": [] } } }\n---\n\n# huo15-openclaw-wechat-service v2.1.0\n\nOpenClaw 微信服务号（公众号）渠道插件。\n\n## 这是什么\n\n把微信公众号接进 OpenClaw Agent 体系，让公众号粉丝可以直接和 LLM agent 聊天 / 接收通知 / 触发业务流程，覆盖**消息收发、内容发布、网页授权、数据分析、智能识别、卡券**六大维度。\n\n## 安装\n\n```bash\n# 通过 OpenClaw 安装（推荐）\n/install @huo15/wechat-service\n\n# 或 npm\nnpm install @huo15/wechat-service\n```\n\n随后在 OpenClaw 里 `/setup wechat-service` 跑向导。\n\n## 核心特性\n\n### 🚀 一粉一会话动态 Agent\n\n模仿 `@huo15/wecom` 的动态 Agent 框架：\n\n```yaml\nchannels:\n wechat-service:\n dynamicAgents:\n enabled: true\n dmCreateAgent: true # 每个 openid 一个 agent\n adminUsers: [oABC123xyz] # 管理员旁路走 main agent\n```\n\n每个粉丝的 openid 自动派生独立 agent（命名 `wechat-service-{accountId}-dm-{sanitized_openid}`），实现真正的一对一会话隔离。\n\n### 🛠️ 12 个 Agent Tool / 60+ API\n\n| Tool | 主要 action |\n|------|-------------|\n| `wechat_service_menu` | 自定义菜单（基础 + 个性化）|\n| `wechat_service_message` | 客服消息 + 模板消息 + 公模板库 + 一次性订阅 + 长期订阅通知（25 个 actions）|\n| `wechat_service_material` | 临时/永久素材 |\n| `wechat_service_article` | 草稿箱 + freepublish 流水线 |\n| `wechat_service_user` | 用户/标签/黑名单 |\n| `wechat_service_qrcode` | 带参二维码 + short_key |\n| `wechat_service_mass_send` | 按标签/openid/预览群发 |\n| `wechat_service_jssdk` | wx.config 签名 |\n| `wechat_service_oauth` | 网页授权 OAuth2.0 全流程 |\n| `wechat_service_analytics` | datacube 17 项指标 |\n| `wechat_service_intelligent` | OCR 7 类 + 图像处理 3 项 |\n| `wechat_service_card` | 卡券精简（6 个 actions）|\n\n### 🧠 多账号矩阵 + 知识库双写\n\n- `accounts.
\n\n
\n 打破信息孤岛，用一套系统驱动企业增长
\n 加速企业用户向全场景人工智能机器人转变\n
| 🏫 教学机构 | 逸寻智库 |
| 👨🏫 讲师 | Job |
| 📧 联系方式 | support@huo15.com |
| 💬 QQ群 | 1093992108 |
| 📺 配套视频 | B站视频：https://space.bilibili.com/400418085 |
\n
\n\n## 📖 正文内容\n\n> **OpenClaw 微信服务号（公众号）渠道插件**：把微信公众号变成你的 AI 协作入口。\n> 一粉一会话隔离 · 12 个 agent tool · 覆盖 60+ 个微信公众平台官方 API · 多账号矩阵路由 · 知识库双写\n\n```\n@huo15/wechat-service v2.3.3\n└─ 12 个 agent tool / 60+ 个 WeChat MP API / 架构按 @huo15/wecom 同构\n```\n\n### ✨ 能力总览\n\n| 维度 | 说明 |\n|------|------|\n| **🚀 一粉一会话**（v2.3.0+ 默认开启） | 动态 Agent 派生：每个 openid 自动一个独立 agent + 独立 session / 记忆；管理员名单可旁路 |\n| **📨 消息全栈** | 客服消息（10 类）/ 模板消息（CRUD + 公模板库）/ 一次性 + **长期订阅通知** |\n| **📰 内容发布** | 素材管理 + 草稿箱 + `freepublish` 流水线 + 群发（按标签/openid，预览，撤回） |\n| **🔐 网页授权** | OAuth2.0 全流程（snsapi_base / snsapi_userinfo） + JS-SDK 签名 |\n| **📊 数据分析** | datacube 17 项指标（用户增减、图文阅读分享、消息分析、接口调用） |\n| **🤖 智能开放** | OCR 7 类（身份证/银行卡/驾驶证/行驶证/营业执照/车牌/通用） + 图像处理 3 项 |\n| **🎫 卡券精简** | create / get / batchget / delete / consume / decrypt encrypt_code |\n| **🧠 多账号矩阵** | `accounts.