메인 콘텐츠로 건너뛰기

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 provider는 Volcano Engine에서 호스팅되는 Doubao 모델과 서드파티 모델에 대한 액세스를 제공하며, 일반 워크로드와 코딩 워크로드에 대해 별도의 엔드포인트를 사용합니다. 동일한 번들 Plugin은 Volcengine Speech를 TTS provider로도 등록할 수 있습니다.
세부 정보값
Providersvolcengine (일반 + TTS) + volcengine-plan (코딩)
모델 인증VOLCANO_ENGINE_API_KEY
TTS 인증VOLCENGINE_TTS_API_KEY 또는 BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI 호환 모델, BytePlus Seed Speech TTS

​
시작하기

1

API 키 설정

대화형 온보딩을 실행합니다:
openclaw onboard --auth-choice volcengine-api-key
이렇게 하면 하나의 API 키로 일반(volcengine) provider와 코딩(volcengine-plan) provider가 모두 등록됩니다.
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"

​
Providers 및 엔드포인트

Provider엔드포인트사용 사례
volcengineark.cn-beijing.volces.com/api/v3일반 모델
volcengine-planark.cn-beijing.volces.com/api/coding/v3코딩 모델
두 provider 모두 하나의 API 키로 구성됩니다. 설정 시 둘 다 자동으로 등록됩니다.

​
내장 카탈로그

모델 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는 BytePlus Seed Speech HTTP API를 사용하며 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,
        },
      },
    },
  },
}
음성 노트 대상의 경우 OpenClaw는 Volcengine에 provider 네이티브 ogg_opus를 요청합니다. 일반 오디오 첨부의 경우에는 mp3를 요청합니다. provider 별칭인 bytedance와 doubao도 동일한 speech provider로 확인됩니다. 기본 리소스 ID는 seed-tts-1.0입니다. 이는 BytePlus가 기본 프로젝트에서 새로 생성된 Seed Speech API 키에 부여하는 값이기 때문입니다. 프로젝트에 TTS 2.0 권한이 있으면 VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0으로 설정하세요.
VOLCANO_ENGINE_API_KEY는 ModelArk/Doubao 모델 엔드포인트용이며 Seed Speech API 키가 아닙니다. TTS에는 BytePlus Speech Console의 Seed Speech API 키 또는 레거시 Speech Console AppID/token 쌍이 필요합니다.
이전 Speech Console 애플리케이션을 위해 레거시 AppID/token 인증도 계속 지원됩니다: 
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 카탈로그도 등록하면서 기본 모델로 volcengine-plan/ark-code-latest를 설정합니다.
온보딩/구성 모델 선택 중 Volcengine 인증 선택은 volcengine/* 및 volcengine-plan/* 행을 모두 우선 적용합니다. 이러한 모델이 아직 로드되지 않았다면 OpenClaw는 빈 provider 범위 선택기를 표시하는 대신 필터링되지 않은 카탈로그로 폴백합니다.
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를 백그라운드 서비스로 실행할 때 대화형 셸에 설정한 환경 변수는 자동으로 상속되지 않습니다. 위의 데몬 관련 참고 사항을 확인하세요.

​
관련 항목

모델 선택

provider, 모델 ref, 장애 조치 동작 선택.

구성

agents, 모델, provider에 대한 전체 구성 참조.

문제 해결

일반적인 문제와 디버깅 단계.

FAQ

OpenClaw 설정에 대해 자주 묻는 질문.