Providers
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'i de bir TTS sağlayıcısı olarak 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
Set the API key
Etkileşimli ilk kurulumu çalıştırın:
openclaw onboard --auth-choice volcengine-api-keyBu işlem, tek bir API anahtarından hem genel (volcengine) hem de kodlama (volcengine-plan) sağlayıcılarını kaydeder.
Set a default model
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Verify the model is available
openclaw models list --provider volcengineopenclaw models list --provider volcengine-planSağ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 |
Yerleşik katalog
General (volcengine)
| Model referansı | 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 |
Coding (volcengine-plan)
| Model referansı | 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 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | metin | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | metin | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | metin | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | metin | 256,000 |
Her iki katalog da statiktir (/models keşif çağrısı yapılmaz) 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 kaldırı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 bölümünü 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:
{ messages: { tts: { auto: "always", provider: "volcengine", providers: { volcengine: { apiKey: "byteplus_seed_speech_api_key", voice: "en_female_anna_mars_bigtts", speedRatio: 1.0, }, }, }, },}messages.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 mesaj hedefleri için OpenClaw, sağlayıcıya özgü ogg_opus biçimini ister. Normal ses ekleri için mp3 ister. bytedance ve doubao sağlayıcı takma 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. Projenizde TTS 2.0 yetkisi varsa VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0 olarak ayarlayın.
Eski Speech Console uygulamaları için 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 messages.tts.providers.volcengine yapılandırma alanlarını geçersiz kılar.
Gelişmiş yapılandırma
Default model after onboarding
openclaw onboard --auth-choice volcengine-api-key, genel volcengine kataloğunu da kaydederken volcengine-plan/ark-code-latest modelini varsayılan model olarak ayarlar.
Model picker fallback behavior
İ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ı kapsamlı boş bir seçici göstermek yerine filtrelenmemiş kataloğa geri döner.
Environment variables for daemon processes
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).
