一、配置步骤

1.获取方舟 API Key

• 登录 方舟控制台（https://console.volcengine.com/ark/）
• 选择API Key管理 → 创建 API Key
• 立即复制保存

2.编辑 OpenClaw 配置文件

路径：~/.openclaw/openclaw.json

{
 "models": {
  "providers": {
   "doubao": {
    "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
    "apiKey": "你的API_KEY",
    "api": "openai-completions",
    "models": [
     { "id": "ark-code-latest", "name": "ark-code-latest" }
    ]
   }
  }
 },
 "agents": {
  "defaults": {
   "model": {
    "primary": "doubao/ark-code-latest"
   },
   "models": {
    "doubao/ark-code-latest": {
     "alias": "doubao"
    }
   }
  }
 }
}

3.重启 OpenClaw

openclaw gateway restart

---

4.关键注意点

• baseUrl 必须用 Coding Plan 专用端点：

  "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3"
  

  ❌ 错误：/api/v3（通用端点） ✅ 正确：/api/coding/v3（Coding Plan 专用）
• 模型建议用 ark-code-latest： 方舟升级模型时自动切换，无需改配置。

---

5.验证连接

5.1 检查网关状态

openclaw gateway status

显示 running 即正常。

5.2 测试对话

openclaw chat

输入任意代码问题，看是否有响应。

5.3 查看日志

openclaw logs --follow

排查连接问题。

---

6.常见问题

Q1: 连接失败，提示 404

• 原因：用了错误的 API 端点。
• 解决：确认 baseUrl 是 /api/coding/v3，不是 /api/v3。

Q2: 403 Forbidden

• 原因：API Key 权限不足或复制不完整。
• 解决：
  1. 检查 Key 是否完整（无多余空格）
  2. 确认 Coding Plan 已开通
  3. 重新创建 Key 试试

Q3: 响应慢或超时

• 原因：网络问题或模型加载中。
• 解决：
  1. 检查网络连接
  2. 企业内网可能需要配置代理
  3. 等待 1-2 分钟后重试

Q4: 如何切换模型 在方舟控制台 Coding Plan 页面切换默认模型（如 Kimi-K2.5），配置无需改动。

---

总结 配置完成。现在 OpenClaw 使用的是方舟 Coding Plan，代码补全、生成、解释都更准更快。有用就点个赞 👍