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

Set the API key:

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

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).

3.3 KiB Raw Blame History