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:

velaclaw onboard --auth-choice volcengine-api-key

This 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

velaclaw models list --provider volcengine
velaclaw models list --provider volcengine-plan

For non-interactive setup (CI, scripting), pass the key directly:

velaclaw 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 (volcengine)
Coding (volcengine-plan)

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

velaclaw 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, Velaclaw 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 ~/.velaclaw/.env or via env.shellEnv).

When running Velaclaw as a background service, environment variables set in your interactive shell are not automatically inherited. See the daemon note above.

Model selection

Choosing providers, model refs, and failover behavior.

Configuration

Full config reference for agents, models, and providers.

Troubleshooting

Common issues and debugging steps.

FAQ

Frequently asked questions about Velaclaw setup.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

Volcengine (Doubao)

Getting started

Providers and endpoints

Available models

Advanced notes

Model selection

Configuration

Troubleshooting

FAQ

​Volcengine (Doubao)

​Getting started

​Providers and endpoints

​Available models

​Advanced notes

​Related

Model selection

Configuration

Troubleshooting

FAQ

Volcengine (Doubao)

Getting started

Providers and endpoints

Available models

Advanced notes

Related