豆包 Doubao

配置字节跳动豆包系列模型

豆包是字节跳动推出的 AI 大模型系列。Doubao 2.0 Code 是专为代码场景优化的模型，在代码生成、补全、调试和重构方面表现出色。

模型概览

模型	类型	上下文窗口	特点
`doubao-2.0-code`	代码生成	128K	代码专精，支持多语言编程
`doubao-1.5-pro-32k`	通用对话	32K	通用任务，性价比高
`doubao-1.5-pro-128k`	长上下文	128K	长文档理解与分析

方式 A：火山引擎 API Key

适用场景： 通过火山引擎 API 访问豆包模型。

从火山引擎控制台获取 API Key（需要先开通模型推理服务并创建推理接入点）。

CLI 设置

bash

crabclaw onboard --auth-choice doubao-api-key
# 或非交互模式
crabclaw onboard --doubao-api-key "$DOUBAO_API_KEY"
crabclaw onboard --auth-choice doubao-api-key
# 或非交互模式
crabclaw onboard --doubao-api-key "$DOUBAO_API_KEY"

配置示例

json5

{
  env: { DOUBAO_API_KEY: "..." },
  agents: { defaults: { model: { primary: "doubao/doubao-2.0-code" } } },
  models: {
    mode: "merge",
    providers: {
      doubao: {
        baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
        apiKey: "${DOUBAO_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "doubao-2.0-code",
            name: "Doubao 2.0 Code",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "doubao-1.5-pro-128k",
            name: "Doubao 1.5 Pro 128K",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "doubao-1.5-pro-32k",
            name: "Doubao 1.5 Pro 32K",
            reasoning: false,
            input: ["text"],
            contextWindow: 32768,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
{
  env: { DOUBAO_API_KEY: "..." },
  agents: { defaults: { model: { primary: "doubao/doubao-2.0-code" } } },
  models: {
    mode: "merge",
    providers: {
      doubao: {
        baseUrl: "https://ark.cn-beijing.volces.com/api/v3",
        apiKey: "${DOUBAO_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "doubao-2.0-code",
            name: "Doubao 2.0 Code",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "doubao-1.5-pro-128k",
            name: "Doubao 1.5 Pro 128K",
            reasoning: false,
            input: ["text"],
            contextWindow: 131072,
            maxTokens: 8192,
          },
          {
            id: "doubao-1.5-pro-32k",
            name: "Doubao 1.5 Pro 32K",
            reasoning: false,
            input: ["text"],
            contextWindow: 32768,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

注意：火山引擎使用推理接入点 ID（Endpoint ID）作为模型 ID。上面的 doubao-2.0-code 等名称为示例，实际使用时需替换为你在火山引擎控制台创建的推理接入点 ID。

Doubao 作为回退

json5

{
  env: { DOUBAO_API_KEY: "..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "doubao/doubao-2.0-code": { alias: "doubao" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["doubao/doubao-2.0-code"],
      },
    },
  },
}
{
  env: { DOUBAO_API_KEY: "..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "doubao/doubao-2.0-code": { alias: "doubao" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["doubao/doubao-2.0-code"],
      },
    },
  },
}

注意事项

模型引用格式为 doubao/<endpoint-id>。
火山引擎 API 兼容 OpenAI 格式，使用 openai-completions API 类型。
推理接入点：需要在火山引擎控制台创建推理接入点后，使用接入点 ID 作为模型 ID。
Doubao 2.0 Code 专为编程优化，推荐用于代码相关任务。
参见模型供应商概念了解供应商规则。
使用 crabclaw models list 和 crabclaw models set doubao/doubao-2.0-code 切换模型。