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

​
Начало работы

1

Set the API key

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

Set a default model

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

Verify the model is available

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-ключа. Настройка регистрирует их автоматически.

​
Встроенный каталог

Ссылка на модельНазваниеВводКонтекст
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8текст, изображение256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028текст, изображение256,000
volcengine/kimi-k2-5-260127Kimi K2.5текст, изображение256,000
volcengine/glm-4-7-251222GLM 4.7текст, изображение200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2текст, изображение128,000

​
Преобразование текста в речь

Volcengine TTS использует HTTP API BytePlus Seed Speech и настраивается отдельно от API-ключа OpenAI-совместимых моделей 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 в проекте по умолчанию. Если у вашего проекта есть право на 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.
Во время выбора модели при onboarding/configure вариант аутентификации Volcengine предпочитает строки volcengine/* и volcengine-plan/*. Если эти модели еще не загружены, OpenClaw откатывается к нефильтрованному каталогу вместо показа пустого средства выбора, ограниченного провайдером.
Если Gateway работает как daemon (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 как фоновой службы переменные окружения, заданные в вашей интерактивной оболочке, не наследуются автоматически. См. примечание о daemon выше.

​
Связанные материалы

Model selection

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

Configuration

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

Troubleshooting

Распространенные проблемы и шаги отладки.

FAQ

Часто задаваемые вопросы о настройке OpenClaw.