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 kompatibel OpenAI, TTS BytePlus Seed Speech |
Memulai
Tetapkan kunci API
Jalankan orientasi interaktif:
openclaw onboard --auth-choice volcengine-api-keyIni mendaftarkan penyedia umum (volcengine) dan pengodean (volcengine-plan) dari satu kunci API.
Tetapkan model default
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Pastikan model tersedia
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
Umum (volcengine)
| Referensi model | Nama | Input | 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 |
Pengodean (volcengine-plan)
| Referensi model | Nama | Input | Konteks |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | teks | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | 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, }, }, }, },}Bidang yang tersedia di bawah messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey, dan baseUrl. !emotion=<value> juga berfungsi sebagai direktif suara sebaris ketika penggantian pengaturan suara diizinkan.
Untuk target catatan suara, OpenClaw meminta ogg_opus native 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 bidang konfigurasi messages.tts.providers.volcengine yang sesuai ketika ditetapkan.
Konfigurasi lanjutan
Model default setelah orientasi
openclaw onboard --auth-choice volcengine-api-key menetapkan volcengine-plan/ark-code-latest sebagai model default sekaligus mendaftarkan katalog umum volcengine.
Perilaku fallback pemilih model
Selama pemilihan model dalam orientasi/konfigurasi, pilihan autentikasi Volcengine memprioritaskan baris volcengine/* dan volcengine-plan/*. Jika model tersebut belum dimuat, OpenClaw melakukan fallback ke katalog tanpa filter alih-alih menampilkan pemilih yang tercakup pada penyedia tetapi kosong.
Variabel lingkungan untuk proses daemon
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).
