文档中心

火山方舟

接入 AI 工具

OpenClaw

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

方舟 Coding Plan 支持在 OpenClaw 中使用，可参考本文进行配置及使用。

说明

需要先访问方舟 Coding Plan活动，按需订阅套餐后再配置使用编程工具。

核心配置

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

模型配置

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

配置 Model Name (配置文件指定)

配置 ark-code-latest (控制台管理)

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

注意

配置 Model Name 时，支持使用全小写格式，同时也支持直接复制中的模型名称。

doubao-seed-evolving

doubao-seed-2.1-pro

doubao-seed-2.1-lite

doubao-seed-2.0-mini

glm-5.3 (glm-latest)

glm-5.3-flash

deepseek-v4.1-flash

deepseek-v4.1-flash-economy

deepseek-v4-flash

deepseek-v4-pro

kimi-k2.8-preview

kimi-k3

kimi-k3.1-pro

说明

Model Name 不支持配置为 Auto，如需使用，请通过控制台切换该模式。

Base URL

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

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

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

注意

请勿使用 https://ark.cn-beijing.volces.com/api/v3 ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。

API Key

获取 API Key

一、安装 OpenClaw

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

执行以下命令安装 OpenClaw。

macOS / Linux

Windows

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

注意

OpenClaw 在不断迭代，如果实际使用与以下配置存在差异，可以选择 "Skip" 或默认选项完成配置流程，后续可以参考文档配置并使用 Coding 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"。

二、配置 OpenClaw

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

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

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

注意

ArkCLI Helper 是基于 Ark Helper 升级演进的工具配置服务，相关能力将持续在 ArkCLI Helper 上迭代更新。建议优先使用 ArkCLI Helper 完成工具配置。

ArkCLI Helper 支持 macOS、Linux、Windows 系统。

安装 Ark CLI。

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

# 2. 验证安装
arkcli --version

arkcli auth login

根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 arkcli config reset 后再运行 arkcli auth login。首次登录时，按提示完成以下配置：

选择项目（Project）：可按需选择，或默认选择账号全部资源。

选择消费模式（Type）：选择 coding-plan。

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

在命令行界面输入 arkcli helper 命令，启动 ArkCLI Helper。

选择要配置的 Plan profile：选择 coding-plan_cn-beijing_personal (Coding Plan)。

选择默认 model：按需选择。

选择要配置的 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"

注意

glm-5.3、deepseek-v4-flash、deepseek-v4-pro、kimi-k3.1-pro、kimi-k3、kimi-k2.8-preview 支持 1M 上下文窗口用于包含大型代码库的长会话，可以通过 contextWindow 字段显式指定窗口大小。

Web UI 方式

终端方式

执行以下命令打开 Web UI。

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

注意

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

OpenClaw 如何开启深度思考模式？

在 OpenClaw 中无法识别图片，如何处理？

配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？

以下是 Responses API 的配置示例。

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

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

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

注意

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

OpenClaw 如何开启深度思考模式？

在 OpenClaw 中无法识别图片，如何处理？

配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？

以下是 Responses API 的配置示例。

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

openclaw gateway restart

三、使用 OpenClaw

开始使用

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

打开 TUI，并查看 Gateway 状态。

切换模型

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

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

前提条件：根据二、配置 OpenClaw 步骤完成文件配置，其中agents.defaults.models包含支持的模型列表。

方式一：全局配置（永久有效）

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

{
"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。

注意

飞书插件处于快速迭代阶段，本文使用的插件版本为 2026.3.10，如果实际使用与以下步骤存在差异，可参见 OpenClaw 飞书官网插件。

安装飞书插件

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

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

如果执行命令时报错，可在命令行前增加sudo重新执行。

根据界面提示信息，选择新建机器人。

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

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

在飞书中向机器人发送消息，开始对话。

高级配置：配置 Embedding 模型

方舟 Coding Plan 提供的 doubao-embedding-vision 模型（向量模型）可以为 OpenClaw 提供语义向量能力，将对话、文档与任务信息转换为高维向量表示，实现基于语义相似度的高效检索。

相比传统关键词匹配，Embedding 检索在信息量大、对话长、资料分散的场景下，能够更准确地召回相关内容，显著降低遗漏与误判。同时，Embedding 为记忆检索、知识库问答与工具调用提供统一的语义索引层，帮助 OpenClaw 在不增加主模型推理成本的前提下，提升跨轮次上下文追踪能力与整体效果。

选择以下任一方式配置向量模型。

Web UI 方式

终端方式

执行以下命令打开 Web UI。

openclaw dashboard

在左侧菜单栏选择配置 - All Settings - Raw，在agents.defaults节点下增加 memorySearch相关配置信息，增加的配置信息如下。其中需要将<ARK_API_KEY>替换为您自己的 API Key。

{
...
"agents": {
"defaults": {
...
"memorySearch": {
"provider": "openai",
"model": "doubao-embedding-vision",
"remote": {
"baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
"apiKey": "<ARK_API_KEY>"
}
}
...
}
}
...
}