---
read_when:
- OpenClaw ile Volcano Engine veya Doubao modellerini kullanmak istiyorsunuz
- Volcengine API anahtarını ayarlamanız gerekir
- Volcengine Speech metinden konuşmaya özelliğini kullanmak istiyorsunuz
summary: Volcano Engine kurulumu (Doubao modelleri, kodlama uç noktaları ve Seed Speech TTS)
title: Volcengine (Doubao)
x-i18n:
generated_at: "2026-07-12T12:44:47Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: e853a1c8847704caedf0ec83c38332569f72105c5e34ad973daf614a2e80550b
source_path: providers/volcengine.md
workflow: 16
---
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
Etkileşimli ilk kurulumu çalıştırın:
```bash
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.
```json5
{
agents: {
defaults: {
model: { primary: "volcengine-plan/ark-code-latest" },
},
},
}
```
```bash
openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
```
Etkileşimsiz kurulum (CI, betik oluşturma) için anahtarı doğrudan iletin:
```bash
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, 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 takma adıdır).
## Yerleşik katalog
| 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 |
| 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:
```bash
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:
```json5
{
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=` 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.
`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 AppID/token kimlik doğrulaması desteklenmeye devam eder:
```bash
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
`openclaw onboard --auth-choice volcengine-api-key`, genel `volcengine` kataloğunu da kaydederken `volcengine-plan/ark-code-latest` modelini varsayılan model olarak ayarlar.
İ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.
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 konular
Sağlayıcıların, model referanslarının ve yük devretme davranışının seçilmesi.
Aracılar, modeller ve sağlayıcılar için tam yapılandırma başvurusu.
Yaygın sorunlar ve hata ayıklama adımları.
OpenClaw kurulumu hakkında sık sorulan sorular.