# OpenClaw

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

本文介绍如何在 OpenClaw 中配置并使用方舟 Agent Plan 企业版。

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

需由管理员账号完成以下前置操作后，子账号方可配置并使用 OpenClaw：

1. 购买方舟 Agent Plan 企业版套餐：[一、购买 Agent Plan 企业版](/docs/agent-plan-enterprise-get-started#purchase-plan)。
2. 为子账号分配席位：[二、分配席位](/docs/agent-plan-enterprise-get-started#assign-seats)。

<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" 或默认选项完成配置流程，后续可以参考文档配置并使用 Agent Plan 企业版。

      |提示信息 |配置 |
      |---|---|
      |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/plan/v3`。
* **API Key**：[获取专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
* **Model**：配置文本生成模型。可配置 `ark-code-latest` 或 Model Name，模型信息参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。

<span id="method-1-auto-helper"></span>
## 方式 1：一键配置（推荐）

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

1. 安装 Ark CLI

    环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

```Bash
npm install -g @volcengine/ark-cli@latest
arkcli --version
```

2. 登录 Ark CLI

    根据界面提示选择登录方式，推荐选择 **火山 SSO (浏览器登录)**，在浏览器中完成授权即可。

```Bash
arkcli auth login
```

3. 一键配置 OpenClaw

```Bash
arkcli helper
```
运行 ArkCLI Helper，根据界面提示完成配置。
* **选择 Profile**：`agent-plan-team_cn-beijing_team`。
* **选择默认 model**：按需选择。
* **选择 AI Agent**：`OpenClaw`。
    支持配置 Harness 能力，根据界面提示按需选择`配置`或者`跳过`。

配置完成后，OpenClaw 会自动识别配置的模型。启动 OpenClaw 即可使用。

<span id="method-2-manual"></span>
## 方式 2：手动配置
Agent Plan 企业版兼容 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。

```Bash
openclaw dashboard
```

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

  ![image-20260909-103103-932.png](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/agent-plan-enterprise-api-key.png)

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

以下是 Responses API 的配置示例。

```JSON
{
  "models": {
    "providers": {
      "volcengine-enterprise-agent-plan": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
        "apiKey": "<ARK_API_KEY>",
        "api": "openai-responses",
        "models": [
          {
            "id": "ark-code-latest",
            "name": "ark-code-latest",
            "contextWindow": 256000,
            "maxTokens": 32000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.1-pro",
            "name": "doubao-seed-2.1-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.1-lite",
            "name": "doubao-seed-2.1-lite",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-evolving",
            "name": "doubao-seed-evolving",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "glm-5.3",
            "name": "glm-5.3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "glm-5.3-flash",
            "name": "glm-5.3-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "glm-latest",
            "name": "glm-latest",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "deepseek-v4.1-flash",
            "name": "deepseek-v4.1-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "deepseek-v4.1-flash-economy",
            "name": "deepseek-v4.1-flash-economy",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "doubao-seed-2.0-mini",
            "name": "doubao-seed-2.0-mini",
            "contextWindow": 256000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k2.8-preview",
            "name": "kimi-k2.8-preview",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k3.1-pro",
            "name": "kimi-k3.1-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-enterprise-agent-plan/ark-code-latest"
      },
      "models": {
        "volcengine-enterprise-agent-plan/ark-code-latest": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.1-pro": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.1-lite": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.0-mini": {},
        "volcengine-enterprise-agent-plan/glm-5.3": {},
        "volcengine-enterprise-agent-plan/glm-5.3-flash": {},
        "volcengine-enterprise-agent-plan/glm-latest": {},
        "volcengine-enterprise-agent-plan/kimi-k2.8-preview": {},
        "volcengine-enterprise-agent-plan/kimi-k3.1-pro": {},
        "volcengine-enterprise-agent-plan/deepseek-v4.1-flash": {},
        "volcengine-enterprise-agent-plan/deepseek-v4.1-flash-economy": {},
        "volcengine-enterprise-agent-plan/deepseek-v4-flash": {},
        "volcengine-enterprise-agent-plan/deepseek-v4-pro": {}
      }
    }
  },
  "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. 修改配置信息，完成 Agent Plan 企业版对接。将`<ARK_API_KEY>`替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
    ![image-20260909-103103-932.png](https://arkdocs.tos-cn-beijing.volces.com/images/agent-plan/agent-plan-enterprise-api-key.png)

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

以下是 Responses API 的配置示例。

```JSON
{
  "models": {
    "providers": {
      "volcengine-enterprise-agent-plan": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
        "apiKey": "<ARK_API_KEY>",
        "api": "openai-responses",
        "models": [
          {
            "id": "ark-code-latest",
            "name": "ark-code-latest",
            "contextWindow": 256000,
            "maxTokens": 32000,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.1-pro",
            "name": "doubao-seed-2.1-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-2.1-lite",
            "name": "doubao-seed-2.1-lite",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "doubao-seed-evolving",
            "name": "doubao-seed-evolving",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "glm-5.3",
            "name": "glm-5.3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "glm-5.3-flash",
            "name": "glm-5.3-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "glm-latest",
            "name": "glm-latest",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "deepseek-v4.1-flash",
            "name": "deepseek-v4.1-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "deepseek-v4.1-flash-economy",
            "name": "deepseek-v4.1-flash-economy",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text"
            ]
          },
          {
            "id": "doubao-seed-2.0-mini",
            "name": "doubao-seed-2.0-mini",
            "contextWindow": 256000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k2.8-preview",
            "name": "kimi-k2.8-preview",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k3.1-pro",
            "name": "kimi-k3.1-pro",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-enterprise-agent-plan/ark-code-latest"
      },
      "models": {
        "volcengine-enterprise-agent-plan/ark-code-latest": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.1-pro": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.1-lite": {},
        "volcengine-enterprise-agent-plan/doubao-seed-2.0-mini": {},
        "volcengine-enterprise-agent-plan/glm-5.3": {},
        "volcengine-enterprise-agent-plan/glm-5.3-flash": {},
        "volcengine-enterprise-agent-plan/glm-latest": {},
        "volcengine-enterprise-agent-plan/kimi-k2.8-preview": {},
        "volcengine-enterprise-agent-plan/kimi-k3.1-pro": {},
        "volcengine-enterprise-agent-plan/deepseek-v4.1-flash": {},
        "volcengine-enterprise-agent-plan/deepseek-v4.1-flash-economy": {},
        "volcengine-enterprise-agent-plan/deepseek-v4-flash": {},
        "volcengine-enterprise-agent-plan/deepseek-v4-pro": {}
      }
    }
  },
  "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="switch-model"></span>
## 切换模型

请根据模型配置方式，选择对应的模型切换方案。
* 模型配置：Model Name，支持以下两种方式切换模型。

  前提条件：根据 [配置 OpenClaw](/docs/agent-plan-enterprise-openclaw#48c0b1ea) 步骤完成文件配置，其中`agents.defaults.models`包含支持的模型列表。
  * 方式一：全局配置（永久有效）

    在配置文件中直接修改`agents.defaults.model.primary`为目标模型，修改完成后需要重新启动服务。

    ```JSON
    {
        "agents": {
            "defaults": {
                "model": {
                    "primary": "volcengine-enterprise-agent-plan/doubao-seed-2.1-pro"
                }
            }
        }
    }
    ```

  * 方式二：在当前会话切换模型（临时有效）

    在终端执行`openclaw tui`后，通过`/models`切换模型，当界面返回 "model set to <Model_Name>" 时，表示配置生效。

* 模型配置：`volcengine-enterprise-agent-plan/ark-code-latest`，通过控制台切换模型。

  配置文件中`agents.defaults.model.primary`为`volcengine-enterprise-agent-plan/ark-code-latest`。
  模型切换操作：在 [订阅页面](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise?agentMode=close)，选择**我的** - **使用配置**，选择要使用的模型，切换后3-5分钟即可生效。

<span id="embedding-model"></span>
## 配置向量模型
方舟 Agent Plan 企业版提供的 `doubao-embedding-vision` 模型（向量模型）可以为 OpenClaw 提供语义向量能力，将对话、文档与任务信息转换为高维向量表示，实现基于语义相似度的高效检索。
相比传统关键词匹配，Embedding 检索在信息量大、对话长、资料分散的场景下，能够更准确地召回相关内容，显著降低遗漏与误判。同时，Embedding 为记忆检索、知识库问答与工具调用提供统一的语义索引层，帮助 OpenClaw 在不增加主模型推理成本的前提下，提升跨轮次上下文追踪能力与整体效果。
选择以下任一方式配置向量模型。

**选项：Web UI 方式**

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

    ```Bash
    openclaw dashboard
    ```

2. 在左侧菜单栏选择**配置** - **Settings** - **Advanced**，单击 **Open** 查看并修改配置信息，在`agents.defaults`节点下增加 `memorySearch`相关配置信息，增加的配置信息如下。其中需要将`<ARK_API_KEY>`替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
    ```JSON
    {
      ...
      "agents": {
        "defaults": {
          ...
          "memorySearch": {
            "provider": "openai",
            "model": "doubao-embedding-vision",
            "remote": {
              "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
              "apiKey": "<ARK_API_KEY>"
            }
          }
          ...
        }
      }
      ...
    }
    ```

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

**选项：终端方式**

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

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

2. 在`agents.defaults`节点下增加 `memorySearch`相关配置信息，增加的配置信息如下。其中需要将`<ARK_API_KEY>`替换为您的 [专属 API Key](https://ark.volcengine.com/region:cn-beijing/subscription/agent-plan-enterprise/mine)。
    ```JSON
    {
      ...
      "agents": {
        "defaults": {
          ...
          "memorySearch": {
            "provider": "openai",
            "model": "doubao-embedding-vision",
            "remote": {
              "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
              "apiKey": "<ARK_API_KEY>"
            }
          }
          ...
        }
      }
      ...
    }
    ```

3. 配置完成后，重启网关使配置生效。

    ```Bash
    openclaw gateway restart
    ```

<span id="configure-visual-models"></span>
## 添加图片生成/视频生成能力
方舟 Agent Plan 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见 [配置视觉模型](/docs/agent-plan-enterprise-visual-models)。

> **注意**
>
> * 不同的套餐支持的视觉模型有所不同，具体参见[支持模型及 Harness](/docs/agent-plan-enterprise-plan-overview#supported-models-harness)。
> * 视觉模型不支持通过 Auto 及控制台切换使用。

<span id="connect-feishu-bot"></span>
## 接入飞书机器人

<span id="feishu-bot-prerequisites"></span>
### 前置准备

安装并配置 OpenClaw，参见 [安装 OpenClaw](/docs/agent-plan-enterprise-openclaw#b51c87f8)、[配置 OpenClaw](/docs/agent-plan-enterprise-openclaw#48c0b1ea)。

> **注意**
>
> 飞书插件处于快速迭代阶段，本文使用的插件版本为 **2026.3.10**，如果实际使用与以下步骤存在差异，可参见 [OpenClaw 飞书官网插件](https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh)。

<span id="install-feishu-plugin"></span>
### 安装飞书插件

1. 执行以下命令安装飞书插件。

    ```Bash
    npx -y @larksuite/openclaw-lark-tools install
    ```

    如果执行命令时报错，可在命令行前增加`sudo`重新执行。
2. 根据界面提示信息，选择**新建机器人**。

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

3. 通过飞书客户端扫描二维码，选择**一键创建飞书机器人**。

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

4. 在飞书中向机器人发送`/feishu start`，若返回版本号信息，代表安装成功。
5. 在飞书中向机器人发送消息，开始对话。