Gradium

Gradium은 OpenClaw에 번들로 제공되는 텍스트 음성 변환 제공자입니다. 이 Plugin은 일반 오디오 응답(WAV), 음성 메모 호환 Opus 출력, 전화 통신 표면용 8 kHz u-law 오디오를 렌더링할 수 있습니다.

설정

Gradium API 키를 만든 다음, env var 또는 config 키를 사용해 OpenClaw에 노출하세요.

export GRADIUM_API_KEY="gsk_..."

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          apiKey: "${GRADIUM_API_KEY}",        },      },    },  },}

이 Plugin은 먼저 해석된 apiKey를 확인하고, 없으면 GRADIUM_API_KEY 환경 변수로 대체합니다.

구성

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          voiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}

출력 오디오 형식은 대상 표면을 기준으로 런타임이 자동으로 선택하며, openclaw.json에서 구성할 수 없습니다. 아래 출력을 참조하세요.

음성

기본 음성: Emma.

메시지별 음성 재정의

활성 음성 정책이 음성 재정의를 허용하면 directive token을 사용해 인라인으로 음성을 전환할 수 있습니다. 다음은 모두 동일한 voiceId 재정의로 해석됩니다.

/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

음성 정책이 음성 재정의를 비활성화하면 directive는 소비되지만 무시됩니다.

출력

런타임은 대상 표면에서 출력 형식을 선택합니다. 현재 제공자는 다른 형식을 합성하지 않습니다.

자동 선택 순서

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

관련 항목

• 텍스트 음성 변환
• 미디어 개요