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:

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
openclaw onboard –auth-choice volcengine-api-key


2. Set a default model:

```json5  theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}

Non-interactive example

bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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

doubao-seed-1-8 – Doubao Seed 1.8 (general, default)
doubao-seed-code-preview – Doubao coding model
ark-code-latest – Coding plan default
Kimi K2.5 – Moonshot AI via Volcano Engine
GLM-4.7 – GLM via Volcano Engine
DeepSeek V3.2 – DeepSeek via Volcano Engine

Most models support text + image input. Context windows range from 128K to 256K
tokens.

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