前言¶
企业微信里用户习惯发语音，机器人侧若只做文本转写再丢给通用对话，往往接不住「回拨、查进度、投诉升级」这类带流程的诉求；电话场景还要兼顾外呼调度、纪要、录音合规。下面介绍 SkillHub 社区技能「企业微信语音消息 Agent」，把语音消息的意图识别、多轮对话与任务执行收进一套基于 SKILL.md 的 Agent 能力，并覆盖被动收消息与主动外呼等完整电话链路。
这是什么¶
企业微信语音消息 Agent（坐标 @user_1a470ba8/wecom-voice-agent）是分类为 ai-agent 的社区 Skill，当前版本 v2.9.0，由发布者 user_1a470ba8 维护。官方页面标注 requires_api_key=false，强调在常见部署下可不依赖额外 API Key，同时支持硬件自适应与轻量本地处理。
触发方式明确：当用户向企业微信机器人发送语音消息时生效——单聊直接发语音，或群聊中 @ 机器人 后发语音（v2.9 起支持群聊语音助手模式）。
核心功能¶
以下能力均来自 SkillHub 官方简介，按场景归纳。
语音与对话主干¶
- 自动处理语音消息的意图识别、多轮对话与任务执行。
- 支持被动接收语音消息，以及主动外呼、来电接线、通话纪要、合规录音、外呼调度等电话相关能力。
v2.7 子模块¶
| 模块 | 作用（官方描述） |
|---|---|
memory_bridge.py |
长期记忆 MCP 桥接（zwjh）：来电拉取历史、通话回写，含降级方案 |
todo_followup.py |
纪要抽取待办 → 自动登记回拨 → 到期提醒/二次外呼；查询意图可问答 |
emotion_ticket_bridge.py |
强负面情感到工单：直连 ticket_manager 建单、升级、主管通知，无需独立触发 |
v2.8 语音与运营¶
- TTS 多音色与情感（
voice_policy.py）：voices.yaml三套预设；情感语速语调叠加限幅；SSML 停顿加重；Edge/火山双链路降级。 - 语音克隆外呼（
voice_clone.py）：豆包/MiniMax 可选接入；授权留痕与合规红线；仅外呼场景；未配置时完全隐藏。 - 通话摘要质检（
summary_qa.py）：决策/待办/时间三要素加权评分，≥80 分交付；5% 人工抽检与纠错回流驱动 Prompt 迭代。 - 运营报表（
report_generator.py）：接通率、时长分布、意图分布、外呼四级漏斗；周一 HTML 周报单文件导出。
v2.9 群聊语音助手¶
- @ 机器人触发群消息路由，复用单聊意图引擎，并注入说话人身份上下文。
- 语音指派任务：抽取「指派人 / 被指派人 / 期限」三元组 → 自动建待办、确认回执、到期提醒闭环。
- 群场景合规默认：
record:false，磁盘零语音落盘；voices.yaml可开启落盘，但需管理员确认。
安装与启用¶
SkillHub 页面给出的安装指引是：让当前使用的 AI Agent 按 SkillHub 安装文档 安装 @user_1a470ba8/wecom-voice-agent。若本机已具备 skillhub CLI，可按文档第三节将技能装到当前 Agent 实际读取的 skills 目录（须使用 --dir，否则默认 ./skills/ 可能不被识别）。
先检查 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（文档推荐）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将 <skills 目录> 换成你正在用的客户端路径，例如：
# Cursor
skillhub install user_1a470ba8/wecom-voice-agent --dir ~/.cursor/skills/
# Claude Code
skillhub install user_1a470ba8/wecom-voice-agent --dir ~/.claude/skills/
# Codex（用户级或项目级二选一）
skillhub install user_1a470ba8/wecom-voice-agent --dir ~/.codex/skills/
# skillhub install user_1a470ba8/wecom-voice-agent --dir .agents/skills/
也可先搜索再安装：
skillhub search wecom-voice-agent
skillhub install user_1a470ba8/wecom-voice-agent --dir <skills 目录>
经过上面的步骤，Skill 会落在对应目录；具体企业微信机器人回调、YAML 意图或 IVR 等细节以技能包内 SKILL.md 及附带配置为准（官方简介中明确出现的配置文件包括 voices.yaml）。
典型用法¶
- 按上一节把
@user_1a470ba8/wecom-voice-agent安装到 Cursor、Claude Code 或 Codex 等环境的 skills 目录，并确保 Agent 已加载该 Skill。 - 在企业微信中配置好对接该 Agent 的机器人后，单聊发送语音，或由用户在群里 @ 机器人后发送语音。
- Agent 侧按技能逻辑完成转写、意图与多轮对话；涉及外呼、纪要、待办跟进、工单或群任务指派时，走 v2.7–v2.9 对应子模块（如未配置语音克隆，相关外呼克隆能力在界面上保持隐藏）。
官方未在页面给出可复制的企业微信后台参数示例，企业侧接入需结合技能包说明与自身合规要求。
适用场景与注意¶
适合谁
- 已在企业微信用机器人承接客服、回访、内部协同时，希望用语音作为一等入口的团队。
- 需要外呼调度、通话纪要、质检与周报，又不想在 Skill 层强绑第三方 API Key 的场景（标签为
requires_api_key=false）。 - 群内需通过 @ 机器人做语音指派与待办闭环的协作场景。
限制与注意
- 可选能力有边界：语音克隆依赖豆包/MiniMax 等可选接入，未配置时不应期待克隆外呼可用。
- 群聊默认不落盘语音（
record:false），若要在磁盘保留语音，须在voices.yaml中显式开启并完成管理员确认。 - 社区来源（
community），版本迭代快（当前页面为 v2.9.0），升级前建议在测试环境核对子模块行为与合规策略。 - SkillHub 页面统计（撰写时以官方为准）：评分 100000，下载 2021 次；与旧线索中的数字不一致时，以 SkillHub 页面为准。
结尾¶
企业微信语音消息 Agent 把语音入口、电话全流程与 v2.7–v2.9 的记忆、待办、工单、TTS/克隆、质检报表和群聊助手串成一条可落地的 Skill 链路，核心价值是零 API Key 依赖、硬件自适应、轻量本地处理与全流程合规取向。
- SkillHub 页面：https://www.skillhub.cn/skills/user_1a470ba8/wecom-voice-agent
- API 入口：https://api.skillhub.cn/user_1a470ba8/wecom-voice-agent
- 安装说明：https://skillhub.cn/install/skillhub.md
