← 返回 Skills 市场
xmx0632

feishu voice reply

作者 xmx0632 · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
348
总下载
1
收藏
3
当前安装
2
版本数
在 OpenClaw 中安装
/install feishu-voice-reply
功能描述
飞书语音消息自动回复技能 - 使用 Edge TTS 生成语音并通过飞书 API 发送
使用说明 (SKILL.md)

飞书语音回复技能

功能

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

适用场景

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

核心组件

1. Edge TTS 语音生成

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

2. 飞书语音发送

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

安全特性

✅ 已修复的安全问题

  1. 不修改全局文件

    • 所有文件操作都在技能目录内
    • 不修改系统文件或配置
  2. 不创建持久规则

    • 语音回复规则内置在 SKILL.md 中
    • 会话启动时自动读取,无需外部文件
  3. 使用公开 API

    • 使用 OpenClaw 内置 message 工具
    • 通过 OpenClaw Gateway 安全发送
    • 不依赖未声明的本地 API 服务
  4. 清晰的依赖说明

    • 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)

核心规则

语音发送后,绝对不做任何回复操作!

禁止行为(零容忍):

  1. 语音发送后,不要发送任何文字消息
  2. 不要说"已发送语音"、"语音已发送"等
  3. 不要说"遵守规则"、"记住了"等
  4. 不要加任何表情符号(😄、✅等)
  5. 语音发送后,立即彻底停止

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

工作流

用户消息 → 触发关键词检测
    ↓
文本内容提取
    ↓
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 已配置飞书凭据
  • 检查飞书机器人权限

相关技能

  • feishu-bot - 飞书 Bot 基础功能
  • feishu-file - 飞书文件发送
  • edge-tts - Edge TTS 语音生成

更新日志

v1.0.1 (2026-03-11)

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

v1.0.0 (2026-03-11)

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

许可证

MIT License

贡献

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

安全使用建议
This skill appears to do what it says (use edge-tts to create audio and hand off files to OpenClaw for delivery to Feishu), but check a few things before installing: 1) Privacy: edge-tts performs TTS by contacting Microsoft services — any input text will be sent to Microsoft; if that is sensitive, avoid use. 2) File persistence: the script writes audio files to disk; verify where files are written and whether they are removed if you expect no persistence. 3) Gateway/permissions: the skill expects OpenClaw Gateway to hold Feishu credentials — confirm those credentials are properly scoped and stored by OpenClaw, not by this skill. 4) Inconsistencies: SKILL.md/SECURITY.md contain contradictory claims about external network access and data storage; if you rely on those guarantees, request clarification from the author or inspect runtime network traffic. 5) Run in a sandbox first: install and run the script in a controlled environment to observe network activity and file output before enabling it in production.
功能分析
Type: OpenClaw Skill Name: feishu-voice-reply Version: 1.0.1 The skill provides a legitimate text-to-speech (TTS) service for Feishu using the open-source edge-tts library. The Python code (edge_tts_async.py) and installation script (INSTALL.sh) are straightforward, performing only the stated tasks without any evidence of data exfiltration, obfuscation, or unauthorized system modifications. The instructions in SKILL.md include behavioral constraints for the AI agent to remain silent after sending audio, which aligns with the intended user experience for a voice-reply tool.
能力评估
Purpose & Capability
Name/description match included files: edge_tts_async.py implements TTS using edge-tts and INSTALL.sh installs it. Requiring edge-tts is proportionate. The skill relies on OpenClaw's message tool to deliver audio to Feishu; that dependency is expected. No unrelated credentials or odd binaries are requested.
Instruction Scope
SKILL.md and SECURITY.md contain contradictory statements: one place says '不访问外部服务器' (does not access external servers) while other places acknowledge edge-tts connects to Microsoft Edge API. Troubleshooting steps reference systemctl/journalctl for an OpenClaw Gateway (system-level operations). The agent instructions allow creation of audio files in the skill workspace (and the command examples accept arbitrary file paths), so generated audio can persist if not removed — contradicting claims that files are not stored. These are scope/behavior inconsistencies the user should be aware of.
Install Mechanism
No remote arbitrary downloads or obscure installers. INSTALL.sh uses pip to install edge-tts (PyPI or a well-known mirror). The skill is instruction-first and installs a standard Python package; risk from install mechanism is low.
Credentials
The skill declares no environment variables or credentials. It expects OpenClaw Gateway to already hold Feishu credentials (external to the skill). That is reasonable, but the SKILL.md's privacy wording understates that user text is sent to Microsoft via edge-tts for TTS (so text leaves the host). No additional unrelated secrets are requested by the skill itself.
Persistence & Privilege
always:false and user-invocable:true (no forced permanent inclusion). The skill does not modify other skills or global system configuration in the provided files. INSTALL.sh and the script operate within the skill directory by default.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-voice-reply
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-voice-reply 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
v1.0.1 (2026-03-11) — Security and dependency structure overhaul - 移除了全局和持久化规则文件操作,所有文件仅限于技能目录内 - 语音回复规则内置于 SKILL.md,无需外部 .voice-reply-rules.txt - 发送语音消息全面切换为 OpenClaw 内置消息工具,不再直接依赖本地 API 服务 - 删除多余的发布/文档/脚本文件,简化目录结构 - 增加和完善依赖声明与安全说明(新添加 SECURITY.md)
v1.0.0
feishu-voice-reply v1.0.0 - 首发版本 - 支持文本转语音(Edge TTS: xiaoxiao, xiaoyi, yunyang, yunxi, yunze) - 支持通过飞书 Bot API 发送原生语音消息(私聊和群聊) - 自动检测语音关键词,可通过多种方式触发语音回复 - 严格执行“语音后不做任何回复”的核心规则
元数据
Slug feishu-voice-reply
版本 1.0.1
许可证 MIT-0
累计安装 3
当前安装数 3
历史版本数 2
常见问题

feishu voice reply 是什么?

飞书语音消息自动回复技能 - 使用 Edge TTS 生成语音并通过飞书 API 发送. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 348 次。

如何安装 feishu voice reply?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-voice-reply」即可一键安装,无需额外配置。

feishu voice reply 是免费的吗?

是的,feishu voice reply 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

feishu voice reply 支持哪些平台?

feishu voice reply 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 feishu voice reply?

由 xmx0632(@xmx0632)开发并维护,当前版本 v1.0.1。

💬 留言讨论