Skip to main content
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.

​
Memulai

1

Tetapkan kunci API

Jalankan orientasi interaktif:
Ini mendaftarkan penyedia umum (volcengine) dan pengodean (volcengine-plan) dari satu kunci API.
2

Tetapkan model default

3

Pastikan model tersedia

Untuk penyiapan noninteraktif (CI, pembuatan skrip), berikan kunci secara langsung:

​
Penyedia dan endpoint

Kedua penyedia dikonfigurasi dari satu kunci API. Penyiapan mendaftarkan keduanya secara otomatis, dan pemilih model penyedia pengodean juga menggunakan kembali autentikasi penyedia umum (volcengine-plan adalah alias autentikasi dari volcengine).

​
Katalog bawaan

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:
Kemudian aktifkan di openclaw.json:
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.
VOLCANO_ENGINE_API_KEY ditujukan untuk endpoint model ModelArk/Doubao dan bukan kunci API Seed Speech. TTS memerlukan kunci API Seed Speech dari BytePlus Speech Console, atau pasangan AppID/token Speech Console lama.
Autentikasi AppID/token lama tetap didukung untuk aplikasi Speech Console yang lebih lama:
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

openclaw onboard --auth-choice volcengine-api-key menetapkan volcengine-plan/ark-code-latest sebagai model default sekaligus mendaftarkan katalog umum volcengine.
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.
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).
Saat menjalankan OpenClaw sebagai layanan latar belakang, variabel lingkungan yang ditetapkan di shell interaktif Anda tidak diwariskan secara otomatis. Lihat catatan daemon di atas.

​
Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

Konfigurasi

Referensi konfigurasi lengkap untuk agen, model, dan penyedia.

Pemecahan masalah

Masalah umum dan langkah-langkah debugging.

FAQ

Pertanyaan umum tentang penyiapan OpenClaw.