volcengine-config

# 火山引擎配置

## 概述

引导用户完成在 OpenClaw 中配置火山引擎（方舟 Coding Plan）大模型的全流程，从注册到 API key 配置。本技能提供完整的入职引导，包含清晰的说明、定价信息和自动化配置命令。

## 工作流程

### 第一步：确定当前状态

首先检查用户是否已有火山引擎 API key：

- **如果用户已提供 API key：** 跳到第四步（配置）
- **如果用户没有 API key：** 继续完整注册流程（第二步-第三步）

### 第二步：注册并订阅（无 API key）

如果用户没有火山引擎账号或 API key，引导他们完成：

**注册链接：** https://volcengine.com/L/iVVhlP5SI_o/

**订阅步骤：**

1. 访问注册链接
2. 输入手机号并注册
3. 点击"立即订阅"
4. 选择 **lite 套餐**（ Lite Plan）- 约 ¥10/月
5. 完成实名认证
6. 完成支付

**关于 Lite 套餐：**

- **定价模式：** 月度订阅（非按量计费），用户可以放心使用
- **包含模型：**
  - glm-4.7（默认推荐）
  - kimi-k2.5
  - kimi-k2
  - deepseek-v3.2
  - doubao-seed-code
  - 以及更多模型
- **用量限制：**
  - 每 5 小时：约 1,200 次请求
  - 每周：约 9,000 次请求
  - 每订阅月：约 18,000 次请求
- **适用性：** 足够中等强度的开发任务使用，适合大多数用户

**更多详情：** https://www.volcengine.com/docs/82379/2165245?lang=zh#628bdbe3

### 第三步：创建 API Key

订阅完成后，引导用户创建 API key：

**控制台链接：** https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey

**步骤：**

1. 访问火山引擎方舟控制台
2. 进入 API Key 部分
3. 创建新的 API key
4. 将 API key 提供给 OpenClaw

### 第四步：配置并重启

当用户提供 API key 后，告知他们执行流程：

**执行前提醒：**
告诉用户你将执行配置命令并重启网关。提醒用户重启后如果没有响应，可以发送消息唤醒你。

**配置命令：**

其中，将 `<API_KEY>` 替换为用户提供的实际 API key；将`<existing alias>`替换为用户当前已经配置的别名（使用` openclaw config get agents.defaults.models`来查看已有的别名）。

```bash
openclaw config set models.providers.volcengine --json '{
    "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", 
    "apiKey": "<API_KEY>",
    "api": "openai-completions",
    "models": [ 
        { "id": "doubao-seed-code", "name": "Doubao-Seed-...