| name | volcengine-config |
| description | 引导用户在 OpenClaw 中配置火山引擎（方舟 Coding Plan）大模型。当用户请求设置火山引擎模型、询问如何配置模型提供商，或需要帮助获取火山引擎 API key 时使用。涵盖完整的入职流程：注册、订阅计划选择、API key 创建和自动配置。 |
火山引擎配置
概述
引导用户完成在 OpenClaw 中配置火山引擎（方舟 Coding Plan）大模型的全流程，从注册到 API key 配置。本技能提供完整的入职引导，包含清晰的说明、定价信息和自动化配置命令。
工作流程
第一步：确定当前状态
首先检查用户是否已有火山引擎 API key：
- 如果用户已提供 API key： 跳到第四步（配置）
- 如果用户没有 API key： 继续完整注册流程（第二步-第三步）
第二步：注册并订阅（无 API key）
如果用户没有火山引擎账号或 API key，引导他们完成：
注册链接： https://volcengine.com/L/iVVhlP5SI_o/
订阅步骤：
- 访问注册链接
- 输入手机号并注册
- 点击"立即订阅"
- 选择 lite 套餐（ Lite Plan）- 约 ¥10/月
- 完成实名认证
- 完成支付
关于 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
步骤：
- 访问火山引擎方舟控制台
- 进入 API Key 部分
- 创建新的 API key
- 将 API key 提供给 OpenClaw
第四步：配置并重启
当用户提供 API key 后，告知他们执行流程：
执行前提醒：
告诉用户你将执行配置命令并重启网关。提醒用户重启后如果没有响应，可以发送消息唤醒你。
配置命令：
其中，将 <API_KEY> 替换为用户提供的实际 API key；将<existing alias>替换为用户当前已经配置的别名（使用 openclaw config get agents.defaults.models来查看已有的别名）。
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-Code", "contextWindow": 128000},
{ "id": "glm-4.7", "name": "GLM 4.7", "contextWindow": 128000},
{ "id": "deepseek-v3.2", "name": "Deepseek-V3.2", "contextWindow": 128000},
{ "id": "kimi-k2-thinking", "name": "Kimi-K2-Thinking", "contextWindow": 128000},
{ "id": "kimi-k2.5", "name": "Kimi-K2.5", "contextWindow": 128000}
]
}'
openclaw config set agents.defaults.model.primary 'volcengine/glm-4.7'
openclaw config set 'agents.defaults.models' --json '{
<existing alias>
"volcengine/doubao-seed-code": {"alias": "doubao"},
"volcengine/glm-4.7": {"alias": "glm"},
"volcengine/deepseek-v3.2": {"alias": "deepseek"},
"volcengine/kimi-k2-thinking": {"alias": "kimi2"},
"volcengine/kimi-k2.5": {"alias": "kimi2.5"}
}'
openclaw models set glm
openclaw gateway restart
配置完成后：
重启后，告知用户：
- 可以使用
/model 命令查看所有可用模型
- 可以使用
/model volcengine/<模型全名> 切换模型，例如：/model volcengine/glm-4.7。
- 如果设置了别名，也可以使用更方便的方法：
/model <别名> 切换模型，例如：
/model glm - 切换到 GLM-4.7/model kimi2 - 切换到 Kimi-K2/model kimi2.5 - 切换到 Kimi-K2.5/model deepseek - 切换到 DeepSeek-V3.2/model doubao - 切换到 Doubao-Seed-Code
第五步：验证（可选）
可选择让用户切换到火山引擎模型并测试，以验证配置是否正常工作。
模型别名
可向用户提及的常用模型别名：
| 别名 | 完整模型名称 | 描述 |
|---|
glm | volcengine/glm-4.7 | 默认 GLM-4.7 模型 |
kimi2 | volcengine/kimi-k2-thinking | Kimi K2 模型 |
kimi2.5 | volcengine/kimi-k2.5 | Kimi K2.5 模型 |
deepseek | volcengine/deepseek-v3.2 | DeepSeek V3.2 模型 |
doubao | volcengine/doubao-seed-code | Doubao Seed Code 模型 |
重要提示
- 需要重启： 配置更改需要重启网关才能生效
- 模型可用性： 所有列出的模型都在 Lite 套餐中可用
- 用量监控： 用户可以在火山引擎控制台监控使用情况
- 计划升级： 如果 Lite 套餐限制不足，用户可以在控制台中升级到更高层级的 Pro 套餐
