OpenClaw

本文介绍如何配置方舟 Agent Plan 到 OpenClaw 中使用。

一、前提条件#

您已按需订阅 Agent Plan 套餐。如未，请访问开通管理-Agent Plan 页面订阅套餐。

二、安装 OpenClaw#

执行以下命令安装 OpenClaw。

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

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

1iwr -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#

方式 1：自动化助手（推荐）#

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Agent Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。

安装 Ark CLI。

1
2
3
4
5# 1. 通过 NPM 安装
npm install -g @volcengine/ark-cli@latest

# 2. 验证安装
arkcli --version

登录 Ark CLI。
Bash
```
1arkcli auth login
```
根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：
1. 选择项目（Project）：可按需选择，或默认选择账号全部资源。
2. 选择消费模式（Type）：选择 agent-plan。
运行 ArkCLI Helper，根据界面提示完成 OpenClaw 的配置。
1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
2. 选择要配置的 Plan profile：agent-plan_cn-beijing_personal (Agent Plan)。
3. 选择默认 model：按需选择。
4. 选择要配置的 AI Agent：OpenClaw。
  当前支持的 Harness 包括：豆包搜索、专业数据集、Agent 记忆（OpenViking）、AI Native 应用开发底座，根据界面提示按需选择配置或者跳过。

完成上述操作后，将自动完成 OpenClaw 的基础配置，并按选择结果自动安装对应的 Harness 工具，无需手动安装。

方式 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。

1openclaw dashboard

在左侧菜单栏选择配置 - Settings - Advanced，单击 Open 查看并修改配置信息。具体配置信息如下，其中需要将<ARK_API_KEY>替换为您自己的专属 API Key。

以下是 Responses API 的配置示例。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174{
  "models": {
    "providers": {
      "volcengine-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-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": "minimax-m3",
            "name": "minimax-m3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k3",
            "name": "kimi-k3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k2.8-preview",
            "name": "kimi-k2.8-preview",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-agent-plan/ark-code-latest"
      },
      "models": {
        "volcengine-agent-plan/ark-code-latest": {},
        "volcengine-agent-plan/doubao-seed-2.1-pro": {},
        "volcengine-agent-plan/doubao-seed-2.1-lite": {},
        "volcengine-agent-plan/doubao-seed-2.0-mini": {},
        "volcengine-agent-plan/glm-5.3": {},
        "volcengine-agent-plan/glm-5.3-flash": {},
        "volcengine-agent-plan/glm-latest": {},
        "volcengine-agent-plan/minimax-m3": {},
        "volcengine-agent-plan/kimi-k3": {},
        "volcengine-agent-plan/kimi-k2.8-preview": {},
        "volcengine-agent-plan/deepseek-v4.1-flash": {},
        "volcengine-agent-plan/deepseek-v4-flash": {},
        "volcengine-agent-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

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

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

1nano ~/.openclaw/openclaw.json

修改配置信息，完成 Agent Plan 对接。将<ARK_API_KEY>替换为您自己的专属 API Key。

以下是 Responses API 的配置示例。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174{
  "models": {
    "providers": {
      "volcengine-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-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": "minimax-m3",
            "name": "minimax-m3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k3",
            "name": "kimi-k3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "kimi-k2.8-preview",
            "name": "kimi-k2.8-preview",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-agent-plan/ark-code-latest"
      },
      "models": {
        "volcengine-agent-plan/ark-code-latest": {},
        "volcengine-agent-plan/doubao-seed-2.1-pro": {},
        "volcengine-agent-plan/doubao-seed-2.1-lite": {},
        "volcengine-agent-plan/doubao-seed-2.0-mini": {},
        "volcengine-agent-plan/glm-5.3": {},
        "volcengine-agent-plan/glm-5.3-flash": {},
        "volcengine-agent-plan/glm-latest": {},
        "volcengine-agent-plan/minimax-m3": {},
        "volcengine-agent-plan/kimi-k3": {},
        "volcengine-agent-plan/kimi-k2.8-preview": {},
        "volcengine-agent-plan/deepseek-v4.1-flash": {},
        "volcengine-agent-plan/deepseek-v4-flash": {},
        "volcengine-agent-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。
Bash
```
1openclaw gateway restart
```

四、使用 OpenClaw#

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

1openclaw dashboard

打开 TUI，并查看 Gateway 状态。

1
2openclaw tui
/status

其他操作#

配置向量模型#

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

执行以下命令打开 Web UI。
Bash
```
1openclaw dashboard
```

在左侧菜单栏选择配置 - Settings - Advanced，单击 Open 查看并修改配置信息，在agents.defaults节点下增加 memorySearch相关配置信息，增加的配置信息如下。其中需要将<ARK_API_KEY>替换为您自己的专属 API Key。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18{
  ...
  "agents": {
    "defaults": {
      ...
      "memorySearch": {
        "provider": "openai",
        "model": "doubao-embedding-vision",
        "remote": {
          "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
          "apiKey": "<ARK_API_KEY>"
        }
      }
      ...
    }
  }
  ...
}

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

在终端执行以下命令打开 OpenClaw 配置文件。
Bash
```
1nano ~/.openclaw/openclaw.json
```

在agents.defaults节点下增加 memorySearch相关配置信息，增加的配置信息如下。其中需要将<ARK_API_KEY>替换为您自己的专属 API Key。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18{
  ...
  "agents": {
    "defaults": {
      ...
      "memorySearch": {
        "provider": "openai",
        "model": "doubao-embedding-vision",
        "remote": {
          "baseUrl": "https://ark.cn-beijing.volces.com/api/plan/v3",
          "apiKey": "<ARK_API_KEY>"
        }
      }
      ...
    }
  }
  ...
}

配置完成后，重启网关使配置生效。
Bash
```
1openclaw gateway restart
```

配置视觉模型#

方舟 Agent Plan 提供生图、生视频模型，支持通过 AI 工具的 Skill 接入并使用。具体配置方法请参见配置视觉模型。

切换模型#

请根据语言模型配置方式，选择对应的语言模型切换方案。

模型配置：Model Name，支持以下两种方式切换模型。

前提条件：根据三、配置 OpenClaw步骤完成文件配置，其中agents.defaults.models包含支持的模型列表。
- 方式 1：全局配置（永久有效）
  
  在配置文件中直接修改agents.defaults.model.primary为目标模型，修改完成后需要重新启动服务。
  JSON
```
1
2
3
4
5
6
7
8
9{
    "agents": {
        "defaults": {
            "model": {
                "primary": "volcengine-agent-plan/doubao-seed-2.1-pro"
            }
        }
    }
}
```
- 方式 2：在当前会话切换模型（临时有效）
  
  在终端执行openclaw tui后，通过/models切换模型，当界面返回 "model set to <Model_Name>" 时，表示配置生效。
模型配置：volcengine-agent-plan/ark-code-latest，通过控制台切换模型。

配置文件中agents.defaults.model.primary为volcengine-agent-plan/ark-code-latest。
模型切换操作：在开通管理页面选择要使用的模型，切换后3-5分钟即可生效。

接入飞书机器人#

前置准备#

安装并配置 OpenClaw，参见二、安装 OpenClaw、三、配置 OpenClaw。

安装飞书插件#

执行以下命令安装飞书插件。
Bash
```
1npx -y @larksuite/openclaw-lark-tools install
```
如果执行命令时报错，可在命令行前增加sudo重新执行。
根据界面提示信息，选择新建机器人。
通过飞书客户端扫描二维码，选择一键创建飞书机器人。
在飞书中向机器人发送/feishu start，若返回版本号信息，代表安装成功。
在飞书中向机器人发送消息，开始对话。