必须完成api key与endpoint id双重绑定，缺一不可：未实名无法开通模型，只填api key报401，只填endpoint id报404；需在火山引擎控制台实名认证后开通doubao-lite-32k，创建读写权限api key并立即保存，复制对应ep-开头endpoint id，再通过openclaw onboard命令行输入两者及模型名完成配置，最后在web面板测试并设为主模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在OpenClaw中稳定调用豆包大模型、享受火山引擎每月50万tokens免费额度，必须完成API Key与Endpoint ID的双重绑定，缺一不可——只填API Key会导致401认证失败，只填Endpoint ID则触发404模型未找到错误。
获取火山引擎豆包API凭证
打开火山引擎控制台（https://console.volcengine.com/），用手机号注册并完成【个人实名认证】——未实名账号无法开通任何大模型服务，页面会直接拦截且不提示原因。
进入「火山方舟」→「模型广场」→搜索“Doubao-lite-32k”，点击开通。该模型响应快、中文强、完全免费，是日常办公首选。
左侧菜单进入「API Key管理」→「创建API Key」→名称填“openclaw-doubao”→权限选“读写”→生成后【立即复制保存】（页面关闭后密钥永久消失，重置会变更密钥导致OpenClaw断连）。
返回「模型列表」→点击已开通的Doubao-lite-32k →复制Endpoint ID（格式为ep-xxxxxxxxxxxxxxxxxxxx）。
命令行一键配置OpenClaw（推荐）
打开PowerShell或终端，执行：
openclaw onboard --auth-choice volcengine-api-key
按提示依次输入：
API Key：粘贴刚才复制的apikey-xxx字符串（不要带Bearer前缀）
Endpoint ID：粘贴ep-xxx字符串
模型名称：输入doubao-lite-32k（必须与火山方舟后台开通的模型ID完全一致，大小写敏感）
配置成功后，OpenClaw自动写入~/.openclaw/openclaw.json并重启网关。
Web面板手动校验与启用
浏览器访问http://localhost:18789，登录OpenClaw管理后台。
进入「模型配置」→「服务商」→确认“volcengine”已存在且状态为绿色“已连接”。
点击右侧「测试」按钮，输入“你好”，若返回中文回复且右上角显示“Token消耗：xx”，说明免费额度已生效。
勾选“设为主模型”，再点击「保存并重启Gateway」——这一步必须执行，否则旧模型仍为默认调用目标。
