豆包 / 火山方舟
豆包（Doubao）是字节跳动推出的大语言模型，通过火山引擎方舟平台（Volcano Engine Ark）提供 API 服务。豆包模型在中文理解、创作和对话方面表现出色。
注册与配置
第一步：注册火山引擎
- 前往 火山引擎控制台 注册账号
- 使用手机号或字节跳动账号登录
- 完成实名认证
第二步：开通方舟平台
- 在控制台中搜索「方舟」或「Ark」
- 进入 方舟大模型服务平台
- 开通服务
第三步：创建推理接入点（Endpoint）
- 在方舟平台左侧菜单中，进入「在线推理」>「推理接入点管理」
- 点击「创建推理接入点」
- 选择模型（如 Doubao-pro-32k）
- 记录生成的 Endpoint ID（如
ep-xxxxxxxxxxxxxxxx）
第四步：获取 API Key
- 在方舟平台左侧菜单中，进入「API Key 管理」
- 创建 API Key
- 复制 API Key
配置 OpenClaw
豆包的 API 兼容 OpenAI 格式，可以作为自定义 OpenAI 兼容提供商接入：
jsonc
// ~/.openclaw/config.json
{
"models": {
"providers": {
"doubao": {
"apiKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3"
}
}
}
}重要
豆包使用 Endpoint ID 作为模型标识，而非模型名称。请将 Endpoint ID 作为模型 ID 使用。
bash
# 使用 Endpoint ID 作为模型名
openclaw models default set doubao/ep-xxxxxxxxxxxxxxxx模型选择
在创建推理接入点时，可以选择以下模型：
| 模型 | 说明 | 上下文窗口 |
|---|---|---|
| Doubao-pro-32k | 旗舰版，综合能力最强 | 32K |
| Doubao-pro-128k | 长文本版 | 128K |
| Doubao-pro-256k | 超长文本版 | 256K |
| Doubao-lite-32k | 轻量版，速度快成本低 | 32K |
| Doubao-lite-128k | 轻量长文本版 | 128K |
模型选择建议
| 场景 | 推荐模型 | 说明 |
|---|---|---|
| 日常对话 | Doubao-pro-32k | 综合能力最强 |
| 长文档处理 | Doubao-pro-128k | 支持长上下文 |
| 高频调用 | Doubao-lite-32k | 成本低，速度快 |
| 批量处理 | Doubao-lite-128k | 兼顾成本和上下文长度 |
环境变量
bash
export DOUBAO_API_KEY="xxxxxxxxxxxxxxxxxxxxxxxx"
export DOUBAO_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"企业特性
VPC 内网访问
火山引擎支持 VPC（Virtual Private Cloud）内网访问方舟平台，数据不经过公网。
SLA 保障
企业用户可获得 99.9% 可用性 SLA 保障。
用量管理
方舟平台提供详细的用量统计和成本分析工具。
模型微调
支持基于企业数据对豆包模型进行微调（Fine-tuning）。
价格参考
| 模型 | 输入价格（每千 Token） | 输出价格（每千 Token） |
|---|---|---|
| Doubao-pro-32k | ¥0.0008 | ¥0.002 |
| Doubao-pro-128k | ¥0.005 | ¥0.009 |
| Doubao-lite-32k | ¥0.0003 | ¥0.0006 |
| Doubao-lite-128k | ¥0.0008 | ¥0.001 |
说明
价格可能随时调整，请以 火山引擎官方定价 为准。
故障排查
Endpoint 不存在
- 确认 Endpoint ID 正确（格式为
ep-开头） - 检查推理接入点是否处于「运行中」状态
API Key 无效
- 在方舟平台重新检查 API Key
- 确认 API Key 未过期或被删除
请求格式错误
- 确认
baseUrl指向https://ark.cn-beijing.volces.com/api/v3 - 使用 Endpoint ID 而非模型名称作为
model参数
权限不足
- 确认火山引擎账号已完成实名认证
- 检查 API Key 的权限范围
🇨🇳 中国用户须知
- 无需代理：火山引擎是国内服务，API 可直接访问，延迟极低
- 字节生态：如果你已有字节跳动 / 火山引擎账号，可直接使用
- 注册方式：支持手机号、字节跳动账号、微信扫码登录
- 充值方式：支持支付宝、微信支付、银行转账、企业对公付款
- Endpoint 概念：与 OpenAI 直接使用模型名不同，豆包需要先创建 Endpoint 再通过 Endpoint ID 调用，这是因为方舟平台支持对同一模型创建不同配置的接入点
- 企业首选：字节跳动在国内有强大的基础设施，适合企业级大规模使用
- 价格优势：豆包 Lite 系列价格极低，适合高频调用场景