运行时依赖
安装命令
点击复制技能文档
feishu-voice 使用 NoizAI 云 TTS 将自然流畅的语音消息发送到 Feishu 会话中,无需 API 密钥(guest 模式)。
何时使用 用户要求您 "说"、"语音"、"voice"、"speak"、"read aloud" 您希望以音频而不是文本形式发送回复 用户发送语音消息并期待语音回复
快速使用 调用助手脚本,然后通过消息工具发送:python skills/feishu-voice/scripts/voice.sh "要说的文字" [output.opus] [voice_id] 然后通过消息工具发送输出文件:asVoice: true contentType: audio/opus filePath:
默认语音 语音 ID:b4775100 (悦悦|社交分享, zh, Female, Joyful) 格式:opus(Feishu 语音气泡所需) 后端:NoizAI guest 模式(无需 API 密钥)
可用中文语音(guest 模式) voice_id 名称 性别 音调 b4775100 悦悦|社交分享 F Joyful ← 默认 77e15f2c 婉青|情绪抚慰 F Calm ac09aeb4 阿豪|磁性主持 M Calm 87cb2405 建国|知识科普 M Calm 3b9f1e27 小明|科技达人 M Joyful
步骤工作流 生成音频:python skills/feishu-voice/scripts/voice.sh "你好世界" "/path/to/output.opus" "b4775100" 验证文件存在并有内容(检查大小 > 0) 通过消息工具发送:action: send channel: feishu asVoice: true contentType: audio/opus filePath: <输出路径从步骤 1> 以 NO_REPLY 回复(语音已发送)
重要注意事项 必须使用 opus 格式 — Feishu 需要 opus 来渲染语音气泡 asVoice 必须为 true — 否则它将作为文件附件发送,而不是语音消息 PowerShell stderr:[noiz-guest] 信息消息转到 stderr;PowerShell 将其视为错误。脚本处理此问题 — 检查输出文件是否存在,而不是依赖退出代码 文本长度:保持在 ~200 个字符以内以获得最佳质量;较长的文本可以工作,但可能需要更长时间 无需 API 密钥:guest 模式在 NOIZ_API_KEY 未设置时自动启用
依赖项 此技能需要 noizai-tts 安装:clawhub install noizai-tts clawhub install lubo-feishu-voice Python 3.6+ 和 ffmpeg(仅用于时间线模式)应可用。
故障排除 问题 解决方案 模块未找到 / tts.py 缺失 先运行 clawhub install noizai-tts 文件未生成 检查 Python 是否可用,noizai-tts 技能是否安装 Feishu 显示文件而不是语音 确保 asVoice: true 和 contentType: audio/opus 语音听起来不正确 尝试从上表中使用不同的 voice_id 文本太长 将其分成多个消息或缩短