You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
接入 AI 工具
OpenClaw
复制全文
下载 pdf
OpenClaw
本文介绍如何在 OpenClaw 中配置并使用方舟按量计费模型服务。​
前提条件​
在配置工具前,需要 开通所需的模型服务。​
安装 OpenClaw​
前提条件:安装 Node.js 22 或更新版本。​
  1. 执行以下命令安装 OpenClaw。​
​
macOS / Linux
Windows
​
​
curl -fsSL https://openclaw.ai/install.sh | bash​
​
​
  1. 根据提示信息完成 OpenClaw 配置,配置信息如下。​
注意​
OpenClaw 在不断迭代,如果实际使用与以下配置存在差异,可以选择 "Skip" 或默认选项完成配置流程,后续可以参考文档配置并使用 按量计费模型服务。​
​
<span aceTableMode="table" aceTableWidth="3,3"></span>​
|提示信息 |配置 |​
|---|---|​
|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。​
  • Model:按需选择模型并获取 Model ID。可用模型参见模型列表。​
方式 1:一键配置(推荐)​
Ark CLI 是火山方舟平台官方命令行工具,支持在本地终端快速完成认证与资源管理,并可将能力安装到常用 AI Agent 中,降低手动配置的时间成本和出错风险。​
  1. 安装 Ark CLI​
  • 环境要求:Node.js 18 或更新版本。支持 macOS、Linux、Windows。​
​
npm install -g @volcengine/ark-cli@latest​
arkcli --version​
​
  1. 登录 Ark CLI​
  • 根据界面提示选择登录方式,推荐选择 火山 SSO (浏览器登录),在浏览器中完成授权即可。​
​
arkcli auth login​
​
  1. 一键配置 OpenClaw​
​
arkcli helper​
​
运行 ArkCLI Helper,根据界面提示完成配置。​
  • 选择 Profile:platform_cn-beijing_accountwide。​
  • 选择 Endpoint:按需选择要使用的推理接入点。​
  • 选择 AI Agent:OpenClaw。​
配置完成后,OpenClaw 会自动识别配置的模型。启动 OpenClaw 即可使用。​
方式 2:手动配置​
按量计费模型服务兼容 OpenAI 接口协议,支持 Responses API、Chat API。推荐使用 Responses API 的配置,推理效果更好。​
两类 API 的配置方式基本一致,只需在 models.providers 中指定对应的 API 适配器:​
  • Responses API 配置:"api": "openai-responses"​
  • Chat API 配置:"api": "openai-completions"​
​
Web UI 方式
终端方式
​
  1. 执行以下命令打开 Web UI。​
​
openclaw dashboard​
​
  1. 在左侧菜单栏选择配置 - Settings - Advanced,单击 Open 查看并修改配置信息。具体配置信息如下,其中需要将<ARK_API_KEY>替换为您的 API Key,并将 doubao-seed-evolving 替换为需要使用的 Model ID。​
注意​
如果已经配置过 OpenClaw,请勿直接覆盖原有配置,建议根据提供的配置更新models、agents 和 gateway 节点信息。其中models节点包含支持的模型列表。​
以下是 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"​
}​
}​
​
  1. 配置完成后,先保存配置文件,然后单击 Update 更新配置,配置更新完成后需要重新连接服务进入 Web UI。​
​Image​​
​
使用 OpenClaw​
  • 打开 Web UI,在 Chat 页面进行交互。​
​
​
openclaw dashboard​
​
​
  • 打开 TUI,并查看 Gateway 状态。​
​
​
openclaw tui​
/status​
​
​
其他操作​
接入 Skill​
若内置工具未覆盖您的使用场景,OpenClaw 支持 Skill 配置:在安装向导中选择 Configure skills now,或后续在设置中配置,具体操作参考 OpenClaw 官方文档。​
​
最近更新时间:2026.11.03 21:11:08
这个页面对您有帮助吗?
有用
有用
无用
无用