名称： kokoro-tts
描述： 使用本地 Kokoro TTS 引擎将文本转换为语音。当用户要求“说出”某些内容、请求语音消息或需要将文本转为语音时使用。

Kokoro TTS

此技能允许您使用本地或远程的 Kokoro-TTS 实例生成高质量的 AI 语音。

配置

本技能通过环境变量 KOKORO_API_URL 来定位 API 地址。

• 默认值： http://localhost:8880/v1/audio/speech
• 配置方法： 在您的 .env 文件或环境中添加 KOKORO_API_URL=http://your-server:port/v1/audio/speech。

使用方法

要生成语音，请运行附带的 Node.js 脚本。

命令

node skills/kokoro-tts/scripts/tts.js "<text>" [voice] [speed]

• text: 要朗读的文本。请用引号包裹。
• voice: (可选) 语音 ID。默认为 af_heart。
• speed: (可选) 语速 (0.25 至 4.0)。默认为 1.0。

示例

node skills/kokoro-tts/scripts/tts.js "你好 Ed，我是 Theosaurus。" af_nova

输出

脚本将输出以 MEDIA: 开头的一行，后跟生成的 MP3 文件路径。OpenClaw 会自动识别此路径，并将其作为音频附件发送。

示例输出：
MEDIA: media/tts_1706745000000.mp3

可用语音

常用选择：
- af_heart (默认，女声，温暖)
- af_nova (女声，专业)
- am_adam (男声，低沉)
- bf_alice (英式女声)

完整列表请参阅 references/voices.md 或直接查询 API。