Community코딩 & 개발github.com

sag

ElevenLabs 텍스트-음성 변환(TTS)을 맥 스타일의 say UX로 제공합니다.

sag란 무엇인가요?

sag는 ElevenLabs의 고품질 텍스트-음성 변환(TTS)을 명령줄에서 간편하게 사용할 수 있는 도구입니다. 맥의 `say` 명령어와 유사한 사용자 경험을 제공하며, API 키만 설정하면 누구나 쉽게 음성을 생성할 수 있습니다. 다양한 모델(v3, v2, v2.5)을 지원하며, 각 모델별로 발음 규칙과 음성 태그(예: [whispers], [shouts])를 제공하여 표현력을 높일 수 있습니다. 주로 개발자와 AI 에이전트(예: Claude Code, Cursor)가 음성 응답을 생성하거나, 스크립트에서 TTS를 자동화하는 데 유용합니다. CLI 도구로 설치가 간단하며, 환경 변수(`ELEVENLABS_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를 로컬 재생과 함께 사용합니다.

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 기본 음성: 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.

관련 스킬