Volcengine(Doubao)

Volcengine 제공자는 Doubao 모델과 Volcano Engine에서 호스팅되는 타사 모델에 대한 액세스를 제공하며, 일반 작업과 코딩 작업에 별도의 엔드포인트를 사용합니다. 동일한 번들 Plugin은 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 호환 스트리밍 사용량 집계를 지원합니다. Volcengine 도구 호출 API가 해당 키워드를 거부하므로 두 제공자의 도구 스키마에서는 minLength, maxLength, minItems, maxItems, minContains, maxContains 키워드가 자동으로 제거됩니다.

텍스트 음성 변환

Volcengine TTS는 BytePlus Seed Speech HTTP API(voice.ap-southeast-1.bytepluses.com)를 사용하며, OpenAI 호환 Doubao 모델 API 키와 별도로 구성됩니다. 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도 이 음성 제공자로 해석됩니다.

기본 리소스 ID는 seed-tts-1.0이며, BytePlus가 새로 생성된 Seed Speech API 키에 기본적으로 부여하는 사용 권한입니다. 프로젝트에 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 구성 필드를 재정의합니다.

고급 구성

관련 문서