部署教程
豆包 Doubao 部署教程:用字节大模型搭建AI助手
豆包 Doubao 是字节跳动通过火山引擎方舟提供的大模型系列——中文理解强、多模态、工具调用稳定,是国产模型里落地最广的选择之一。本文介绍把它接入龙虾 OpenClaw 的两种方式。
什么是 字节豆包 Doubao?
字节跳动 研发的豆包 Doubao 通过火山引擎(方舟 Ark)平台对外提供 OpenAI 兼容 API。主力的 Doubao-Seed 系列在中文场景、长文本与工具调用上表现稳定,价格在国产模型中很有竞争力,适合面向中文用户的客服与助手。
豆包 Doubao 模型怎么选
| 模型 | 适用场景 | 说明 |
|---|---|---|
doubao-seed-1-6 | 复杂推理、多模态、工具调用 | 旗舰 |
doubao-pro | 通用对话、内容生成 | 高性价比 |
doubao-lite | 快速聊天、高频简单任务 | 速度优化 |
具体每百万 token 价格与可用模型 ID 请以 火山引擎官方文档为准。
方式一:自带 API Key(BYOK,推荐)
方舟 Ark 的接口兼容 OpenAI Chat Completions,所以走「自定义 API 提供商」这一栏,不需要单独的火山引擎入口:
- 在 火山引擎方舟控制台 建一个 API Key。
- 打开龙虾的 API Keys 页面,找到「自定义 API 提供商」。
- 「API 端点 URL」填
https://ark.cn-beijing.volces.com/api/v3,「API 密钥」填刚才那个 Key,保存。 - 回到 控制台 的模型选择器,选你要用的豆包模型 ID(例如
doubao-seed-1-8-251228)。 - 连接 Telegram、Discord、WhatsApp、微信或网页聊天,点击「部署」,约 30 秒上线。
托管实例请不要手动往 openclaw.json 里写 ${VOLCANO_ENGINE_API_KEY} 这类环境变量引用:容器里没有这个变量,而 OpenClaw 把解析不了的密钥当作启动失败,网关会直接进入重启循环。上面这条路径存的是密钥本身,不会有这个问题。
方式二:自托管 + 豆包 Doubao
自己运行 OpenClaw 时,在 openclaw.json 中配置 字节跳动 提供商(OpenAI 兼容端点):
{
"models": {
"providers": {
"doubao": {
"apiKey": "...",
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "doubao/doubao-seed-1-6"
}
}
}
}不同任务的取舍
| 任务类型 | 推荐 | 原因 |
|---|---|---|
| 客服聊天、FAQ 机器人 | doubao-lite | 快且便宜 |
| 中文内容生成 | doubao-pro | 中文质量与成本平衡 |
| 多模态、复杂任务 | doubao-seed-1-6 | 能力最强 |
| 常驻个人机器人 | doubao-lite | 高频成本最低 |
运行时切换模型
/model doubao-seed-1-6
/model doubao-lite什么时候该选 豆包 Doubao
- 面向中文用户、对中文理解要求高的助手
- 需要多模态(图片理解)能力
- 希望数据走境内合规 API
- 想要国产模型里成本与稳定性兼顾的选择
常见问题
龙虾支持 豆包 Doubao 吗?
支持。在龙虾部署托管容器后,可通过自带 火山引擎 的 API Key(BYOK)接入 豆包 Doubao,流量直接走 字节跳动 官方 API。每个实例独立隔离。
豆包 Doubao 适合做智能体吗?
适合。豆包 Doubao 支持工具调用,配合龙虾的多渠道接入,可以搭建能查资料、调工具、跨平台回复的智能体。复杂任务选系列中的旗舰版本,高频简单任务选速度优化版本即可。
数据安全吗?
通过龙虾部署时,每个用户拥有独立的 Docker 容器实例,数据完全隔离,对话不会被存储或用于模型训练。
可以随时换成其他模型吗?
可以。龙虾支持随时切换模型,无需重新部署。觉得某个任务上别的模型更合适,一键切换即可。
开始使用 豆包 Doubao
在龙虾 OpenClaw Launch 上,几分钟就能把 字节豆包 Doubao 接到你常用的聊天平台,搭建一个能调工具、跨渠道回复的 AI 助手。
访问 龙虾 OpenClaw Launch — 选择 豆包 Doubao,约 30 秒部署你的专属 AI 助手。