Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Постачальник Volcengine надає доступ до моделей Doubao і сторонніх моделей, розміщених на Volcano Engine, з окремими кінцевими точками для загальних і пов’язаних із кодуванням навантажень. Той самий вбудований Plugin також може зареєструвати Volcengine Speech як постачальника TTS.
ДетальЗначення
Постачальникиvolcengine (загальний + TTS) + volcengine-plan (кодування)
Автентифікація моделіVOLCANO_ENGINE_API_KEY
Автентифікація TTSVOLCENGINE_TTS_API_KEY or BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI-сумісні моделі, BytePlus Seed Speech TTS

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

1

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

Запустіть інтерактивне онбординг-налаштування:
openclaw onboard --auth-choice volcengine-api-key
Це реєструє як загального (volcengine), так і постачальника для кодування (volcengine-plan) за одним ключем API.
2

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

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}
3

Переконайтеся, що модель доступна

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Для неінтерактивного налаштування (CI, сценарії) передайте ключ напряму:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Постачальники та кінцеві точки

ПостачальникКінцева точкаВипадок використання
volcengineark.cn-beijing.volces.com/api/v3Загальні моделі
volcengine-planark.cn-beijing.volces.com/api/coding/v3Моделі для кодування
Обидва постачальники налаштовуються за одним ключем API. Під час налаштування обидва реєструються автоматично.

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

Model refНазваВхідКонтекст
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,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.
VOLCANO_ENGINE_API_KEY призначений для кінцевих точок моделей ModelArk/Doubao і не є ключем API Seed Speech. Для TTS потрібен ключ API Seed Speech з BytePlus Speech Console або застаріла пара AppID/токен зі Speech Console.
Застаріла автентифікація 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).
Коли OpenClaw працює як фоновий сервіс, змінні середовища, задані у вашій інтерактивній оболонці, не успадковуються автоматично. Див. примітку про демона вище.

​
Пов’язане

Вибір моделі

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

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

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

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

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

FAQ

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