Gradium Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Gradium
개요
이 페이지는 OpenClaw Gradium provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Use Gradium text-to-speech in OpenClaw
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
빠른 참조
| Property | Value |
|---|---|
| Provider id | gradium |
| Auth | GRADIUM_API_KEY or config apiKey |
| Base URL | https://api.gradium.ai (default) |
| Default voice | Emma (YTpq7expH9539ERJ) |
공식 문서 기반 상세
아래는 공식 providers/gradium 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Gradium is a text-to-speech provider for OpenClaw. It renders standard audio replies (WAV), voice-note-compatible Opus output, and 8 kHz u-law audio for telephony surfaces.
| Property | Value |
|---|---|
| Provider id | gradium |
| Auth | GRADIUM_API_KEY or config apiKey |
| Base URL | https://api.gradium.ai (default) |
| Default voice | Emma (YTpq7expH9539ERJ) |
Install plugin
Gradium is an official external plugin. Install it, then restart Gateway:
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart
설정
Create a Gradium API key, then expose it with an env var or the config key. Config takes precedence over the env var.
```bash
export GRADIUM_API_KEY="gsk_..."
```
```json5
{
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
apiKey: "${GRADIUM_API_KEY}",
},
},
},
}
```
Config
{
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
speakerVoiceId: "YTpq7expH9539ERJ",
// apiKey: "${GRADIUM_API_KEY}",
// baseUrl: "https://api.gradium.ai",
},
},
},
}
| Key | Type | Description |
|---|---|---|
tts.providers.gradium.apiKey |
string | Resolved API key. Supports ${ENV} and secret refs. |
tts.providers.gradium.baseUrl |
string | HTTPS Gradium API URL on api.gradium.ai. Trailing slashes stripped. Default https://api.gradium.ai. |
tts.providers.gradium.speakerVoiceId |
string | Default voice id used when no directive override is present. |
Output format is chosen automatically by target surface (see Output) and is not configurable in openclaw.json.
Voices
| Name | Voice ID |
|---|---|
| Arthur | 3jUdJyOi9pgbxBTK |
| Christina | 2H4HY2CBNyJHBCrP |
| Emma (default) | YTpq7expH9539ERJ |
| John | KWJiFWu2O9nMPYcR |
| Kent | LFZvm12tW_z0xfGo |
| Sydney | jtEKaLYNn6iif5PR |
| Tiffany | Eu9iL_CYe8N-Gkx_ |
Per-message voice override
When the active speech policy allows voice overrides, switch voices inline with a directive token (any of these are equivalent, all take a provider-native voice id):
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
If the speech policy disables voice overrides, the directive is consumed but ignored.
Output
Output format is selected by target surface; the provider does not synthesize other formats.
| Target | Format | File ext | Sample rate | Voice-compatible flag |
|---|---|---|---|---|
| Standard audio | wav |
.wav |
provider | no |
| Voice note | opus |
.opus |
provider | yes |
| Telephony | ulaw_8000 |
n/a | 8 kHz | n/a |
Auto-select order
Among configured TTS providers, Gradium's auto-select order is 30. See Text-to-Speech for how OpenClaw picks the active provider when tts.provider is not pinned.
관련 문서
검증 체크리스트
-
openclaw models list --provider gradium로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토