Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Provider Volcengine memberikan akses ke model Doubao dan model pihak ketiga yang di-host di Volcano Engine, dengan endpoint terpisah untuk beban kerja umum dan coding. Plugin bawaan yang sama juga dapat mendaftarkan Volcengine Speech sebagai provider TTS.
DetailNilai
Providervolcengine (umum + TTS) + volcengine-plan (coding)
Auth modelVOLCANO_ENGINE_API_KEY
Auth TTSVOLCENGINE_TTS_API_KEY atau BYTEPLUS_SEED_SPEECH_API_KEY
APIModel kompatibel OpenAI, BytePlus Seed Speech TTS

​
Memulai

1

Atur API key

Jalankan onboarding interaktif:
openclaw onboard --auth-choice volcengine-api-key
Ini mendaftarkan provider umum (volcengine) dan coding (volcengine-plan) dari satu API key.
2

Atur model default

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Verifikasi model tersedia

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Untuk penyiapan non-interaktif (CI, scripting), berikan key secara langsung:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Provider dan endpoint

ProviderEndpointKasus penggunaan
volcengineark.cn-beijing.volces.com/api/v3Model umum
volcengine-planark.cn-beijing.volces.com/api/coding/v3Model coding
Kedua provider dikonfigurasi dari satu API key. Setup mendaftarkan keduanya secara otomatis.

​
Katalog bawaan

Referensi modelNamaInputKonteks
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000

​
Text-to-speech

Volcengine TTS menggunakan API HTTP BytePlus Seed Speech dan dikonfigurasi secara terpisah dari API key model Doubao yang kompatibel dengan OpenAI. Di konsol BytePlus, buka Seed Speech > Settings > API Keys dan salin API key, lalu atur: 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
Lalu 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,
        },
      },
    },
  },
}
Untuk target voice-note, OpenClaw meminta ogg_opus native provider dari Volcengine. Untuk lampiran audio normal, OpenClaw meminta mp3. Alias provider bytedance dan doubao juga di-resolve ke provider speech yang sama. ID resource default adalah seed-tts-1.0 karena itulah yang diberikan BytePlus kepada API key Seed Speech yang baru dibuat dalam proyek default. Jika proyek Anda memiliki entitlement TTS 2.0, atur VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY digunakan untuk endpoint model ModelArk/Doubao dan bukan API key Seed Speech. TTS memerlukan API key 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: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
Konfigurasi lanjutan

openclaw onboard --auth-choice volcengine-api-key saat ini menetapkan volcengine-plan/ark-code-latest sebagai model default sambil juga mendaftarkan katalog umum volcengine.
Selama pemilihan model pada onboarding/configure, pilihan auth Volcengine memprioritaskan baris volcengine/* dan volcengine-plan/*. Jika model tersebut belum dimuat, OpenClaw fallback ke katalog yang tidak difilter alih-alih menampilkan picker bercakupan provider yang kosong.
Jika Gateway berjalan sebagai daemon (launchd/systemd), pastikan env var 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 untuk proses tersebut (misalnya, di ~/.openclaw/.env atau melalui env.shellEnv).
Saat menjalankan OpenClaw sebagai layanan background, variabel lingkungan yang diatur di shell interaktif Anda tidak otomatis diwariskan. Lihat catatan daemon di atas.

​
Terkait

Pemilihan model

Memilih provider, referensi model, dan perilaku failover.

Konfigurasi

Referensi config lengkap untuk agen, model, dan provider.

Pemecahan masalah

Masalah umum dan langkah debugging.

FAQ

Pertanyaan umum tentang penyiapan OpenClaw.