# OpenClaw

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

本文介绍如何在 OpenClaw 中配置并使用方舟按量计费模型服务。

<span id="prerequisites"></span>
# 前提条件

在配置工具前，需要 [开通所需的模型服务](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)。

<span id="b51c87f8"></span>
# 安装 OpenClaw

前提条件：安装 [Node.js 22 或更新版本](https://nodejs.org/en/download/)。
1. 执行以下命令安装 OpenClaw。

**选项：macOS / Linux**

```Bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

**选项：Windows**

Windows PowerShell 环境下安装命令如下：

```Bash
iwr -useb https://openclaw.ai/install.ps1 | iex
```

2. 根据提示信息完成 OpenClaw 配置，配置信息如下。

> **注意**
>
> OpenClaw 在不断迭代，如果实际使用与以下配置存在差异，可以选择 "Skip" 或默认选项完成配置流程，后续可以参考文档配置并使用 按量计费模型服务。

      |提示信息 |配置 |
      |---|---|
      |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"。 |

<span id="48c0b1ea"></span>
# 配置 OpenClaw

<span id="configuration-information"></span>
## 需配置的信息

如您对 OpenClaw 熟悉，或本地已有配置，可获取以下信息直接配置。

* **Base URL**：`https://ark.cn-beijing.volces.com/api/v3`。
* **API Key**：[获取API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。
* **Model**：按需选择模型并获取 Model ID。可用模型参见[模型列表](/docs/model-list)。

<span id="method-2-manual"></span>
## 手动配置
按量计费模型服务兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
两类 API 的配置方式基本一致，只需在 `models.providers` 中指定对应的 API 适配器：
- Responses API 配置：`"api": "openai-responses"`
- Chat API 配置：`"api": "openai-completions"`

> **注意**
>
> 部分模型支持开启 1M 上下文窗口，可用于包含大型代码库的长会话，可通过 `contextWindow` 字段显式指定窗口大小。

**选项：Web UI 方式**

1. 执行以下命令打开 Web UI。

```Bash
openclaw dashboard
```

2. 在左侧菜单栏选择**配置** - **Settings** - **Advanced**，单击 **Open** 查看并修改配置信息。具体配置信息如下，其中需要将`<ARK_API_KEY>`替换为您的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)，并将 `doubao-seed-evolving` 替换为需要使用的 Model ID。

> **注意**
>
> 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新`models`、`agents` 和 `gateway` 节点信息。其中`models`节点包含支持的模型列表。

以下是 Responses API 的配置示例。

```JSON
{
  "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"
  }
}
```

3. 配置完成后，先保存配置文件，然后单击 **Update** 更新配置，配置更新完成后需要重新连接服务进入 Web UI。

  ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/be24b57cff314b749016abd2fd3ada7a~tplv-goo7wpa0wc-image.image)

**选项：终端方式**

1. 在终端执行以下命令打开 OpenClaw 配置文件。

```Bash
nano ~/.openclaw/openclaw.json
```

2. 修改配置信息，完成 按量计费模型服务对接。将`<ARK_API_KEY>`替换为您的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)，并将 `doubao-seed-evolving` 替换为需要使用的 Model ID。

> **注意**
>
> 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新`models`、`agents` 和 `gateway` 节点信息。其中`models`节点包含支持的模型列表。

以下是 Responses API 的配置示例。

```JSON
{
  "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"
  }
}
```

3. 配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。

    ```Bash
    openclaw gateway restart
    ```

<span id="use-openclaw"></span>
# 使用 OpenClaw

* 打开 Web UI，在 Chat 页面进行交互。

```Bash

openclaw dashboard

```

* 打开 TUI，并查看 Gateway 状态。

```Bash

openclaw tui
/status

```

<span id="other-operations"></span>
# 其他操作

<span id="skill"></span>
## 接入 Skill

若内置工具未覆盖您的使用场景，OpenClaw 支持 Skill 配置：在安装向导中选择 **Configure skills now**，或后续在设置中配置，具体操作参考 OpenClaw 官方文档。