Providers
Volcengine (Doubao)
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ılar | volcengine (genel + TTS) + volcengine-plan (kodlama) |
| Model auth | VOLCANO_ENGINE_API_KEY |
| TTS auth | 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 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.
Varsayılan 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
Sağlayıcılar ve uç noktalar
| Sağlayıcı | Uç nokta | Kullanım durumu |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Genel modeller |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Kodlama modelleri |
Yerleşik katalog
Genel (volcengine)
| Model ref | Ad | Girdi | Bağlam |
|---|---|---|---|
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | text, image | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | text, image | 256,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | text, image | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | text, image | 200,000 |
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | text, image | 128,000 |
Kodlama (volcengine-plan)
| Model ref | Ad | Girdi | Bağlam |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | text | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | text | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | text | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | text | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | text | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | text | 256,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.
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
Onboarding sonrası varsayılan model
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.
Model seçici fallback davranışı
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.
Daemon süreçleri için ortam değişkenleri
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).