必须同时填入火山引擎的Access Key和Secret Key才能调用豆包、DeepSeek R1等模型，否则报错“Unauthorized”；OpenClaw需在apiKey和secretKey字段分别填写二者，ChatBox支持界面填写或环境变量注入，OpenCode则需编辑JSON配置并执行auth login绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
把火山引擎的 API Key 正确填进本地 AI 客户端，才能调用豆包、DeepSeek R1、ARK-Coding 等模型，否则会提示“Unauthorized”或“Invalid API Key”。
确认 API Key 已获取并保存
打开火山引擎控制台 → 进入「火山方舟 → API Key 管理」→ 点击「创建 API Key」→ 复制 Access Key 和 Secret Key（【仅首次显示，关闭页面即不可再查】）→ 同时记下你开通的模型 ID，比如 doubao-1.5-pro-256k 或 deepseek-r1-250120。
如果你还没创建，现在立刻去完成。没这一步，后面所有配置都无效。
填入 OpenClaw 客户端（推荐新手）
安装完成后首次启动 OpenClaw 会自动弹出初始化向导：
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
① 选择 quickstart 模式 →
② 在「填写模型 API Key」页，【Access Key 填入 apiKey 字段，Secret Key 填入 secretKey 字段】 →
③ 模型 ID 手动输入（如 doubao-lite-32k），不要留空 →
④ 服务启动后访问 http://localhost:18789，登录即可使用。
注意：OpenClaw 不识别单个 sk-xxx 格式密钥，必须同时提供 Access Key + Secret Key，缺一不可。
填入 ChatBox 客户端（支持自定义接入点）
方法一：直接填写三要素
设置 → 新建模型 → 添加自定义提供方 → 填写：
• Provider Name：volcengine（可自定义，但后续 auth 要一致）
• Base URL：https://ark.cn-beijing.volces.com/api/v3
• API Key：粘贴你的 Access Key
• Model ID：填你开通的模型名，例如 deepseek-r1-250120
方法二：通过环境变量注入（更安全）
在终端执行：export ARK_API_KEY="your_access_key_here"export ARK_SECRET_KEY="your_secret_key_here"
然后启动 ChatBox，它会自动读取这两个变量，无需在界面填密钥。
这一步做完，ChatBox 就能直连火山引擎，不用暴露密钥到配置文件里。
填入 OpenCode 客户端（需手动编辑 JSON）
第一步：定位或新建配置文件
Linux/macOS 路径：~/.config/opencode/opencode.json
Windows 路径：%USERPROFILE%\.config\opencode\opencode.json
如果文件不存在，就新建一个空的 JSON 文件。
第二步：写入火山引擎 provider 配置
将以下内容粘贴进去，【把 <ARK_API_KEY> 替换为你的 Access Key】，Secret Key 不填在此处（OpenCode 当前只校验 apiKey 字段）：
{ "$schema": "https://opencode.ai/config.json", "provider": { "volcengine": { "npm": "@ai-sdk/openai-compatible", "name": "volcengine", "options": { "baseURL": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "<ARK_API_KEY>" }, "models": { "ark-code-latest": { "name": "ark-code-latest" } } } } }
第三步：执行认证绑定
终端运行：opencode auth login → 选 other → 输入 ID volcengine（必须和 JSON 中 provider 的 name 一致）→ 粘贴同一份 Access Key。
最后重启 OpenCode，配置立即生效。
