本文介绍如何在 OpenClaw 中配置并使用方舟按量计费模型服务。
前提条件#
在配置工具前，需要 开通所需的模型服务。
安装 OpenClaw#
前提条件：安装 Node.js 22 或更新版本。
- 执行以下命令安装 OpenClaw。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell 环境下安装命令如下：
iwr -useb https://openclaw.ai/install.ps1 | iex
- 根据提示信息完成 OpenClaw 配置，配置信息如下。
| 提示信息 | 配置 |
|---|---|
| I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? | 选择 "Yes" |
| Setup mode | 选择 “QuickStart” |
| Model/auth provider | 选择 "Skip for now"，后续可以配置。 |
| Default model | 选择 "Keep current" |
| Select channel (QuickStart) | 选择 “Skip for now”，后续可以配置。 |
| Search provider | 选择 “Skip for now” |
| Configure skills now? (recommended) | 选择 “No”，后续可以配置。 |
| Enable hooks? | 选择 "Skip for now"。选择方式：按空格键选中选项，按回车键进入下一步。 |
| How do you want to hatch your bot? | 选择 "Hatch in Terminal"。 |
配置 OpenClaw#
需配置的信息#
如您对 OpenClaw 熟悉，或本地已有配置，可获取以下信息直接配置。
- Base URL：
https://ark.cn-beijing.volces.com/api/v3。 - API Key：获取API Key。
- Model：按需选择模型并获取 Model ID。可用模型参见模型列表。
手动配置#
按量计费模型服务兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
两类 API 的配置方式基本一致，只需在 models.providers 中指定对应的 API 适配器：
- Responses API 配置：
"api": "openai-responses" - Chat API 配置：
"api": "openai-completions"
- 执行以下命令打开 Web UI。
openclaw dashboard
- 在左侧菜单栏选择配置 - Settings - Advanced，单击 Open 查看并修改配置信息。具体配置信息如下，其中需要将
<ARK_API_KEY>替换为您的 API Key，并将doubao-seed-evolving替换为需要使用的 Model ID。
以下是 Responses API 的配置示例。
{
"models": {
"providers": {
"volcengine": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "<ARK_API_KEY>",
"api": "openai-responses",
"models": [
{
"id": "doubao-seed-evolving",
"name": "doubao-seed-evolving"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "volcengine/doubao-seed-evolving"
},
"models": {
"volcengine/doubao-seed-evolving": {}
}
}
},
"gateway": {
"mode": "local"
}
}
- 配置完成后，先保存配置文件，然后单击 Update 更新配置，配置更新完成后需要重新连接服务进入 Web UI。
- 在终端执行以下命令打开 OpenClaw 配置文件。
nano ~/.openclaw/openclaw.json
- 修改配置信息，完成 按量计费模型服务对接。将
<ARK_API_KEY>替换为您的 API Key，并将doubao-seed-evolving替换为需要使用的 Model ID。
以下是 Responses API 的配置示例。
{
"models": {
"providers": {
"volcengine": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
"apiKey": "<ARK_API_KEY>",
"api": "openai-responses",
"models": [
{
"id": "doubao-seed-evolving",
"name": "doubao-seed-evolving"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "volcengine/doubao-seed-evolving"
},
"models": {
"volcengine/doubao-seed-evolving": {}
}
}
},
"gateway": {
"mode": "local"
}
}
-
配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。
openclaw gateway restart
使用 OpenClaw#
- 打开 Web UI，在 Chat 页面进行交互。
openclaw dashboard
- 打开 TUI，并查看 Gateway 状态。
openclaw tui
/status
其他操作#
接入 Skill#
若内置工具未覆盖您的使用场景，OpenClaw 支持 Skill 配置：在安装向导中选择 Configure skills now，或后续在设置中配置，具体操作参考 OpenClaw 官方文档。