Skip to main content
Провайдер Volcengine надає доступ до моделей Doubao та сторонніх моделей, розміщених у Volcano Engine, з окремими кінцевими точками для загальних завдань і програмування. Той самий вбудований Plugin також реєструє Volcengine Speech як провайдера TTS.

​
Початок роботи

1

Установіть ключ API

Запустіть інтерактивне початкове налаштування:
Ця команда реєструє провайдери загального призначення (volcengine) і програмування (volcengine-plan) за допомогою одного ключа API.
2

Установіть модель за замовчуванням

3

Перевірте доступність моделі

Для неінтерактивного налаштування (CI, сценарії) передайте ключ безпосередньо:

​
Провайдери та кінцеві точки

Обидва провайдери налаштовуються за допомогою одного ключа API. Під час налаштування вони реєструються автоматично, а засіб вибору моделей провайдера для програмування також повторно використовує автентифікацію загального провайдера (volcengine-plan є псевдонімом автентифікації для volcengine).

​
Вбудований каталог

Обидва каталоги є статичними (без виклику виявлення /models) і підтримують потоковий облік використання, сумісний з OpenAI. Схеми інструментів для обох провайдерів автоматично вилучають ключові слова minLength, maxLength, minItems, maxItems, minContains і maxContains, оскільки API виклику інструментів Volcengine їх відхиляє.

​
Синтез мовлення

Volcengine TTS використовує HTTP API BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) і налаштовується окремо від ключа API моделей Doubao, сумісного з OpenAI. У консолі BytePlus відкрийте Seed Speech > Settings > API Keys, скопіюйте ключ API, а потім установіть:
Після цього ввімкніть його в openclaw.json:
Доступні поля в messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2–3.0), emotion, cluster, resourceId, appKey і baseUrl. !emotion=<value> також працює як вбудована директива голосу, коли дозволено перевизначати налаштування голосу. Для цільових голосових повідомлень OpenClaw запитує нативний для провайдера формат ogg_opus. Для звичайних аудіовкладень запитується mp3. Псевдоніми провайдера bytedance і doubao також посилаються на цього провайдера синтезу мовлення. Ідентифікатор ресурсу за замовчуванням — seed-tts-1.0, право доступу, яке BytePlus за замовчуванням надає новоствореним ключам API Seed Speech. Якщо ваш проєкт має право доступу до TTS 2.0, установіть VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY призначений для кінцевих точок моделей ModelArk/Doubao і не є ключем API Seed Speech. Для TTS потрібен ключ API Seed Speech із BytePlus Speech Console або застаріла пара AppID/токен зі Speech Console.
Автентифікація за допомогою застарілої пари AppID/токен залишається підтримуваною для старіших застосунків Speech Console:
Інші необов’язкові змінні середовища TTS: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY і VOLCENGINE_TTS_BASE_URL; якщо їх установлено, вони перевизначають відповідні поля конфігурації messages.tts.providers.volcengine.

​
Розширена конфігурація

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).
Коли OpenClaw працює як фонова служба, змінні середовища, установлені в інтерактивній оболонці, не успадковуються автоматично. Дивіться примітку про демон вище.

​
Пов’язані матеріали

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки аварійного перемикання.

Конфігурація

Повний довідник із конфігурації агентів, моделей і провайдерів.

Усунення несправностей

Поширені проблеми та кроки налагодження.

Поширені запитання

Поширені запитання про налаштування OpenClaw.