mcpField
S
sag

sag

github.com/openclaw创意与媒体393.3k5.2k 次安装今天更新
代码仓库

关于 sag

sag 是用于生成 ElevenLabs 语音并在本地播放的命令行技能，适合需要语音输出的场景。它提供声音选择、发音调整和表达性语气标签。

主要功能

  1. 01生成 ElevenLabs 语音
  2. 02本地播放音频
  3. 03选择和列出声音
  4. 04发音与语言控制
  5. 05表达性语音标签

适用场景

  1. 01将文本转换为语音回复
  2. 02为较长内容选择声音
  3. 03调整姓名和数字的发音

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaw/openclaw --skill sag

安装后在 Claude Code 中输入/sag确认已加载。

详细介绍

sag

使用 sag 调用 ElevenLabs TTS，并在本地播放。

API 密钥（必需）

  • ELEVENLABS_API_KEY（首选）
  • CLI 也支持 SAG_API_KEY
  • 通过 --api-key-file、ELEVENLABS_API_KEY_FILE 或 SAG_API_KEY_FILE 使用密钥文件

快速开始

  • sag "Hello there"
  • sag speak -v "Roger" "Hello"
  • sag voices
  • sag prompting（模型专用提示）

模型说明

  • 默认：eleven_v3（富有表现力）
  • 稳定：eleven_multilingual_v2
  • 快速：eleven_flash_v2_5

发音与表达规则

  • 首先修正：重新拼写（例如“key-note”）、添加连字符、调整大小写。
  • 数字、单位、URL：--normalize auto（若影响姓名，则使用 off）。
  • 语言偏好：使用 --lang en|fr|fr|... 引导规范化处理。
  • v3：不支持 SSML <break>；请使用 [pause]、[short pause]、[long pause]。
  • v2/v2.5：支持 SSML <break time="1.5s" />；但 sag 未提供 <phoneme>。

v3 音频标签（放在行首）

  • [whispers]、[shouts]、[sings]
  • [laughs]、[starts laughing]、[sighs]、[exhales]
  • [sarcastic]、[curious]、[excited]、[crying]、[mischievously]
  • 示例：sag "[whispers] keep this quiet. [short pause] ok?"

默认音色

  • ELEVENLABS_VOICE_ID 或 SAG_VOICE_ID

输出较长内容前，请确认音色和说话者。

聊天语音回复

当用户要求“语音”回复（例如“疯狂科学家声音”“用语音讲解”）时，生成音频并发送：

# Generate audio file
sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"

# Then include in reply:
# MEDIA:/tmp/voice-reply.mp3

音色角色提示：

  • 疯狂科学家：使用 [excited] 标签和戏剧性停顿 [short pause]，并改变情绪强度
  • 平静：使用 [whispers] 或放慢语速
  • 戏剧化：少量使用 [sings] 或 [shouts]

Clawd 的默认音色：lj2rcrvANS3gaWWnczSX（或直接使用 -v Clawd）

评论

支持 Markdown