v3.2.0

Features

• 新增 channels.wecom.workspaceTemplateExtraFiles，支持在默认模板文件之外复制相对路径文件/目录，覆盖脚本、依赖清单等模板资产。
• WS 入站新增短窗口附件文本聚合，文件/图片后紧邻文本会合并成一次模型调用；mixed.msg_item 同步支持提取文件附件。

Fixes

• 修复企业微信入站文件下载 503/超时后把加密二进制或乱码交给模型的问题：现在会重试，并在最终失败时直接提示用户重发附件。
• 修复“等待模型响应 1s/2s/...”在企微思考气泡里持续堆叠的问题，改为单行刷新当前秒数。
• 补充 sendThinkingMessage=true 但未收到 reasoning stream 时的诊断日志，记录 session reasoningLevel，便于定位是否被显式设为 off。

Docs

• README 补充 workspaceTemplateExtraFiles 用法。
• README 明确 sendThinkingMessage 只控制企微侧思考占位，真实 reasoning 内容依赖 session reasoningLevel: "stream"。

Tests

• 本地全量测试通过：293 pass / 0 fail。
• 已部署到 ali-ai 测试环境，Gateway、WeCom WS 认证、supported skills、真实 WeCom message send 均验证通过。

Closed issues: #150, #152, #161, #168.

v3.1.0

相对 v3.0.1 的变更摘要。

Features

• 官方 WeCom MCP 2026.4.23 对齐: wecom_mcp 协商版本升级到官方 2026.4.23，SDK 升级到 @wecom/aibot-node-sdk@1.0.6
• MCP 上下文透传: 工具工厂透传可信 requesterUserId、agentAccountId、原始大小写 chatId/chatType，文档授权错误时可通过 aibot_send_biz_msg 发送授权卡片
• MCP 拦截器增强: 支持 SmartPage page_filepath 读取、SmartPage 导出内容落本地文件、get_msg_media base64 媒体落本地文件、业务错误码触发缓存清理
• MCP 多账号 fallback: 默认账号非长连接机器人时，自动选择第一个配置了 botId/secret 的账号获取 MCP 配置
• doc-only skills 部署收敛: 移除当前企业未开通的 contact/todo/meeting/schedule/msg/send-media skills，保留 doc、smart sheet 和 preflight 相关 skills
• ali-ai 安装脚本: 新增 scripts/install-plugin.sh，同步插件代码与共享 skills、远端执行 npm ci --omit=dev、保持 root:root ownership 并重启校验 gateway

Docs

• README 增加企业微信 MCP 文档与智能表格说明，明确 forbidden for current apikey 属于企业微信后端权限拒绝，需要企业微信侧授权
• 更新 MCP 远程探测脚本默认版本与远端插件路径，避免继续使用旧 plugin_version=1.0.12

Tests

• 扩展 tests/mcp-tool.test.js，覆盖官方协商版本、请求人 header、文档授权卡片、SmartPage 文件读取/导出、本地 session chat 信息容量控制、多账号 MCP fallback
• 本地全量测试通过：287 pass / 0 fail

v3.0.1

相对 v3.0.0 的变更摘要。

Fixes

• WeCom /workspace/... 宿主路径解析对齐新版 OpenClaw: ws-monitor 和动态 agent workspace template 的路径计算改为优先读取 agents.defaults.workspace / agents.list[].workspace，非默认 agent 不再错误回退到 ~/.openclaw/workspace-<agentId>，修复新版多 agent workspace 根目录迁移后 FILE:/workspace/... / MEDIA:/workspace/... 文件发送失败的问题
• 回复文件发送引导强化: WeCom reply guidance 明确要求把 MEDIA: / FILE: 指令放在 <final> 标签内，并补充 browser 媒体必须先 stage_browser_media 再回复，减少模型回错宿主路径或把指令写到标签外导致的静默丢失

Tests

• 扩展 tests/reply-media-directive.test.js，覆盖 agents.defaults.workspace 作为非默认 agent workspace 基座时的 /workspace/... 解析
• 扩展 tests/workspace-template.test.js，覆盖 dynamic agent workspace 路径计算与 template seed 对新版 workspace 根目录的兼容

v3.0.0

Breaking Changes

• 仅支持 OpenClaw 2026.3.23-2+
• peerDependencies.openclaw 收紧为 ^2026.3.23-2
• 切换到新版 SDK 导出路径：plugin-sdk/status-helpers、plugin-sdk/core、plugin-sdk/media-runtime
• 不再兼容旧版 core 的媒体 / 状态目录兼容分支；旧环境请继续使用 2.x

Highlights

• 新增 WeCom 主动跨会话 sender 协议：message.send / message.sendAttachment 会自动注入 [[sender:...]]，出站时转成可见发送者前缀
• 增强目标寻址：支持将纯中文姓名转成拼音 userId，并结合已存在的动态 DM Agent 自动补全目标 userId
• 子 Agent 投递钩子适配新版 OpenClaw 事件系统
• WS 主动发送统一走 Markdown 载荷
• 补回被动回复本地媒体的允许目录校验，防止越权读取路径

Verification

• npm test

v2.4.0

v2.4.0 (2026-03-23)

Features

• MCP 按需架构重构: 移除 mcp-config.js 持久化模块，改为通过 WS 客户端按需获取 MCP 配置并内存缓存，消除文件系统路径依赖（#132, #141）
• MCP msg category 支持: wecom_mcp 新增消息类 MCP 调用，配套 wecom-msg 和 wecom-send-media skill
• MCP 企业规模限制说明: tool description 和错误消息中明确标注企微官方策略——>10 人企业仅支持 doc category，<=10 人小团队支持全部 category
• 回调入站媒体下载兼容: downloadCallbackMedia 改用 core.media runtime
• image_studio 回复规范: WS 回复引导中增加不重复输出图片 URL 的约束

Fixes

• Callback-only 账户启动修复 (#137): startAccount 跳过无 WS 凭据的 callback-only 账户的 WS monitor，防止 gateway restart 循环崩溃
• 动态 Agent 配置写入安全检查 (#136): ensureDynamicAgentListed 写入前验证内存配置含 channels 段，防止不完整快照覆盖用户配置文件
• replyFormat: "text" 全路径生效 (#139): sendViaAgent 传递 format 参数，sendViaWebhook 根据配置选择 webhookSendText / webhookSendMarkdown，个人微信端不再显示"暂不支持此消息类型"
• MCP unsupported category 错误增强 (#140): 返回企业规模限制说明 + 更明确的停止重试指令

Upgrade

openclaw extensions upgrade wecom

Full Changelog: v2.3.0...v2.4.0

v2.3.0

相对 v2.2.1

Features

• welcomeMessagesFile：JSON 外链欢迎语列表，热重载无需重启 gateway
• image_studio：可选通义/万相生图工具（qwenImageTools 配置）
• 子 Agent 投递公告（WS 模式，#133）

Fixes

• 动态 Agent 继承与 session key（#125）
• 被动回复媒体根与空 @（#120）
• 电话号码误识别部门 ID（#124）

详见 CHANGELOG.md。

@sunnoy/wecom 2.2.1

What's Changed

• fix: prevent phone numbers from being misidentified as department IDs by @yangsjt in #124
• Honor reply media roots and skip empty group mentions by @00010110 in #120

New Contributors

• @00010110 made their first contribution in #120

Full Changelog: v2.2.0...v2.2.1

@sunnoy/wecom 2.2.0

Full Changelog: v2.1.0...v2.2.0

v2.1.0

Features

• 自建应用 Agent 回调入站通道: 支持企微自建应用接收消息HTTP 回调模式作为独立入站渠道。在 agent.callback 配置 token、encodingAESKey、path 即可启用；路由自动注册，与 WS 通道并行运行
• Agent API 回复支持 Markdown: agentSendText 新增 format 参数（"text" | "markdown"），回调入站回复默认为 "markdown"；可通过 agent.replyFormat 配置项覆盖
• 入站/出站信息日志: WS 入站 [WS:account] ← inbound、CB 入站 [CB:account] ← inbound、CB 出站 [CB:account] → outbound 三条 INFO 日志，便于在 gateway 日志中追踪消息流

v2.0.2

2.0.2 (2026-03-11)

Fixes

• 字段值中的 @ 被误删: 修复 WeCom 群消息中

Tests

• 新增群聊回归测试，
• 新增 extractGroupMessageContent() 单测，验证 mention 去除与字段值中的 @ token 保留可同时成立