# OpenClaw > 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。 [OpenClaw（原 Clawdbot）](https://clawd.bot/) 是一款开源、自托管的个人 AI 助手，可以在本地计算机上运行，兼容 macOS、Windows 及 Linux 等多种系统，支持接入常用聊天工具，除了内置多种 Agent 常用工具外，还可以通过插件和 Skill 扩展更多能力。 方舟 Coding Plan 支持在 OpenClaw 中使用，可参考本文进行配置及使用。 > **说明** > > 需要先访问 [方舟 Coding Plan活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。 # 核心配置 接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型： **选项：配置 Model Name (配置文件指定)** 在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name： > **注意** > > 配置 Model Name 时，支持使用全小写格式，同时也支持直接复制 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 中的模型名称。 * `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` > **说明** > > Model Name 不支持配置为 `Auto`，如需使用，请通过控制台切换该模式。 **选项：配置 ark-code-latest (控制台管理)** 1. 在配置文件中指定模型为`ark-code-latest`。 2. 通过 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 选择或切换目标模型，切换模型后 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` > **注意** > > 请勿使用 `https://ark.cn-beijing.volces.com/api/v3` ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。 ## **API Key** [获取 API Key](https://ark.volcengine.com/region:cn-beijing/apikey) # 一、安装 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" 或默认选项完成配置流程，后续可以参考文档配置并使用 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 系统。 1. 安装 Ark CLI。 ```Bash # 1. 通过 NPM 安装 npm install -g @volcengine/ark-cli@latest # 2. 验证安装 arkcli --version ``` 2. 登录 Ark CLI。 ```Bash arkcli auth login ``` ![image-20260624-144256-509.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-144256-509.png) 根据界面提示选择登录方式。若之前已登录过 arkcli，会沿用上次选择的配置；如需重新选择，请先执行 `arkcli config reset` 后再运行 `arkcli auth login`。首次登录时，按提示完成以下配置： 1. **选择项目（Project）**：可按需选择，或默认选择**账号全部资源**。 2. **选择消费模式（Type）**：选择 `coding-plan`。 ![image-20260624-163746-727.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-163746-727.png) 3. 运行 ArkCLI Helper，根据界面提示完成 OpenClaw 的配置。 1. 在命令行界面输入 `arkcli helper` 命令，启动 ArkCLI Helper。 2. **选择要配置的 Plan profile**：选择 `coding-plan_cn-beijing_personal (Coding Plan)`。 ![image-20260624-163451-813.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-163451-813.png) 3. **选择默认 model**：按需选择。 4. **选择要配置的 AI Agent**：`OpenClaw`。 ![image-20260624-164348-884.png](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/image-20260624-164348-884.png) 完成上述操作后，将自动完成 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-k2.8-preview` 支持 1M 上下文窗口用于包含大型代码库的长会话，可以通过 `contextWindow` 字段显式指定窗口大小。 **选项：Web UI 方式** 1. 执行以下命令打开 Web UI。 ```Bash openclaw dashboard ``` 2. 在左侧菜单栏选择**配置** - **Advanced** - **Raw**或者**配置** - **Advanced** - **open**，查看并修改配置信息。具体配置信息如下，其中需要将``替换为您自己的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。 > **注意** > > * 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新`models`、`agents` 和 `gateway` 节点信息。其中`models`节点包含支持的模型列表。 > * [OpenClaw 如何开启深度思考模式？](/docs/coding-plan-personal-faq#7805bea3) > * [在 OpenClaw 中无法识别图片，如何处理？](/docs/coding-plan-personal-faq#95ad3a53) > * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/coding-plan-personal-faq#0a04411f) ![](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/webUI3.png) 以下是 Responses API 的配置示例。 ```JSON { "models": { "providers": { "volcengine-plan": { "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "", "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" } } ``` 3. 配置完成后，先单击右上角 **Save** 保存，保存完成后单击 **Update** 更新配置。 **选项：终端方式** 1. 在终端执行以下命令打开 OpenClaw 配置文件。 ```Bash nano ~/.openclaw/openclaw.json ``` 2. 修改配置信息，完成 Coding Plan 对接。将``替换为您自己的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。 > **注意** > > * 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新`models`、`agents` 和 `gateway` 节点信息。其中`models`节点包含支持的模型列表。 > * [OpenClaw 如何开启深度思考模式？](/docs/coding-plan-personal-faq#7805bea3) > * [在 OpenClaw 中无法识别图片，如何处理？](/docs/coding-plan-personal-faq#95ad3a53) > * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/coding-plan-personal-faq#0a04411f) 以下是 Responses API 的配置示例。 ```JSON { "models": { "providers": { "volcengine-plan": { "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "", "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" } } ``` 3. 配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。 ```Bash openclaw gateway restart ``` # 三、使用 OpenClaw ## 开始使用 * 打开 Web UI，在 Chat 页面进行交互。 ```Bash openclaw dashboard ``` * 打开 TUI，并查看 Gateway 状态。 ```Bash openclaw tui /status ``` ## 切换模型 请根据模型配置方式，选择对应的模型切换方案。 * 模型配置：Model Name，支持以下两种方式切换模型。 前提条件：根据 [二、配置 OpenClaw](/docs/coding-plan-personal-ai-openclaw#48c0b1ea) 步骤完成文件配置，其中`agents.defaults.models`包含支持的模型列表。 * 方式一：全局配置（永久有效） 在配置文件中直接修改`agents.defaults.model.primary`为目标模型，修改完成后需要重新启动服务。 ```JSON { "agents": { "defaults": { "model": { "primary": "volcengine-plan/doubao-seed-2.1-pro" } } } } ``` * 方式二：在当前会话切换模型（临时有效） 在终端执行`openclaw tui`后，通过`/models`切换模型，当界面返回 "model set to " 时，表示配置生效。 ![](https://arkdocs.tos-cn-beijing.volces.com/images/CodingPlan/changemodel.png) * 模型配置：`volcengine-plan/ark-code-latest`，通过控制台切换模型。 配置文件中`agents.defaults.model.primary`为`volcengine-plan/ark-code-latest`。 模型切换操作：在 [开通管理页面](https://ark.volcengine.com/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe) 选择要使用的模型，切换后3-5分钟即可生效。 # 其他操作 ## 接入飞书机器人 ### 前置准备 安装并配置 OpenClaw，参见[一、安装 OpenClaw](/docs/coding-plan-personal-ai-openclaw#b51c87f8)、[二、配置 OpenClaw](/docs/coding-plan-personal-ai-openclaw#48c0b1ea)。 > **注意** > > 飞书插件处于快速迭代阶段，本文使用的插件版本为 **2026.3.10**，如果实际使用与以下步骤存在差异，可参见 [OpenClaw 飞书官网插件](https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh)。 ### 安装飞书插件 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. 在飞书中向机器人发送消息，开始对话。 ## 高级配置：配置 Embedding 模型 方舟 Coding Plan 提供的 `doubao-embedding-vision` 模型（向量模型）可以为 OpenClaw 提供语义向量能力，将对话、文档与任务信息转换为高维向量表示，实现基于语义相似度的高效检索。 相比传统关键词匹配，Embedding 检索在信息量大、对话长、资料分散的场景下，能够更准确地召回相关内容，显著降低遗漏与误判。同时，Embedding 为记忆检索、知识库问答与工具调用提供统一的语义索引层，帮助 OpenClaw 在不增加主模型推理成本的前提下，提升跨轮次上下文追踪能力与整体效果。 选择以下任一方式配置向量模型。 **选项：Web UI 方式** 1. 执行以下命令打开 Web UI。 ```Bash openclaw dashboard ``` 1. 在左侧菜单栏选择**配置** - **All Settings** - **Raw**，在`agents.defaults`节点下增加 `memorySearch`相关配置信息，增加的配置信息如下。其中需要将``替换为您自己的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。 ```JSON { ... "agents": { "defaults": { ... "memorySearch": { "provider": "openai", "model": "doubao-embedding-vision", "remote": { "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "" } } ... } } ... } ``` 2. 配置完成后，先单击右上角 **Save** 保存，保存完成后单击 **Update** 更新配置。 **选项：终端方式** 1. 在终端执行以下命令打开 OpenClaw 配置文件。 ```Bash nano ~/.openclaw/openclaw.json ``` 1. 在`agents.defaults`节点下增加 `memorySearch`相关配置信息，增加的配置信息如下。其中需要将``替换为您自己的 [API Key](https://ark.volcengine.com/region:cn-beijing/apikey)。 ```JSON { ... "agents": { "defaults": { ... "memorySearch": { "provider": "openai", "model": "doubao-embedding-vision", "remote": { "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "" } } ... } } ... } ``` 2. 配置完成后，重启网关使配置生效。 ```Bash openclaw gateway restart ``` # 常见问题 ## OpenClaw 配置问题 * [OpenClaw 如何开启深度思考模式？](/docs/coding-plan-personal-faq#7805bea3) * [使用 OpenClaw 时，出现不支持 developer role 的报错，如何解决？](/docs/coding-plan-personal-faq#f7034bc1) * [在 OpenClaw 中无法识别图片，如何处理？](/docs/coding-plan-personal-faq#95ad3a53) * [安装 OpenClaw 时报错 “gateway connect failed: Error: pairing required”，如何处理？](/docs/coding-plan-personal-faq#2dbe7807) * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/coding-plan-personal-faq#0a04411f) ## 飞书插件使用问题 * [如何升级飞书插件版本？](/docs/coding-plan-personal-faq#cbd18e98) * [在使用飞书插件时遇到问题，如何操作？](/docs/coding-plan-personal-faq#56d65f8c) * [如何配置飞书机器人，使其具备流式输出、耗时显示及状态展示能力？](/docs/coding-plan-personal-faq#b81c7462) * [如何修改飞书机器人在群内的回复方式？](/docs/coding-plan-personal-faq#863901a0) ## Ark Helper 使用问题 * [如何升级 Ark Helper？](/docs/coding-plan-personal-faq#7bdd6584) * [如何卸载 Ark Helper？](/docs/coding-plan-personal-faq#e2f455fc) # 错误码 在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考[错误码](/docs/error-codes)。