openclaw/docs/providers/volcengine.md

title, summary, read_when

title	summary	read_when
Volcengine (Doubao)	Volcano Engine setup (Doubao models, general + coding endpoints)	You want to use Volcano Engine or Doubao models with OpenClaw You need the Volcengine API key setup

Volcengine (Doubao)

The Volcengine provider gives access to Doubao models and third-party models hosted on Volcano Engine, with separate endpoints for general and coding workloads.

• Providers: volcengine (general) + volcengine-plan (coding)
• Auth: VOLCANO_ENGINE_API_KEY
• API: OpenAI-compatible

Quick start

1. Set the API key:

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

2. Set a default model:

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

Non-interactive example

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

Providers and endpoints

Provider	Endpoint	Use case
volcengine	ark.cn-beijing.volces.com/api/v3	General models
volcengine-plan	ark.cn-beijing.volces.com/api/coding/v3	Coding models

Both providers are configured from a single API key. Setup registers both automatically.

Available models

General provider (volcengine):

Model ref	Name	Input	Context
volcengine/doubao-seed-1-8-251228	Doubao Seed 1.8	text, image	256,000
volcengine/doubao-seed-code-preview-251028	doubao-seed-code-preview-251028	text, image	256,000
volcengine/kimi-k2-5-260127	Kimi K2.5	text, image	256,000
volcengine/glm-4-7-251222	GLM 4.7	text, image	200,000
volcengine/deepseek-v3-2-251201	DeepSeek V3.2	text, image	128,000

Coding provider (volcengine-plan):

Model ref	Name	Input	Context
volcengine-plan/ark-code-latest	Ark Coding Plan	text	256,000
volcengine-plan/doubao-seed-code	Doubao Seed Code	text	256,000
volcengine-plan/glm-4.7	GLM 4.7 Coding	text	200,000
volcengine-plan/kimi-k2-thinking	Kimi K2 Thinking	text	256,000
volcengine-plan/kimi-k2.5	Kimi K2.5 Coding	text	256,000
volcengine-plan/doubao-seed-code-preview-251028	Doubao Seed Code Preview	text	256,000

openclaw onboard --auth-choice volcengine-api-key currently sets volcengine-plan/ark-code-latest as the default model while also registering the general volcengine catalog.

Environment note

If the Gateway runs as a daemon (launchd/systemd), make sure VOLCANO_ENGINE_API_KEY is available to that process (for example, in ~/.openclaw/.env or via env.shellEnv).