Gradium

Gradium은 OpenClaw용 텍스트 음성 변환 제공업체입니다. 표준 오디오 응답(WAV), 음성 메모와 호환되는 Opus 출력, 전화 통신 인터페이스용 8 kHz u-law 오디오를 렌더링합니다.

Plugin 설치

Gradium은 공식 외부 Plugin입니다. 설치한 후 Gateway를 다시 시작하십시오.

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

설정

Gradium API 키를 생성한 후 환경 변수 또는 구성 키로 제공하십시오. 구성 값이 환경 변수보다 우선합니다.

export GRADIUM_API_KEY="gsk_..."

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

구성

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

출력 형식은 대상 인터페이스에 따라 자동으로 선택되며(출력 참조), openclaw.json에서 구성할 수 없습니다.

음성

메시지별 음성 재정의

활성 음성 정책에서 음성 재정의를 허용하는 경우 지시어 토큰을 사용하여 인라인으로 음성을 전환할 수 있습니다(다음 토큰은 모두 동일하며 제공업체 네이티브 음성 ID를 받습니다).

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

음성 정책에서 음성 재정의를 비활성화하면 지시어가 소비되지만 무시됩니다.

출력

출력 형식은 대상 인터페이스에 따라 선택되며, 제공업체는 다른 형식을 합성하지 않습니다.

자동 선택 순서

구성된 TTS 제공업체 중 Gradium의 자동 선택 순서는 30입니다. messages.tts.provider가 고정되지 않았을 때 OpenClaw가 활성 제공업체를 선택하는 방법은 텍스트 음성 변환을 참조하십시오.

관련 문서

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