Communityコーディング&開発github.com

sag

ElevenLabsのテキスト読み上げをmacOSスタイルのsayコマンド風に操作できるCLIツール。

sag とは?

sagは、ElevenLabsの高品質テキスト読み上げ(TTS)エンジンを、macOSの`say`コマンドに似たシンプルなUXで利用できるCLIツールです。APIキーを設定するだけで、ターミナルから直接音声ファイルを生成したり、リアルタイム再生したりできます。複数のモデルをサポートしており、表現力豊かな`eleven_v3`、安定した`eleven_multilingual_v2`、高速な`eleven_flash_v2_5`などが選べます。発音や話し方の制御も可能で、v3モデルでは`[whispers]`や`[shouts]`といったオーディオタグを使って自然な抑揚を追加できます。AIアシスタント(例:Claude Code、Cursorなど)と組み合わせて、ボイス応答機能を実装するのにも最適です。APIキーは環境変数`ELEVENLABS_API_KEY`または`SAG_API_KEY`で設定可能。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawdbot/clawdbot/tree/main/skills/sag

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

sag は何をしますか?

sagはElevenLabsのテキスト読み上げ(TTS)をローカル再生できるCLIツールです。

APIキー(必須)

  • ELEVENLABS_API_KEY(推奨)
  • SAG_API_KEYもCLIでサポート
  • キーファイル:--api-key-file、ELEVENLABS_API_KEY_FILE、またはSAG_API_KEY_FILE

クイックスタート

  • sag "こんにちは"
  • sag speak -v "Roger" "こんにちは"
  • sag voices
  • sag prompting(モデル別のヒント)

モデルに関する注意

  • デフォルト:eleven_v3(表現豊か)
  • 安定:eleven_multilingual_v2
  • 高速:eleven_flash_v2_5

発音と読み上げのルール

  • まずはスペルの調整を(例:"key-note"のようにハイフンや大文字小文字で区切る)。
  • 数字・単位・URL:--normalize auto(名前が壊れる場合はoff)。
  • 言語バイアス:--lang en|de|fr|...でノーマライゼーションを誘導。
  • v3:SSML <break>非対応。代わりに[pause]、[short pause]、[long pause]を使用。
  • v2/v2.5:SSML <break time="1.5s" />対応。<phoneme>はsagでは未公開。

v3のオーディオタグ(行頭に配置)

  • [whispers]、[shouts]、[sings]
  • [laughs]、[starts laughing]、[sighs]、[exhales]
  • [sarcastic]、[curious]、[excited]、[crying]、[mischievously]
  • 例:sag "[whispers] これは内緒だよ。[short pause] いいね?"

音声のデフォルト設定

  • ELEVENLABS_VOICE_IDまたはSAG_VOICE_ID

長文を出力する前に音声と話者を確認してください。

チャットボイス応答

ユーザーが「声で返して」とリクエストした場合(例:「変な科学者の声で」「声で説明して」)、音声を生成して返信します:

# 音声ファイルを生成
sag -v Clawd -o /tmp/voice-reply.mp3 "メッセージ"

# 返信に含める:
# MEDIA:/tmp/voice-reply.mp3

音声キャラクターのヒント:

  • 変な科学者:[excited]タグを使い、ドラマチックな間[short pause]を入れ、強弱を変える。
  • 落ち着いた:[whispers]を使うか、ペースを遅く。
  • ドラマチック:[sings]や[shouts]を控えめに使う。

Clawdのデフォルト音声ID:lj2rcrvANS3gaWWnczSX(または単に-v Clawd)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

1password

Set up and use 1Password CLI for sign-in, desktop integration, and reading or injecting secrets.

acp-router

Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Grok Build, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation. Codex chat binding defaults to the native Codex app-server plugin unless ACP is explicit or background spawn needs ACP.

add-model-provider

Add and live-prove a model provider with non-interactive config one-liners, without exposing credentials.

agent-transcript

Requested GitHub PR/issue agent transcripts: redact, trim, preview, and insert safely.

apple-notes

Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS.

apple-reminders

List, add, edit, complete, or delete Apple Reminders and reminder lists via remindctl.

auto-qa

Run OpenClaw-wide autonomous QA and live/stress campaigns across independent subsystem lanes, with verified fixes and a resumable evidence report.

autoreview

Structured code review through the shared OpenClaw agent-skills installation.

bear-notes

Create, search, and manage Bear notes via grizzly CLI.

blacksmith-testbox

Run Blacksmith Testbox for CI-parity checks, secrets, hosted services, migrations, or builds local cannot reproduce.

block-kit

Use proactively for structured or interactive Slack replies, and when asked to author or validate native Slack Block Kit JSON.

blogwatcher

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

browser-automation

Use when controlling web pages with the OpenClaw browser tool, especially multi-step flows, login checks, tab management, or recovery from stale refs/timeouts.

camsnap

Capture frames or clips from RTSP/ONVIF cameras and local webcams, including USB pan/tilt/zoom control.

canvas

Present HTML on connected OpenClaw node canvases, navigate/eval/snapshot, and debug canvas host URLs.

channel-message-flows

Use when running QA Lab channel message flow evidence.

clawdtributor

Clawtributor PRs here, last week or another window: discover conversation refs, recheck GitHub, rank by impact.

clawhub

Search ClawHub for plugins by default, or skills when explicitly requested; install, verify, update, uninstall, publish, or sync skills.

関連スキル