What makes wecom-voice-agent notable?

1.8K downloads. Trust evidence available

How should wecom-voice-agent be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

wecom-voice-agent

企业微信语音消息 AI Agent 技能，自动处理语音消息的意图识别、多轮对话与任务执行。支持被动接收语音消息、主动外呼、来电接线、通话纪要、合规录音、外呼调度等完整电话场景。 v2.6 新增：声明式意图引擎（YAML 配置 20+ 意图 + 多级澄清）、自定义意图插件（企业自有 API 声明式映射）、统一会... Skill: wecom-voice-agent Owner: fyniujin Summary: 企业微信语音消息 AI Agent 技能，自动处理语音消息的意图识别、多轮对话与任务执行。支持被动接收语音消息、主动外呼、来电接线、通话纪要、合规录音、外呼调度等完整电话场景。 v2.6 新增：声明式意图引擎（YAML 配置 20+ 意图 + 多级澄清）、自定义意图插件（企业自有 API 声明式映射）、统一会... Tags: latest:2.8.0 Version history: v2.8.0 | 2026-09-20T15:52:21.374Z | auto **v2.8.0 introduces voice TTS multi-voice, voice clone, summary QA, and ops reporting tools.** - Added config/voices.yaml: Predefine

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.8k

Updated

Oct 10, 2026

Version

2.8.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.8K downloadsadoption · observed Oct 10, 2026
Latest release: 2.8.0release · observed Sep 20, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177r8w7p1d7cpbys9bn33kwhs89d0xw:wecom-voice-agent

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fyniujin-wecom-voice-agent/snapshot"

Documentation

CLAWHUB

159,314 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: wecom-voice-agent
version: 2.8.0
description: >
---


# 企业微信语音消息 Agent

## ⚠️ 风险声明（必读）

### 能力边界

1. **本技能支持企业微信智能机器人场景**，包括被动语音消息处理和主动语音通话
2. **语音转文字由企业微信官方提供**，本技能不自行采集或上传用户语音至任何第三方
3. **不会读取或收集**用户的通讯录、聊天记录或其他个人隐私数据
4. **所有数据处理均在本地完成**，通话记录（含 ASR 转写文本、元数据）持久化存储于本机 SQLite 数据库（`~/.wecom_voice/call_records.db`），录音文件存储于 `~/.wecom_voice/records/`，保留期限默认 90 天，到期自动清理
5. **主动外呼需管理员授权**，且仅在用户明确同意录音后进行

### 外部连接披露

本技能仅在以下场景发起外部网络连接：

| 目标主机 | 用途 | 触发条件 | 传输数据 |
|---------|------|---------|---------|
| `wttr.in` | 天气查询 API | 用户主动发起天气查询请求 | 城市名称（不含用户身份信息） |
| `openspeech.bytedance.com` | 火山引擎 TTS 语音合成（备用链路） | 仅当配置 `VOLC_TTS_KEY` 且 Edge TTS 主链路不可用 | 待合成文本（通话播报内容） |
| `api.coze.cn` / `api.minimax.chat` | 语音克隆 API（豆包 / MiniMax） | 仅当配置 `CLONE_PROVIDER` + `CLONE_API_KEY` 主动创建克隆音色 | 音色名称与授权信息（不含通话内容） |

**除上述披露外，本技能不会向任何其他外部主机发起连接**。天气查询为只读 GET 请求；火山 TTS 与语音克隆均为可选增强能力，**未配置对应 Key 时静默跳过、绝不发起连接**，全部功能降级可用。所有外部连接均不上传用户身份信息。

### 安全风险项

| 风险等级 | 风险描述 | 预防措施 |
|---------|---------|---------| 
| 🔴 高 | 语音转写准确率受环境噪音影响 | 当置信度低时主动询问用户确认 |
| 🔴 高 | 误触发（电视/背景音乐被误认为语音） | 设置消息有效时长阈值，超过30秒无新消息则重置上下文 |
| 🔴 高 | 外呼过程中的隐私泄露风险 | 全程录音告知、用户同意后才录音 |
| 🟡 中 | 企业微信 API 频率限制（每分钟20次） | 实现请求队列和速率限制器 |
| 🟡 中 | 长上下文导致 Token 消耗过大 | 自动压缩历史消息，保留最近5轮对话 |
| 🟢 低 | 语音回复合成超时并发 | 超时后自动降级为文字回复 |

### 合规声明

- 本技能遵守《个人信息保护法》《数据安全法》相关规定
- 所有操作均基于用户主动发起的对话，不主动采集数据
- 语音数据由企业微信官方处理，本技能不存储原始音频
- 用户可随时通过发送文字消息退出语音模式
- **外呼录音必须获得用户明确同意才进行**
- **所有录音文件仅存储在本机 `~/.wecom_voice/records/`，永不外传**
- **通话记录（含 ASR 转写文本、元数据）存储于本机 SQLite，不上传第三方**
- **数据保留期限：录音文件 90 天，通话记录 180 天，到期自动清理**

---

## 🚀 快速开始

### 方式一：一条命令安装并体验

```bash
# 安装技能（如果已安装则跳过此步）
skillhub install wecom-voice-agent

# 第一步：检测你的电脑配置
python D:/skill/wecom-voice-agent/scripts/detect_hardware.py

# 第二步：模拟语音消息测试
python D:/skill/wecom-voice-agent/scripts/voice_simulator.py --text "明天有什么会议"

# 第三步：试试天气查询
python D:/skill/wecom-voice-agent/scripts/voice_simulator.py --text "北京今天天气怎么样"

# 第四步：创建会话并添加消息
python D:/skill/wecom-voice-agent/scripts/session_manager.py create --userid zhangsan
python D:/skill/wecom-voice-agent/scripts/session_manager.py stats
```

### 方式二：从零手动体验

```bash
# 克隆技能目录
cd D:/skill/wecom-voice-agent

# 1. 硬件检测（纯Python标准库，无需安装任何依赖）
python scripts/detect_hardware.py

# 2. 语音消息模拟器测试
python scripts/voice_simulator.py --text "提醒我下午3点开会"

# 3. 会话管理
python scripts/session_manager.py create --userid test
python scripts/session_manager.py stats
```

### v2.8 运营工具速用

```bash
cd D:/skill/wecom-voice-agent

# 查看全部可用音色（3 套预设，来自 config/voices.yaml）
python scripts/voice_policy.py list

# 按场景+情感预览合成参数与 SSML（不发起合成）
python scripts/voice_policy.py synth --scene outbound --emotion angry --confidence 0.9 --text "您好，通知您明天下午3点参加评审。" --ssml

# 查看语音克隆模块状态（未配置 CLONE_PROVIDER/CLONE_API_KEY 时完全隐藏）
python scripts/voice_clone.py status

# 评审一段通话摘要（三要素评分，≥80 分达标）
python scripts/summary_qa.py review --text "会议决定：下周三18点前由张三负责提交修订方案。" --id call_001

# 查看最近 7 天运营摘要 / 生成上周 HTML 周报
python scripts/report_generator.py summary --period week
python scripts/report_gener

README.md

# 企业微信语音消息 Agent

## ✨ 核心特性

- **零 API Key 依赖** - 企业微信内置 ASR 语音转文字免费使用
- **硬件自适应** - 自动检测用户电脑配置，调整并发和缓存策略
- **真正的天气查询** - 接入 wttr.in 免费 API，中文描述 + 穿衣建议
- **当前时间查询** - 本地计算，100%可用，无需任何网络依赖
- **主动外呼** - v2.0 起支持主动发起语音通话（预约确认、快递提醒、服务回访）
- **来电接线** - v2.0 起支持用户拨打企业绑定电话自动接线（IVR 替代）
- **通话纪要** - v2.0 起通话结束自动生成结构化纪要
- **合规录音** - v2.0 起全程合规（录音告知、用户同意、本机存储、不上传）
- **外呼调度** - v2.0 起支持定时外呼和批量外呼（CSV 导入）
- **多轮对话** - 支持上下文保持的连续对话
- **性能优先** - 低配电脑也能流畅运行
- **安全可靠** - 所有数据处理在本地完成，不上传用户隐私
- **开箱即用** - 纯 Python 标准库，无需安装任何依赖

## 🚀 快速开始

### 一条命令体验所有功能

```bash
# 1. 一键测试（无需启动服务）
cd D:/skill/wecom-voice-agent
python scripts/wecom_webhook_server.py --quick

# 2. 单独测试某个指令
python scripts/voice_simulator.py --text "北京今天天气怎么样"
python scripts/voice_simulator.py --text "现在几点"
python scripts/voice_simulator.py --text "提醒我下午3点开会"
```

### 部署真实机器人

```bash
# 1. 启动回调服务器
python scripts/wecom_webhook_server.py --port 8080

# 2. 使用内网穿透暴露端口
ngrok http 8080
# 或
frpc http -l 8080 -p your-domain.com

# 3. 将穿透 URL 填入企业微信管理后台 → 智能机器人 → 回调 URL

# 4. 发送语音消息测试
```

> 📖 **详细部署指南**：参见 `references/step_by_step_setup.md`

## 🪤 避坑指南

| 常见坑 | 正确做法 |
|-------|---------|
| ❌ 在嘈杂环境发送语音指令 | ✅ 在安静环境说话，距离麦克风 20-30cm |
| ❌ 一次说多句话 | ✅ 一次只做一件事，分开发送 |
| ❌ 发送超过60秒的语音 | ✅ 控制在 60 秒以内 |
| ❌ 在群聊中发语音 | ✅ 只对机器人私聊发语音 |
| ❌ 发送方言 | ✅ 用普通话或粤语发送 |

## 📁 项目结构

```
wecom-voice-agent/
├── SKILL.md                          # 技能主文件（指令 + 可运行命令）
├── README.md                         # 项目说明
├── references/
│   ├── step_by_step_setup.md     # 分步部署指南（7步图文教程）
│   └── wecom_bot_api.md          # 企业微信机器人 API 参考
├── templates/
│   └── emotion_strategies.json   # 情感对话策略模板 v2.2（新增）
└── scripts/
    ├── detect_hardware.py        # 硬件检测脚本
    ├── voice_simulator.py        # 语音消息模拟器
    ├── session_manager.py        # 会话管理器（v2.2 扩展情感状态）
    ├── wecom_webhook_server.py   # 智能机器人回调服务器 v2.2（集成情感分析）
    ├── state_machine.py          # 多轮对话状态机 v2.0
    ├── compliance.py             # 合规录音管理器 v2.0
    ├── ivr_minutes.py            # 通话自动纪要 v2.0
    ├── scheduler.py              # 外呼任务调度 v2.0
    ├── stats.py                  # 通话记录看板 v2.0
    ├── transcriber.py            # 录音全文转写 v2.0
    └── emotion_analyzer.py       # 情感识别与自适应策略 v2.2（新增）
```

## 📋 支持的语音命令

| 命令示例 | 功能 | 是否需要额外配置 |
|---------|------|---------------|
| "北京今天天气怎么样？" | ✅ 实时天气查询 | ❌ 不需要 |
| "现在几点？" | ✅ 当前时间查询 | ❌ 不需要 |
| "明天有什么会议？" | 🗓️ 日程查询 | ⚠️ 需管理员授权 |
| "提醒我下午3点提交报告" | 📝 创建待办 | ⚠️ 需管理员授权 |
| "发消息给张三：明天开会" | 📬 发送消息 | ⚠️ 需管理员授权 |
| "你能做什么？" | 📖 获取帮助 | ❌ 不需要 |
| "退出语音模式" | 🚪 切换到文字模式 | ❌ 不需要 |

> 💡 **提示**：标注「⚠️ 需管理员授权」的功能，需要企业微信管理员在 work.weixin.qq.com 后台开启对应权限后才能真正执行。查询类功能（天气/时间）无需配置即可使用。

## 📞 v2.0 通话功能

| 功能 | 触发方式 | 说明 |
|-----|---------|------|
| 主动外呼 | 系统/用户发起 | 预约确认、快递提醒、服务回访 |
| 来电接线 | 用户拨打企业绑定电话 | 自动语音交互（IVR 替代） |
| 通话纪要 | 通话结束自动 | 提取决策点/待办项/时间点 |
| 合规录音 | 用户同意后 | 本机存储，不上传第三方 |
| 外呼调度 | 定时/批量 | CSV 导入客户列表 |
| 通话看板 | `python stats.py` | 统计通话数据和趋势 |
| 全文转写 | 通话结束后 | 输出 .txt + .docx |

## ⚠️ 限制与边界

- 仅支持企业微信智能机器人场景
- 不支持主动外呼电话（v2.0 起支持，但需管理员授权）
- 语音消息限 60 秒以内

_meta.json

{
  "ownerId": "kn7chdrwbdhaqkwajcyhtfvjx989ddb1",
  "slug": "wecom-voice-agent",
  "version": "2.8.0",
  "publishedAt": 1789919541374
}

references/step_by_step_setup.md

# 企业微信智能机器人 — 分步部署指南

本教程带你**从零开始**搭建一个能接收语音消息的企业微信智能机器人。
按照以下步骤操作，**不需要任何编程基础**。

---

## 第一步：前提条件

确保你已具备：

- [ ] 一台 Windows 电脑（已安装企业微信）
- [ ] 注册一个企业微信账号
- [ ] 安装 Python 3.8+

检查 Python 安装：

```bash
python --version
```

---

## 第二步：获取企业微信 CorpID 和 Secret

### 2.1 获取 CorpID

1. 打开 https://work.weixin.qq.com
2. 登录你的企业微信管理后台
3. 点击 **我的企业** → 下拉找到 **企业ID**
4. 复制并保存这个 ID（例如：`ww1234567890abcdef`）

### 2.2 创建自建应用

1. 管理后台 → **应用管理** → **自建** → **创建应用**
2. 填写应用名称（如"语音助手"），上传一个 logo
3. 可见范围选择 **全部成员**
4. 创建后进入该应用，记录以下信息：
   - **AgentID**（应用 ID）
   - **Secret**（应用密钥）

---

## 第三步：配置智能机器人回调

1. 在应用详情页面找到 **智能机器人**
2. 点击 **开启**，设置以下参数：

```
回调 Token: 任意字符串（如 my_wecom_voice_bot_2026）
EncodingAESKey: 随机生成或自己填写一个 43 位字符串
```

3. **回调 URL**：先填写一个临时地址（如 `http://example.com/callback`），等服务器启动后再更新

---

## 第四步：启动本地服务器

### 4.1 进入技能目录

```bash
cd D:\skill\wecom-voice-agent
```

### 4.2 启动 Webhook 服务器

```bash
python scripts/wecom_webhook_server.py --port 8080
```

看到以下输出说明启动成功：

```
============================================================
企业微信语音消息回调服务器已启动
监听地址: http://0.0.0.0:8080
...
============================================================
```

### 4.3 URL 验证

企业微信会向你的回调 URL 发送 GET 请求验证。确保：
- 你的服务器正在运行
- URL 路径是 `/`（即服务器访问地址 + `/`）

验证通过后，服务器日志会显示：

```
INFO: URL 验证请求已处理
```

---

## 第五步：内网穿透（如果你的电脑没有公网 IP）

大多数公司/家庭网络没有公网 IP，需要使用内网穿透工具暴露 8080 端口。

### 使用 frp（推荐）

```bash
# 安装 frp 后
frpc http -l 8080 -p your-domain.com
```

### 使用 ngrok（快速）

```bash
ngrok http 8080
```

获得一个公网地址如 `https://abc123.ngrok-free.app`，将其作为回调 URL。

---

## 第六步：更新回调 URL

回到企业微信管理后台 → 智能机器人 → 编辑回调 URL：

```
https://abc123.ngrok-free.app/
```

提交后企业微信会重新验证 URL，看到验证成功即可。

---

## 第七步：测试语音消息

1. 打开企业微信客户端
2. 搜索你刚刚创建的机器人应用（如"语音助手"）
3. 发送一条语音消息："明天有什么会议？"
4. 机器人应该回复一个帮助信息的文字消息

**成功！** 你的企业微信语音助手已经上线了。

---

## 常见问题

| 问题 | 解决方案 |
|------|---------|
| 验证 URL 失败 | 检查服务器是否启动、端口是否正确、穿透工具是否运行 |
| 收不到语音消息 | 确保回调 URL 正确、智能机器人已开启、消息类型支持语音 |
| 中文乱码 | 服务器已使用 UTF-8 编码，检查终端编码设置 |
| 被动回复超时 | 单次回复超过 5 秒会被企业微信丢弃，检查代码性能 |

---

## 高级配置

### 配置 Token/AESKey 解密

本技能默认部署。如需加密解密消息，请修改配置：

```python
WECHAT_CONFIG = {
    "token": "your_real_token",
    "encoding_aes_key": "your_real_key",
    ...
}
```

并安装加密包：

```bash
pip install pycryptodome
```

### 扩展功能（接入企业微信 API）

当你的技能需要回发消息、查询日历时，需要获取 access_token：

```bash
curl -s -X POST \
  'https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ww1234567890abcdef&corpsecret=YOUR_SECRET' \
  | python -c "import sys,json;d=json.load(sys.stdin);print(d['access_token'])"
```

---

## 下一步

配置好服务器后，继续学习：
- [企业微信机器人 API 参考](../../references/wecom_bot_api.md)
- [意图解析器配置]（修改 `wecom_webhook_server.py` 中的 `intent_keywords` 字典）
- [会话持久化]（将 `self.sessions` 替换为文件或数据库存储）

如有问题，发送邮件至：**[email protected]**

references/wecom_bot_api.md

# 企业微信智能机器人 API 参考

本文档汇总了企业微信智能机器人与语音消息相关的 API 能力，供开发者快速查阅。

---

## 一、智能机器人概述

当用户向智能机器人发送消息时，企业微信后台会向开发者配置的回调 URL 推送事件。开发者可以：

1. 接收消息回调
2. 被动回复消息（同步）
3. 流式回复消息（同步更新内容）
4. 主动发送消息（异步）

**官方文档**：https://developer.work.weixin.qq.com/document/path/101039

---

## 二、语音消息回调

当用户在单聊中向机器人发送语音消息时，回调格式如下：

```json
{
    "msgid": "CAIQrcjMjQYY/NGagIOAgAMg6PDc/w0=",
    "aibotid": "AIBOTID",
    "chattype": "single",
    "from": {"userid": "USERID"},
    "response_url": "RESPONSEURL",
    "msgtype": "voice",
    "voice": {
        "content": "这是语音转写后的文本内容"
    }
}
```

**核心要点**：企业微信已内置语音转文字功能，回调中的 `voice.content` 字段直接包含转写文本。**开发者无需自行接入 ASR 服务**。

---

## 三、消息类型支持

| 消息类型 | 接收 | 发送 | 说明 |
|---------|------|------|------|
| 文本消息 | ✅ | ✅ | 最常用 |
| 图片消息 | ✅ | ✅ | 临时素材 |
| 语音消息 | ✅ | ✅ | 接收时已转写为文字 |
| 视频消息 | ✅ | ✅ | 最大 100MB |
| 文件消息 | ✅ | ✅ | 最大 100MB |
| 图文混排 | ✅ | ❌ | 仅接收，群聊或单聊 |
| 模板卡片 | ❌ | ✅ | 富文本交互，被动回复 |

---

## 四、回复消息格式

### 4.1 被动回复（文本）

```json
{
    "msgtype": "text",
    "text": {
        "content": "这是回复内容"
    }
}
```

### 4.2 被动回复（语音）

需要先上传语音素材获取 media_id：

```json
{
    "msgtype": "voice",
    "voice": {
        "media_id": "上传后获得的media_id"
    }
}
```

### 4.3 流式回复

适合长文本生成场景，通过 `response_url` 分批次推送：

```json
{
    "msgtype": "stream",
    "stream": {
        "id": "STREAM_ID",
        "finish": false,
        "content": "..."
    }
}
```

---

## 五、安全机制

### 5.1 加密方式

- 所有回调消息使用 AES-256-CBC 加密
- IV 向量为 AESKey 前 16 字节
- 数据采用 PKCS#7 填充

### 5.2 权限要求

- 需要配置回调 URL、Token、EncodingAESKey
- 所有通信必须使用 HTTPS

### 5.3 安全限制

- 回调 URL 必须能处理 GET（验证）和 POST（回调）请求
- 每次回调的 msgid 需用于去重
- response_url 在消息接收后 48 小时内有效

---

## 六、频率限制

| 操作 | 限制 | 说明 |
|------|------|------|
| 被动回复 | 不限制 | 推荐用于实时交互 |
| API 调用 | 20次/分钟 | 主动调用企业微信 API |
| 主动发送 | 20次/分钟 | 异步发送消息 |
| 流式刷新 | 最长6分钟 | 用户发消息后 |
| 并发交互 | 3条/用户 | 同一用户同时消息数 |

---

## 七、关键注意事项

1. **语音转写由企业微信官方处理**，开发者无法控制 ASR 引擎选择
2. **语音消息仅限单聊**（`chattype: single`），群聊暂不支持语音
3. **response_url 有效期**：被动回复的 response_url 仅 48 小时内有效
4. **临时素材有效期**：上传的媒体文件（语音、图片）3 天后失效，需重新上传
5. **流式消息需主动结束**：发送 `finish: true` 结束流式消息

---

## 八、开发环境搭建

### 8.1 配置智能机器人

1. 登录企业微信管理后台
2. 应用管理 → 创建应用 → 配置智能机器人
3. 设置回调 URL/Token/EncodingAESKey
4. 开通接收消息权限

### 8.2 本地测试

使用内网穿透工具暴露本地服务（如 frp）：

```bash
frpc http -l 8080 -p your-domain.com
```

### 8.3 验证回调

企业微信发送 GET 请求验证 URL：

```
GET /callback?msg_signature=xxx&timestamp=xxx&nonce=xxx&echostr=xxx
```

返回解密后的 echostr 原文即可通过验证。

---

## 九、错误码参考

| 错误码 | 含义 | 处理建议 |
|-------|------|---------|
| 0 | 成功 | - |
| 40001 | 不合法的 secret | 检查应用凭证 |
| 40003 | 不合法的 UserID | 检查用户身份 |
| 40014 | 不合法的 access_token | 刷新 token |
| 60020 | 网络连接异常 | 检查企业微信服务器网络 |
| 84014 | 频率超限 | 降低发送频率，使用队列 |
| 45009 | 接口调用超过限制 | 实现退避重试机制 |

**完整错误码**：https://developer.work.weixin.qq.com/document/path/90313

Github ReposUpdated 10h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.