OpenClaw

OpenClaw（原 Clawdbot）是一款开源、自托管的个人 AI 助手，可以在本地计算机上运行，兼容 macOS、Windows 及 Linux 等多种系统，支持接入常用聊天工具，除了内置多种 Agent 常用工具外，还可以通过插件和 Skill 扩展更多能力。
方舟 Coding Plan 支持在 OpenClaw 中使用，可参考本文进行配置及使用。

核心配置#

接入工具的核心参数如下：

模型配置#

支持以下两种方式配置模型：

在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：

doubao-seed-evolving
doubao-seed-2.1-pro
doubao-seed-2.1-lite
doubao-seed-2.0-mini
minimax-m3
glm-5.3 (glm-latest)
glm-5.3-flash
deepseek-v4.1-flash
deepseek-v4-flash
deepseek-v4-pro
kimi-k2.8-preview
kimi-k3

在配置文件中指定模型为ark-code-latest。
通过开通管理页面选择或切换目标模型，切换模型后 3-5 分钟即可生效。
支持 Auto 模式，通过「效果 + 速度」双维度智能算法自动选择模型。

Base URL#

不同的工具配置的 Base URL 根据兼容的协议会有不同：

兼容 Anthropic 接口协议工具：https://ark.cn-beijing.volces.com/api/coding
兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3

API Key#

获取 API Key

一、安装 OpenClaw#

前提条件：安装 Node.js 22 或更新版本。

执行以下命令安装 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#

根据操作系统选择合适的方式完成工具配置后，配置文件中会包含 Coding Plan 支持的完整的模型列表，便于快速切换目标模型。

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

ArkCLI Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding 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）：选择 coding-plan。
运行 ArkCLI Helper，根据界面提示完成 OpenClaw 的配置。
1. 在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。
2. 选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。
3. 选择默认 model：按需选择。
4. 选择要配置的 AI Agent：OpenClaw。

完成上述操作后，将自动完成 OpenClaw 的基础配置，无需手动安装。

方式 2：手动配置#

Coding 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

在左侧菜单栏选择配置 - Advanced - Raw或者配置 - 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
175{
  "models": {
    "providers": {
      "volcengine-plan": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/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-2.0-mini",
            "name": "doubao-seed-2.0-mini",
            "contextWindow": 256000,
            "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-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": "deepseek-v4.1-flash",
            "name": "deepseek-v4.1-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "minimax-m3",
            "name": "minimax-m3",
            "contextWindow": 1024000,
            "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",
            "name": "kimi-k3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-plan/ark-code-latest"
      },
      "models": {
        "volcengine-plan/ark-code-latest": {},
        "volcengine-plan/doubao-seed-2.1-pro": {},
        "volcengine-plan/doubao-seed-2.1-lite": {},
        "volcengine-plan/doubao-seed-2.0-mini": {},
        "volcengine-plan/doubao-seed-evolving": {},
        "volcengine-plan/glm-5.3": {},
        "volcengine-plan/glm-5.3-flash": {},
        "volcengine-plan/glm-latest": {},
        "volcengine-plan/minimax-m3": {},
        "volcengine-plan/kimi-k2.8-preview": {},
        "volcengine-plan/kimi-k3": {},
        "volcengine-plan/deepseek-v4.1-flash": {},
        "volcengine-plan/deepseek-v4-flash": {},
        "volcengine-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

配置完成后，先单击右上角 Save 保存，保存完成后单击 Update 更新配置。

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

1nano ~/.openclaw/openclaw.json

修改配置信息，完成 Coding 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
175{
  "models": {
    "providers": {
      "volcengine-plan": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/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-2.0-mini",
            "name": "doubao-seed-2.0-mini",
            "contextWindow": 256000,
            "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-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": "deepseek-v4.1-flash",
            "name": "deepseek-v4.1-flash",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          },
          {
            "id": "minimax-m3",
            "name": "minimax-m3",
            "contextWindow": 1024000,
            "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",
            "name": "kimi-k3",
            "contextWindow": 1024000,
            "maxTokens": 65536,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcengine-plan/ark-code-latest"
      },
      "models": {
        "volcengine-plan/ark-code-latest": {},
        "volcengine-plan/doubao-seed-2.1-pro": {},
        "volcengine-plan/doubao-seed-2.1-lite": {},
        "volcengine-plan/doubao-seed-2.0-mini": {},
        "volcengine-plan/doubao-seed-evolving": {},
        "volcengine-plan/glm-5.3": {},
        "volcengine-plan/glm-5.3-flash": {},
        "volcengine-plan/glm-latest": {},
        "volcengine-plan/minimax-m3": {},
        "volcengine-plan/kimi-k2.8-preview": {},
        "volcengine-plan/kimi-k3": {},
        "volcengine-plan/deepseek-v4.1-flash": {},
        "volcengine-plan/deepseek-v4-flash": {},
        "volcengine-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

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

三、使用 OpenClaw#

开始使用#

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

1openclaw dashboard

打开 TUI，并查看 Gateway 状态。

1
2openclaw 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-plan/doubao-seed-2.1-pro"
            }
        }
    }
}
```
- 方式二：在当前会话切换模型（临时有效）
  
  在终端执行openclaw tui后，通过/models切换模型，当界面返回 "model set to <Model_Name>" 时，表示配置生效。

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

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

其他操作#

接入飞书机器人#

前置准备#

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

安装飞书插件#

执行以下命令安装飞书插件。
Bash
```
1npx -y @larksuite/openclaw-lark-tools install
```
如果执行命令时报错，可在命令行前增加sudo重新执行。
根据界面提示信息，选择新建机器人。

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

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

高级配置：配置 Embedding 模型#

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

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

在左侧菜单栏选择配置 - All Settings - Raw，在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/coding/v3",
          "apiKey": "<ARK_API_KEY>"
        }
      }
      ...
    }
  }
  ...
 }

配置完成后，先单击右上角 Save 保存，保存完成后单击 Update 更新配置。

在终端执行以下命令打开 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/coding/v3",
          "apiKey": "<ARK_API_KEY>"
        }
      }
      ...
    }
  }
  ...
}

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

常见问题#

OpenClaw 配置问题#

飞书插件使用问题#

Ark Helper 使用问题#

错误码#

在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考错误码。

OpenClaw

核心配置#

模型配置#

Base URL#

API Key#

一、安装 OpenClaw#

二、 配置 OpenClaw#

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

方式 2：手动配置#

三、使用 OpenClaw#

开始使用#

切换模型#

其他操作#

接入飞书机器人#

前置准备#

安装飞书插件#

高级配置：配置 Embedding 模型#

常见问题#

OpenClaw 配置问题#

飞书插件使用问题#

Ark Helper 使用问题#

错误码#

二、配置 OpenClaw#