Volcengine (Doubao)

Volcengine sağlayıcısı, genel ve kodlama iş yükleri için ayrı uç noktalarla Doubao modellerine ve Volcano Engine üzerinde barındırılan üçüncü taraf modellere erişim sağlar. Aynı paketlenmiş plugin, Volcengine Speech’ü bir TTS sağlayıcısı olarak da kaydeder.

Ayrıntı	Değer
Sağlayıcılar	`volcengine` (genel + TTS), `volcengine-plan` (kodlama)
Model kimlik doğrulaması	`VOLCANO_ENGINE_API_KEY`
TTS kimlik doğrulaması	`VOLCENGINE_TTS_API_KEY` veya `BYTEPLUS_SEED_SPEECH_API_KEY`
API	OpenAI uyumlu modeller, BytePlus Seed Speech TTS

Başlarken

API anahtarını ayarlayın

Etkileşimli ilk kurulumu çalıştırın:

openclaw onboard --auth-choice volcengine-api-key

Bu işlem, tek bir API anahtarından hem genel (volcengine) hem de kodlama (volcengine-plan) sağlayıcılarını kaydeder.

Varsayılan bir model ayarlayın

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

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

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan

Etkileşimsiz kurulum (CI, betik çalıştırma) için anahtarı doğrudan iletin:

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ç nokta	Kullanım alanı
`volcengine`	`ark.cn-beijing.volces.com/api/v3`	Genel modeller
`volcengine-plan`	`ark.cn-beijing.volces.com/api/coding/v3`	Kodlama modelleri

Her iki sağlayıcı da tek bir API anahtarından yapılandırılır. Kurulum her ikisini de otomatik olarak kaydeder ve kodlama sağlayıcısının model seçicisi de genel sağlayıcının kimlik doğrulamasını yeniden kullanır (volcengine-plan, volcengine için bir kimlik doğrulama diğer adıdır).

Yerleşik katalog

Genel (volcengine)
Kodlama (volcengine-plan)

Model başvurusu	Ad	Girdi	Bağlam
`volcengine/deepseek-v3-2-251201`	DeepSeek V3.2	metin, görsel	128,000
`volcengine/doubao-seed-1-8-251228`	Doubao Seed 1.8	metin, görsel	256,000
`volcengine/doubao-seed-code-preview-251028`	doubao-seed-code-preview-251028	metin, görsel	256,000
`volcengine/glm-4-7-251222`	GLM 4.7	metin, görsel	200,000
`volcengine/kimi-k2-5-260127`	Kimi K2.5	metin, görsel	256,000

Model başvurusu	Ad	Girdi	Bağlam
`volcengine-plan/ark-code-latest`	Ark Coding Plan	metin	256,000
`volcengine-plan/doubao-seed-code`	Doubao Seed Code	metin	256,000

Her iki katalog da statiktir (/models keşif çağrısı yoktur) ve OpenAI uyumlu akışlı kullanım hesaplamasını destekler. Volcengine araç çağrısı API’si bunları reddettiğinden, her iki sağlayıcının araç şemaları minLength, maxLength, minItems, maxItems, minContains ve maxContains anahtar sözcüklerini otomatik olarak çıkarır.

Metinden konuşmaya

Volcengine TTS, BytePlus Seed Speech HTTP API’sini (voice.ap-southeast-1.bytepluses.com) kullanır ve OpenAI uyumlu Doubao model API anahtarından ayrı olarak yapılandırılır. BytePlus konsolunda Seed Speech > Settings > API Keys yolunu açın, API anahtarını kopyalayın ve ardından şunları ayarlayın:

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

Ardından openclaw.json içinde etkinleştirin:

{
  tts: {
    auto: "always",
    provider: "volcengine",
    providers: {
      volcengine: {
        apiKey: "byteplus_seed_speech_api_key",
        voice: "en_female_anna_mars_bigtts",
        speedRatio: 1.0,
      },
    },
  },
}

tts.providers.volcengine altındaki kullanılabilir alanlar: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey ve baseUrl. Ses ayarı geçersiz kılmalarına izin verildiğinde !emotion=<value>, satır içi ses yönergesi olarak da çalışır. Sesli not hedefleri için OpenClaw, sağlayıcının yerel ogg_opus biçimini ister. Normal ses ekleri için mp3 biçimini ister. bytedance ve doubao sağlayıcı diğer adları da bu konuşma sağlayıcısına çözümlenir. Varsayılan kaynak kimliği, BytePlus’ın yeni oluşturulan Seed Speech API anahtarlarına varsayılan olarak verdiği yetki olan seed-tts-1.0 değeridir. Projenizin TTS 2.0 yetkisi varsa VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 değerini 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 alınan bir Seed Speech API anahtarı veya eski bir Speech Console AppID/token çifti gerekir.

Eski Speech Console uygulamaları için eski AppID/token kimlik doğrulaması desteklenmeye devam eder:

export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

Diğer isteğe bağlı TTS ortam değişkenleri: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY ve VOLCENGINE_TTS_BASE_URL; ayarlandıklarında karşılık gelen tts.providers.volcengine yapılandırma alanlarını geçersiz kılar.

Gelişmiş yapılandırma

İlk kurulumdan sonraki varsayılan model

openclaw onboard --auth-choice volcengine-api-key, genel volcengine kataloğunu da kaydederken volcengine-plan/ark-code-latest değerini varsayılan model olarak ayarlar.

Model seçicinin geri dönüş davranışı

İlk kurulum/yapılandırma sırasında model seçilirken Volcengine kimlik doğrulama seçeneği hem volcengine/* hem de volcengine-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmemişse OpenClaw, sağlayıcı kapsamındaki boş bir seçici göstermek yerine filtrelenmemiş kataloğa geri döner.

Daemon süreçleri için ortam değişkenleri

Gateway bir daemon (launchd/systemd) olarak çalışıyorsa 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 bu süreç tarafından kullanılabildiğinden emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla).

OpenClaw bir arka plan hizmeti olarak çalıştırıldığında, 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ıları, model başvurularını ve yük devretme davranışını seçme.

Yapılandırma

Ajanlar, modeller ve sağlayıcılar için tam yapılandırma başvurusu.

Sorun giderme

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

SSS

OpenClaw kurulumu hakkında sıkça sorulan sorular.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

Başlarken

Sağlayıcılar ve uç noktalar

Yerleşik katalog

Metinden konuşmaya

Gelişmiş yapılandırma

İlgili

Model seçimi

Yapılandırma

Sorun giderme

SSS

​Başlarken

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

​Yerleşik katalog

​Metinden konuşmaya

​Gelişmiş yapılandırma

​İlgili

Model seçimi

Yapılandırma

Sorun giderme

SSS

Başlarken

Sağlayıcılar ve uç noktalar

Yerleşik katalog

Metinden konuşmaya

Gelişmiş yapılandırma

İlgili