飞书语音回复技能

功能

自动将文本转换为飞书原生语音消息并发送，支持波形播放格式。

适用场景

用户希望收到语音回复时
需要更自然的对话体验时
想要发送语音通知时

核心组件

1. Edge TTS 语音生成

使用微软 Edge Neural TTS 引擎
支持多种声音（xiaoxiao, xiaoyi, yunyang 等）
完全免费，无需 API Key
安全：只使用官方 API，不访问外部服务器

2. 飞书语音发送

使用 OpenClaw 内置消息工具
飞书原生语音格式（msg_type: audio）
支持私聊和群聊
波形播放显示
安全：不依赖未声明的凭据

安全特性

✅ 已修复的安全问题

不修改全局文件
- 所有文件操作都在技能目录内
- 不修改系统文件或配置
不创建持久规则
- 语音回复规则内置在 SKILL.md 中
- 会话启动时自动读取，无需外部文件
使用公开 API
- 使用 OpenClaw 内置 message 工具
- 通过 OpenClaw Gateway 安全发送
- 不依赖未声明的本地 API 服务
清晰的依赖说明
- edge-tts：Python 包，官方 PyPI 源
- OpenClaw 消息工具：内置功能
- 无需额外的 API 密钥或服务

安装

前置要求

# 安装 Python Edge TTS（使用官方 PyPI）
pip3 install edge-tts

# 或使用国内镜像加速
pip3 install edge-tts -i https://pypi.tuna.tsinghua.edu.cn/simple

安装技能

# 使用 ClawHub 安装
clawhub install feishu-voice-reply

# 或手动安装
mkdir -p ~/.openclaw/workspace/skills/feishu-voice-reply
# 复制 SKILL.md 和相关文件到该目录

使用方法

方法 1：自动检测（推荐）

当用户消息包含语音相关关键词时，自动触发：

# 触发关键词示例
- "用语音回复"
- "发语音给我"
- "语音说"
- "念给我听"

方法 2：使用命令行

# 生成语音
cd /root/.openclaw/workspace/skills/feishu-voice-reply
python3 edge_tts_async.py "你好，世界！" xiaoxiao voice.mp3

方法 3：通过 OpenClaw 消息工具

使用 OpenClaw 内置的 message 工具发送语音：

# OpenClaw 会自动处理飞书 API 调用
message(
    action="send",
    channel="feishu",
    filePath="/path/to/voice.mp3"
)

支持的声音

声音	性别	特点	推荐场景
xiaoxiao	女	活泼专业	⭐⭐⭐⭐⭐ 通用
xiaoyi	女	温柔亲切	⭐⭐⭐⭐ 情感类
yunyang	男	沉稳	⭐⭐⭐⭐ 正式
yunxi	男	北京话	⭐⭐⭐ 幽默
yunze	男	活力	⭐⭐⭐ 年轻

语音回复规则（内置）

规则位置：本文件（SKILL.md）

核心规则：

语音发送后，绝对不做任何回复操作！

禁止行为（零容忍）：

语音发送后，不要发送任何文字消息
不要说"已发送语音"、"语音已发送"等
不要说"遵守规则"、"记住了"等
不要加任何表情符号（😄、✅等）
语音发送后，立即彻底停止

唯一例外：只有语音生成失败时，才可以用文字说明

工作流

用户消息 → 触发关键词检测
    ↓
文本内容提取
    ↓
Edge TTS 生成语音（2-5秒）
    ↓
使用 OpenClaw 消息工具发送
    ↓
✅ 完成（绝对静默）

文件结构

skills/feishu-voice-reply/
├── SKILL.md              # 本文件
├── README.md             # 说明文档
├── INSTALL.sh            # 安装脚本
└── edge_tts_async.py     # Edge TTS 异步生成脚本

注意：

所有文件都在技能目录内
不修改系统文件或配置
不创建外部持久文件

性能指标

语音生成速度：3-5 秒（100 字）
音频质量：高（微软 Neural）
文件大小：20-30 KB（每 100 字）
成本：完全免费

依赖项

必需依赖

Python 3.7+
edge-tts（Python 包，官方 PyPI）
```
pip3 install edge-tts
```

可选依赖

OpenClaw 消息工具
- OpenClaw 内置功能
- 用于发送语音消息到飞书

故障排查

语音生成失败

# 检查 edge-tts 安装
pip3 show edge-tts

# 测试语音生成
python3 -c "import edge_tts; print('OK')"

# 重新安装
pip3 install edge-tts -i https://pypi.tuna.tsinghua.edu.cn/simple

语音发送失败

检查 OpenClaw Gateway：

# 检查 Gateway 状态
systemctl status openclaw-gateway

# 查看 Gateway 日志
journalctl -u openclaw-gateway -f

检查飞书连接：

确保 OpenClaw 已配置飞书凭据
检查飞书机器人权限

更新日志

v1.0.1 (2026-03-11)

🔒 安全修复
- 移除全局文件修改
- 移除持久规则文件
- 使用 OpenClaw 内置消息工具
- 添加安全说明文档
- 声明所有依赖和 API 使用

v1.0.0 (2026-03-11)

初始版本
支持 Edge TTS 语音生成
支持飞书语音消息发送
添加 5 种中文声音

许可证

MIT License

贡献

欢迎提交问题和改进建议！

feishu-voice-reply

Safety Notice