Volcengine (Doubao)

Провайдер Volcengine предоставляет доступ к моделям Doubao и сторонним моделям, размещенным на Volcano Engine, с отдельными конечными точками для общих задач и задач программирования. Тот же встроенный плагин также регистрирует Volcengine Speech как провайдер TTS.

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

openclaw onboard --auth-choice volcengine-api-key

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

openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

Провайдеры и конечные точки

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

Оба каталога статические (без вызова обнаружения /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, затем задайте:

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,        },      },    },  },}

Доступные поля в 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.

Для старых приложений Speech Console по-прежнему поддерживается устаревшая аутентификация с помощью AppID/токена:

export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"

Другие необязательные переменные окружения TTS: если заданы, VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY и VOLCENGINE_TTS_BASE_URL переопределяют соответствующие поля конфигурации messages.tts.providers.volcengine.

Расширенная конфигурация

См. также