OpenClaw

本文介绍如何在 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#

需配置的信息#

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

Base URL：https://ark.cn-beijing.volces.com/api/plan/v3。
API Key：获取专属 API Key。
Model：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

方式 1：一键配置（推荐）#

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

安装 Ark CLI

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

1
2npm install -g @volcengine/ark-cli@latest
arkcli --version

1arkcli auth login

一键配置 OpenClaw

1arkcli helper

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：agent-plan-team_cn-beijing_team。
选择默认 model：按需选择。
选择 AI Agent：OpenClaw。
支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

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

方式 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-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"
  }
}

配置完成后，先保存配置文件，然后单击 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-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"
  }
}

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

使用 OpenClaw#

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

1
2
3
openclaw dashboard

打开 TUI，并查看 Gateway 状态。

1
2
3
4
openclaw tui
/status

其他操作#

切换模型#

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

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

前提条件：根据配置 OpenClaw 步骤完成文件配置，其中agents.defaults.models包含支持的模型列表。
- 方式一：全局配置（永久有效）
  
  在配置文件中直接修改agents.defaults.model.primary为目标模型，修改完成后需要重新启动服务。
  JSON
```
1
2
3
4
5
6
7
8
9{
    "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。
模型切换操作：在订阅页面，选择我的 - 使用配置，选择要使用的模型，切换后3-5分钟即可生效。

配置向量模型#

方舟 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 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见配置视觉模型。

接入飞书机器人#

前置准备#

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

安装飞书插件#

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