메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gradium은 OpenClaw에 번들로 제공되는 텍스트 음성 변환 제공자입니다. 이 Plugin은 일반 오디오 응답(WAV), 음성 메모 호환 Opus 출력, 전화 통신 표면용 8 kHz u-law 오디오를 렌더링할 수 있습니다.
속성값
제공자 idgradium
인증GRADIUM_API_KEY 또는 config apiKey
기본 URLhttps://api.gradium.ai (기본값)
기본 음성Emma (YTpq7expH9539ERJ)

​
설정

Gradium API 키를 만든 다음, env var 또는 config 키를 사용해 OpenClaw에 노출하세요. 
export GRADIUM_API_KEY="gsk_..."
이 Plugin은 먼저 해석된 apiKey를 확인하고, 없으면 GRADIUM_API_KEY 환경 변수로 대체합니다.

​
구성

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          voiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
키유형설명
messages.tts.providers.gradium.apiKeystring해석된 API 키입니다. ${ENV} 및 secret refs를 지원합니다.
messages.tts.providers.gradium.baseUrlstringAPI origin을 재정의합니다. 끝의 슬래시는 제거됩니다. 기본값은 https://api.gradium.ai입니다.
messages.tts.providers.gradium.voiceIdstringdirective 재정의가 없을 때 사용되는 기본 음성 id입니다.
출력 오디오 형식은 대상 표면을 기준으로 런타임이 자동으로 선택하며, openclaw.json에서 구성할 수 없습니다. 아래 출력을 참조하세요.

​
음성

이름음성 ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
기본 음성: Emma.

​
메시지별 음성 재정의

활성 음성 정책이 음성 재정의를 허용하면 directive token을 사용해 인라인으로 음성을 전환할 수 있습니다. 다음은 모두 동일한 voiceId 재정의로 해석됩니다. 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
음성 정책이 음성 재정의를 비활성화하면 directive는 소비되지만 무시됩니다.

​
출력

런타임은 대상 표면에서 출력 형식을 선택합니다. 현재 제공자는 다른 형식을 합성하지 않습니다.
대상형식파일 확장자샘플 속도음성 호환 플래그
표준 오디오wav.wav제공자아니요
음성 메모opus.opus제공자예
전화 통신ulaw_8000n/a8 kHzn/a

​
자동 선택 순서

구성된 TTS 제공자 중 Gradium의 자동 선택 순서는 30입니다. messages.tts.provider가 고정되어 있지 않을 때 OpenClaw가 활성 제공자를 선택하는 방식은 텍스트 음성 변환을 참조하세요.

​
관련 항목