Ana içeriğe atla

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.

Volcengine sağlayıcısı, Volcano Engine üzerinde barındırılan Doubao modellerine ve üçüncü taraf modellere erişim sağlar; genel ve kodlama iş yükleri için ayrı uç noktalar sunar. Aynı paketlenmiş Plugin, Volcengine Speech’i TTS sağlayıcısı olarak da kaydedebilir.
AyrıntıDeğer
Sağlayıcılarvolcengine (genel + TTS) + volcengine-plan (kodlama)
Model authVOLCANO_ENGINE_API_KEY
TTS authVOLCENGINE_TTS_API_KEY veya BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI uyumlu modeller, BytePlus Seed Speech TTS

​
Başlarken

1

API anahtarını ayarlayın

Etkileşimli onboarding çalıştırın:
openclaw onboard --auth-choice volcengine-api-key
Bu, tek bir API anahtarından hem genel (volcengine) hem de kodlama (volcengine-plan) sağlayıcılarını kaydeder.
2

Varsayılan model ayarlayın

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Etkileşimsiz kurulum için (CI, betikleme), anahtarı doğrudan geçin:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Sağlayıcılar ve uç noktalar

SağlayıcıUç noktaKullanım durumu
volcengineark.cn-beijing.volces.com/api/v3Genel modeller
volcengine-planark.cn-beijing.volces.com/api/coding/v3Kodlama modelleri
Her iki sağlayıcı da tek bir API anahtarından yapılandırılır. Kurulum her ikisini de otomatik olarak kaydeder.

​
Yerleşik katalog

Model refAdGirdiBağlam
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, BytePlus Seed Speech HTTP API’sini kullanır ve OpenAI uyumlu Doubao model API anahtarından ayrı yapılandırılır. BytePlus konsolunda Seed Speech > Settings > API Keys bölümünü açın, API anahtarını kopyalayın ve sonra şunları ayarlayın: 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
Ardından bunu openclaw.json içinde etkinleştirin: 
{
  messages: {
    tts: {
      auto: "always",
      provider: "volcengine",
      providers: {
        volcengine: {
          apiKey: "byteplus_seed_speech_api_key",
          voice: "en_female_anna_mars_bigtts",
          speedRatio: 1.0,
        },
      },
    },
  },
}
Sesli not hedefleri için OpenClaw, Volcengine’den sağlayıcıya özgü ogg_opus ister. Normal ses ekleri için mp3 ister. Sağlayıcı takma adları bytedance ve doubao da aynı konuşma sağlayıcısına çözülür. Varsayılan kaynak kimliği seed-tts-1.0 değeridir; çünkü BytePlus bunu varsayılan projede yeni oluşturulmuş Seed Speech API anahtarlarına verir. Projenizde TTS 2.0 yetkisi varsa VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 ayarlayın.
VOLCANO_ENGINE_API_KEY, ModelArk/Doubao model uç noktaları içindir ve bir Seed Speech API anahtarı değildir. TTS için BytePlus Speech Console’dan bir Seed Speech API anahtarı veya eski bir Speech Console AppID/token çifti gerekir.
Eski AppID/token auth, daha eski Speech Console uygulamaları için desteklenmeye devam eder: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
Gelişmiş yapılandırma

openclaw onboard --auth-choice volcengine-api-key şu anda genel volcengine kataloğunu da kaydederken varsayılan model olarak volcengine-plan/ark-code-latest ayarlar.
Onboarding/configure model seçimi sırasında Volcengine auth seçeneği, hem volcengine/* hem de volcengine-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmemişse OpenClaw, boş bir sağlayıcı kapsamlı seçici göstermek yerine filtresiz kataloğa fallback yapar.
Gateway bir daemon olarak çalışıyorsa (launchd/systemd), VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID ve VOLCENGINE_TTS_TOKEN gibi model ve TTS ortam değişkenlerinin o süreç için erişilebilir olduğundan emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv üzerinden).
OpenClaw arka plan hizmeti olarak çalışırken etkileşimli kabuğunuzda ayarlanan ortam değişkenleri otomatik olarak devralınmaz. Yukarıdaki daemon notuna bakın.

​
İlgili

Model seçimi

Sağlayıcı, model başvurusu ve failover davranışlarını seçme.

Yapılandırma

Agent’lar, modeller ve sağlayıcılar için tam config referansı.

Sorun giderme

Yaygın sorunlar ve hata ayıklama adımları.

SSS

OpenClaw kurulumu hakkında sık sorulan sorular.