메인 콘텐츠로 건너뛰기

​
Volcengine (Doubao)

Volcengine 제공자는 Volcano Engine에 호스팅된 Doubao 모델과 서드파티 모델에 대한 액세스를 제공하며, 일반 워크로드와 코딩 워크로드에 대해 별도의 엔드포인트를 사용합니다.
  • 제공자: volcengine(일반) + volcengine-plan(코딩)
  • 인증: VOLCANO_ENGINE_API_KEY
  • API: OpenAI 호환

​
빠른 시작

  1. API 키를 설정합니다:
openclaw onboard --auth-choice volcengine-api-key
  1. 기본 모델을 설정합니다:
{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}

​
비대화형 예시

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):
모델 참조이름입력컨텍스트
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-plan):
모델 참조이름입력컨텍스트
volcengine-plan/ark-code-latestArk Coding Plantext256,000
volcengine-plan/doubao-seed-codeDoubao Seed Codetext256,000
volcengine-plan/glm-4.7GLM 4.7 Codingtext200,000
volcengine-plan/kimi-k2-thinkingKimi K2 Thinkingtext256,000
volcengine-plan/kimi-k2.5Kimi K2.5 Codingtext256,000
volcengine-plan/doubao-seed-code-preview-251028Doubao Seed Code Previewtext256,000
openclaw onboard --auth-choice volcengine-api-key는 현재 일반 volcengine 카탈로그도 함께 등록하면서 volcengine-plan/ark-code-latest를 기본 모델로 설정합니다. 온보딩/설정 중 모델 선택에서는 Volcengine 인증 선택이 volcengine/*와 volcengine-plan/* 항목을 모두 우선적으로 표시합니다. 해당 모델이 아직 로드되지 않았다면 OpenClaw는 빈 제공자 범위 선택기를 보여주는 대신 필터링되지 않은 카탈로그로 폴백합니다.

​
환경 참고

Gateway가 데몬(launchd/systemd)으로 실행되는 경우, VOLCANO_ENGINE_API_KEY가 해당 프로세스에서 사용 가능하도록 해야 합니다(예: ~/.openclaw/.env 또는 env.shellEnv를 통해).