OpenClaw(小龙虾)对接豆包 Doubao 保姆级教程(2026 最新)
2026/6/12 1:12:54 网站建设 项目流程

一、前言
豆包(Doubao)是字节跳动自研大模型,中文理解强、响应快、免费额度高(每月 50 万 tokens)。
OpenClaw(小龙虾)是开源 AI 智能体框架,负责电脑操作、文件管理、钉钉 / 微信自动化、网页操作。
把豆包接到 OpenClaw = 最强中文大脑 + 最强本地执行手,办公、开发、自动化一步到位。
本文采用火山引擎方舟平台官方 API 直连,无需公网、无需中转,Windows/macOS/Linux 通用。
二、前置准备(必须)
已安装并正常启动 OpenClaw(小龙虾)(推荐 Windows 一键部署包)
能正常访问 火山引擎官网
完成 火山引擎实名认证(个人即可,免费)
三、第一步:获取豆包 API Key 与 Endpoint(核心)
3.1 注册 / 登录火山引擎
访问:https://console.volcengine.com/
用手机号注册并登录,完成个人实名认证(必须,否则无法开通模型)。
3.2 进入火山方舟(ARK)
登录后搜索进入 火山方舟(ARK)控制台。
3.3 开通豆包模型
进入模型广场
搜索:Doubao-lite-32k(免费、响应快、最适合接入)
点击开通服务 → 状态变为已启用
3.4 创建 API Key
左侧菜单 → API Key 管理 → 创建 API Key
名称填:openclaw-doubao(随便写)
权限:读写
生成后立即复制保存(只显示一次!)
格式类似:
plaintext
apikey-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3.5 获取推理接入点(Endpoint ID)
模型列表 → 点击 Doubao-lite-32k
复制 Endpoint ID(以 ep- 开头)
保存好两样:API Key + Endpoint ID
四、第二步:在 OpenClaw 配置豆包(2 种方法)
方法 A:命令行配置(推荐,全平台通用)
打开 PowerShell / 终端,执行:
bash
运行
openclaw onboard --auth-choice volcengine-api-key
按提示输入:
API Key:粘贴刚才复制的 apikey-xxx
Endpoint ID:粘贴 ep-xxx
模型名称:doubao-lite-32k
自动生成配置并保存。
方法 B:手动写配置文件(高级)
编辑配置文件:
plaintext
~/.openclaw/openclaw.json
添加 / 修改:
json
{
"models": {
"providers": {
"doubao": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "你的apikey-xxx",
"api": "openai-completions",
"models": [
{
"id": "ep-你的endpoint-id",
"name": "豆包Doubao-lite-32k",
"contextWindow": 32768
}
]
}
},
"default": "doubao"
}
}
保存后自动生效,无需重启。
五、第三步:启动 / 重启 OpenClaw
bash
运行
# 启动网关
openclaw gateway
看到类似日志即成功:
plaintext
✅ 模型加载成功:doubao/豆包Doubao-lite-32k
六、第四步:测试豆包是否正常工作
打开浏览器访问:
plaintext
http://127.0.0.1:18789
输入测试指令:
plaintext
用简洁语言介绍一下你自己
如果有中文回复、无报错,说明对接成功!
再试一个执行类指令(体现 OpenClaw 价值):
plaintext
在桌面新建一个txt文件,内容写“豆包+小龙虾对接成功”
能自动创建文件 → 完全打通!
七、常见问题(避坑)
1. 401 鉴权失败
API Key 复制不全 / 多空格
未实名认证
Key 输错 → 重建一个
2. 404 模型不存在
Endpoint ID 错误(必须是 ep- 开头)
模型未开通 → 回到方舟开通 Doubao-lite-32k
3. 能聊天但不能执行操作
OpenClaw 未启动网关
默认模型没设为 doubao → 检查配置 models.default
4. 免费额度够用吗?
每月 50 万 tokens,日常办公足够
用完可升级付费或换其他模型
八、总结
OpenClaw + 豆包 = 中文最强组合:
✅ 豆包:强中文理解、免费额度高、响应快
✅ OpenClaw:本地执行、文件 / 浏览器 / 钉钉自动化
✅ 火山直连:稳定、安全、免费、无需公网

OpenClaw一键获取安装包:http://b.m6z.cn/hayK4
按本文步骤,5 分钟即可完成对接,立刻拥有一个能听懂中文、能动手干活的本地 AI 助理。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询