Providers
Volcengine (Doubao)
Постачальник Volcengine надає доступ до моделей Doubao і сторонніх моделей, розміщених на Volcano Engine, з окремими кінцевими точками для загальних і пов’язаних із кодуванням навантажень. Той самий вбудований Plugin також може зареєструвати Volcengine Speech як постачальника TTS.
| Деталь | Значення |
|---|---|
| Постачальники | volcengine (загальний + TTS) + volcengine-plan (кодування) |
| Автентифікація моделі | VOLCANO_ENGINE_API_KEY |
| Автентифікація TTS | VOLCENGINE_TTS_API_KEY or BYTEPLUS_SEED_SPEECH_API_KEY |
| API | OpenAI-сумісні моделі, BytePlus Seed Speech TTS |
Початок роботи
Установіть ключ API
Запустіть інтерактивне онбординг-налаштування:
openclaw onboard --auth-choice volcengine-api-key
Це реєструє як загального (volcengine), так і постачальника для кодування (volcengine-plan) за одним ключем API.
Установіть модель за замовчуванням
{
agents: {
defaults: {
model: { primary: "volcengine-plan/ark-code-latest" },
},
},
}
Переконайтеся, що модель доступна
openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Постачальники та кінцеві точки
| Постачальник | Кінцева точка | Випадок використання |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Загальні моделі |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Моделі для кодування |
Вбудований каталог
Загальні (volcengine)
| Model ref | Назва | Вхід | Контекст |
|---|---|---|---|
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 |
Кодування (volcengine-plan)
| Model ref | Назва | Вхід | Контекст |
|---|---|---|---|
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 |
Перетворення тексту на мовлення
Volcengine TTS використовує HTTP API BytePlus Seed Speech і налаштовується окремо від OpenAI-сумісного ключа API моделі Doubao. У консолі BytePlus відкрийте Seed Speech > Settings > API Keys і скопіюйте ключ API, а потім задайте:
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
Потім увімкніть його в openclaw.json:
{
messages: {
tts: {
auto: "always",
provider: "volcengine",
providers: {
volcengine: {
apiKey: "byteplus_seed_speech_api_key",
voice: "en_female_anna_mars_bigtts",
speedRatio: 1.0,
},
},
},
},
}
Для цілей голосових нотаток OpenClaw запитує у Volcengine рідний для
постачальника формат ogg_opus. Для звичайних аудіовкладень він запитує mp3.
Псевдоніми постачальника bytedance і doubao також вказують на того самого постачальника мовлення.
Ресурсний ідентифікатор за замовчуванням — seed-tts-1.0, тому що саме його BytePlus надає
новоствореним ключам API Seed Speech у проєкті за замовчуванням. Якщо ваш проєкт
має entitlement на TTS 2.0, установіть VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
Застаріла автентифікація AppID/токеном і далі підтримується для старих застосунків Speech Console:
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"
Розширене налаштування
Модель за замовчуванням після онбординг-налаштування
openclaw onboard --auth-choice volcengine-api-key наразі встановлює
volcengine-plan/ark-code-latest як модель за замовчуванням, одночасно реєструючи
загальний каталог volcengine.
Поведінка резервного варіанта для вибору моделі
Під час онбординг-налаштування/налаштування вибору моделі варіант автентифікації Volcengine надає перевагу
рядкам volcengine/* і volcengine-plan/*. Якщо ці моделі ще не
завантажені, OpenClaw повертається до нефільтрованого каталогу замість показу
порожнього засобу вибору в межах постачальника.
Змінні середовища для процесів демона
Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що змінні
середовища для моделі й TTS, такі як VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY,
BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID і
VOLCENGINE_TTS_TOKEN, доступні цьому процесу (наприклад, у
~/.openclaw/.env або через env.shellEnv).