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.
| Detail | Value |
|---|---|
| Providers | volcengine (general) + volcengine-plan (coding) |
| Auth | VOLCANO_ENGINE_API_KEY |
| API | OpenAI-compatible |
Getting started
- Set the API key
Run interactive onboarding:
openclaw onboard --auth-choice volcengine-api-keyThis registers both the general (
volcengine) and coding (volcengine-plan) providers from a single API key. - Set a default model
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, }, } - Verify the model is available
openclaw models list --provider volcengine openclaw models list --provider volcengine-plan
For non-interactive setup (CI, scripting), pass the key directly:
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
| 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 |
| 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 |
Advanced notes
Default model after onboarding
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.
Model picker fallback behavior
During onboarding/configure model selection, the Volcengine auth choice prefers
both volcengine/* and volcengine-plan/* rows. If those models are not
loaded yet, OpenClaw falls back to the unfiltered catalog instead of showing an
empty provider-scoped picker.
Environment variables for daemon processes
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).
When running OpenClaw as a background service, environment variables set in your interactive shell are not automatically inherited. See the daemon note above.