Providers
Volcengine (Doubao)
Penyedia Volcengine memberikan akses ke model Doubao dan model pihak ketiga yang dihosting di Volcano Engine, dengan endpoint terpisah untuk beban kerja umum dan pengodean. Plugin bawaan yang sama juga mendaftarkan Volcengine Speech sebagai penyedia TTS.
| Detail | Nilai |
|---|---|
| Penyedia | volcengine (umum + TTS), volcengine-plan (pengodean) |
| Autentikasi model | VOLCANO_ENGINE_API_KEY |
| Autentikasi TTS | VOLCENGINE_TTS_API_KEY atau BYTEPLUS_SEED_SPEECH_API_KEY |
| API | Model yang kompatibel dengan OpenAI, TTS BytePlus Seed Speech |
Memulai
Set the API key
Jalankan orientasi interaktif:
openclaw onboard --auth-choice volcengine-api-keyIni mendaftarkan penyedia umum (volcengine) dan pengodean (volcengine-plan) dari satu kunci API.
Set a default model
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Verify the model is available
openclaw models list --provider volcengineopenclaw models list --provider volcengine-planPenyedia dan endpoint
| Penyedia | Endpoint | Kasus penggunaan |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Model umum |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Model pengodean |
Katalog bawaan
General (volcengine)
| Referensi model | Nama | Masukan | Konteks |
|---|---|---|---|
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | teks, gambar | 128,000 |
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | teks, gambar | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | teks, gambar | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | teks, gambar | 200,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | teks, gambar | 256,000 |
Coding (volcengine-plan)
| Referensi model | Nama | Masukan | Konteks |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | teks | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | teks | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | teks | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | teks | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | teks | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | teks | 256,000 |
Kedua katalog bersifat statis (tanpa panggilan penemuan /models) dan mendukung penghitungan penggunaan streaming yang kompatibel dengan OpenAI. Skema alat untuk kedua penyedia secara otomatis menghapus kata kunci minLength, maxLength, minItems, maxItems, minContains, dan maxContains, karena API pemanggilan alat Volcengine menolaknya.
Teks ke ucapan
TTS Volcengine menggunakan API HTTP BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) dan dikonfigurasi secara terpisah dari kunci API model Doubao yang kompatibel dengan OpenAI. Di konsol BytePlus, buka Seed Speech > Settings > API Keys, salin kunci API, lalu tetapkan:
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"Kemudian aktifkan di openclaw.json:
{ messages: { tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "byteplus_seed_speech_api_key", voice: "en_female_anna_mars_bigtts", speedRatio: 1.0, }, }, }, },}Kolom yang tersedia di bawah messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey, dan baseUrl. !emotion=<value> juga dapat digunakan sebagai arahan suara sebaris ketika penggantian pengaturan suara diizinkan.
Untuk target pesan suara, OpenClaw meminta ogg_opus asli penyedia. Untuk lampiran audio biasa, OpenClaw meminta mp3. Alias penyedia bytedance dan doubao juga mengarah ke penyedia ucapan ini.
ID sumber daya default adalah seed-tts-1.0, yaitu hak akses yang diberikan BytePlus secara default kepada kunci API Seed Speech yang baru dibuat. Jika proyek Anda memiliki hak akses TTS 2.0, tetapkan VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
Autentikasi AppID/token lama tetap didukung untuk aplikasi Speech Console yang lebih lama:
export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"Variabel lingkungan TTS opsional lainnya: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY, dan VOLCENGINE_TTS_BASE_URL menggantikan kolom konfigurasi messages.tts.providers.volcengine yang bersesuaian ketika ditetapkan.
Konfigurasi lanjutan
Default model after onboarding
openclaw onboard --auth-choice volcengine-api-key menetapkan volcengine-plan/ark-code-latest sebagai model default sekaligus mendaftarkan katalog umum volcengine.
Model picker fallback behavior
Selama pemilihan model dalam orientasi/konfigurasi, pilihan autentikasi Volcengine memprioritaskan baris volcengine/* dan volcengine-plan/*. Jika model tersebut belum dimuat, OpenClaw beralih ke katalog tanpa filter, alih-alih menampilkan pemilih yang dibatasi untuk penyedia tetapi kosong.
Environment variables for daemon processes
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan variabel lingkungan model dan TTS seperti VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID, dan VOLCENGINE_TTS_TOKEN tersedia bagi proses tersebut (misalnya, di ~/.openclaw/.env atau melalui env.shellEnv).
