[OpenClaw（原 Clawdbot）](https://clawd.bot/) 是一款开源、自托管的个人 AI 助手，可以在本地计算机上运行，兼容 MacOS、Windows 及 Linux 等多种系统，支持接入常用聊天工具，除了内置多种 Agent 常用工具外，还可以通过插件和 Skill 扩展更多能力。方舟 Coding Plan 支持在 OpenClaw 中使用，可参考本文进行配置及使用。 :::tip 需要先访问[方舟 Coding Plan活动](https://www.volcengine.com/activity/codingplan)，按需订阅套餐后再配置使用编程工具。 ::: # 核心配置接入工具的核心参数如下： ## **模型配置** 支持以下两种方式配置模型： \`\`\`mixin-react return ( ); \`\`\` ## **Base URL** 不同的工具配置的 Base URL 根据兼容的协议会有不同： * 兼容 Anthropic 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding\` * 兼容 OpenAI 接口协议工具：\`https://ark.cn-beijing.volces.com/api/coding/v3\`（目前还不支持 Responses API，建议使用 Chat API。） :::warning 请勿使用 \`https://ark.cn-beijing.volces.com/api/v3\` ：该 Base URL 不会消耗您的 Coding Plan 额度，而是会产生额外费用。 ::: ## **API Key** [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) # 安装和配置 OpenClaw ## 安装步骤前提条件：安装 [Node.js 22 或更新版本](https://nodejs.org/en/download/)。 1. 执行以下命令安装 OpenClaw。 ```mixin-react return ( ); ``` 2. 根据提示信息完成 OpenClaw 配置，配置信息如下。 1. 基本配置 |提示信息 |配置 | |---|---| |I understand this is personal\-by\-default and shared/multi\-user use requires lock\-down. Continue? |选择 "Yes" | |Setup mode |选择 “QuickStart” | 2. 模型配置 |提示信息 |配置 | |---|---| |Model/auth provider |选择 "Volcano Engine"。|\ | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c5d4b31423cd491181a379c48ffbbd63~tplv-goo7wpa0wc-image.image =165x) | |Enter Volcano Engine API key |设置 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey) | |Default model |选择 Coding Plan 支持的模型（`volcengine-plan`），本文设置为 ”`volcengine-plan/ark-code-latest`“|\ | |![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3ff3825a5f4043599ff191d44d7ed742~tplv-goo7wpa0wc-image.image =467x) |\ | |:::warning|\ | |如果需要使用`volcengine-plan`列表中未列出来的模型，请在完成配置流程后，按照[配置工具](/docs/82379/2183190#48c0b1ea)步骤进行修改。|\ | ||\ | |:::| 3. 功能配置 |提示信息 |配置 | |---|---| |Select channel (QuickStart) |选择 “Skip for now”，后续可以配置。 | |Configure skills now? (recommended) |选择 “No”，后续可以配置。 | |Enable hooks? |按空格键选中选项，按回车键进入下一步。 | |How do you want to hatch your bot? |选择 "Hatch in TUI"。 | ## 配置工具根据操作系统选择合适的方式完成工具配置后，配置文件中会包含 Coding Plan 支持的完整的模型列表，便于快速切换目标模型。 ### 方式一：自动化助手（推荐） Ark Helper 是一个编码工具助手，支持快速配置选择的工具接入 Coding Plan。安装并运行该助手，根据界面提示操作可自动完成工具配置，降低手动配置的时间成本和出错风险。 :::warning * Ark Helper 仅支持 MacOS、Linux 系统，暂不支持 Windows 系统。 * 以下配置步骤及截图为 Ark Helper 首次使用指引；非首次使用请按界面提示完成套餐配置和工具配置。 ::: 1. 执行以下命令安装 Ark Helper。 ```Bash curl -fsSL https://lf3-static.bytednsdoc.com/obj/eden-cn/ylwslo-yrh/ljhwZthlaukjlkulzlp/install.sh | sh ``` 安装完成后，执行以下命令查看安装的版本号。 ```Bash ark-helper --version ``` 2. 在命令行界面输入`ark-helper`命令，启动 Ark Helper。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/802e66e79f864ceeaba2d05250f1c743~tplv-goo7wpa0wc-image.image =399x) 3. 根据界面提示完成套餐配置。 1. 选择要配置的套餐：`[Volcano] Volcano Engine（国内）`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6a68961ee782408ca485dff07b2fcfb5~tplv-goo7wpa0wc-image.image =235x) 2. 配置 API Key： [获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0f327801346548e49580aff3fbfe9c0f~tplv-goo7wpa0wc-image.image =379x) ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0d49b2af47294daba8a5e2c86f2c706c~tplv-goo7wpa0wc-image.image =363x) 3. 选择默认模型。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a9a13add5808465bb8c27d6518623916~tplv-goo7wpa0wc-image.image =245x) 4. 根据界面提示完成 OpenClaw 工具配置。 1. 选择要配置的编码工具：`OpenClaw`。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0984d38d2cc348f39b2a86d1d0cdd599~tplv-goo7wpa0wc-image.image =237x) 2. 选择`设置 Volcano 配置到 OpenClaw`，配置完成后，选择`退出`。如果需要重新配置工具，可先选择`卸载 OpenClaw 配置`，再重新执行配置流程。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/02026e9accf34c399f7f44d550cf35d5~tplv-goo7wpa0wc-image.image =272x) ### 方式二：手动配置 ```mixin-react return ( \`替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 :::warning * 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新\`models\`、\`agents\` 和 \`gateway\` 节点信息。其中\`models\`节点包含支持的模型列表。 * [OpenClaw 如何开启深度思考模式？](/docs/82379/2165245#7805bea3) * [在 OpenClaw 中无法识别图片，如何处理？](/docs/82379/2165245#95ad3a53) * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/82379/2165245#0a04411f) ::: \`\`\`JSON \{ "models": \{ "providers": \{ "volcengine-plan": \{ "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "", "api": "openai-completions", "models": [ \{ "id": "ark-code-latest", "name": "ark-code-latest", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-code", "name": "doubao-seed-code", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "glm-5.1", "name": "glm-5.1", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "glm-4.7", "name": "glm-4.7", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "deepseek-v3.2", "name": "deepseek-v3.2", "contextWindow": 128000, "maxTokens": 32000, "input": [ "text" ] \}, \{ "id": "doubao-seed-2.0-code", "name": "doubao-seed-2.0-code", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-2.0-pro", "name": "doubao-seed-2.0-pro", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-2.0-lite", "name": "doubao-seed-2.0-lite", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "minimax-latest", "name": "minimax-latest", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "kimi-k2.6", "name": "kimi-k2.6", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "kimi-k2.5", "name": "kimi-k2.5", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \} ] \} \} \}, "agents": \{ "defaults": \{ "model": \{ "primary": "volcengine-plan/ark-code-latest" \}, "models": \{ "volcengine-plan/ark-code-latest": \{\}, "volcengine-plan/doubao-seed-2.0-code": \{\}, "volcengine-plan/doubao-seed-2.0-pro": \{\}, "volcengine-plan/doubao-seed-2.0-lite": \{\}, "volcengine-plan/doubao-seed-code": \{\}, "volcengine-plan/glm-5.1": \{\}, "volcengine-plan/minimax-latest": \{\}, "volcengine-plan/kimi-k2.6": \{\}, "volcengine-plan/glm-4.7": \{\}, "volcengine-plan/deepseek-v3.2": \{\}, "volcengine-plan/kimi-k2.5": \{\} \} \} \}, "gateway": \{ "mode": "local" \} \} \`\`\` 3. 配置完成后，先单击右上角 **Save** 保存，保存完成后单击 **Update** 更新配置。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e7e19b8f3af147bd81f1aa72252b9a19~tplv-goo7wpa0wc-image.image =2482x) `}> \`替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)。 :::warning * 如果已经配置过 OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新\`models\`、\`agents\` 和 \`gateway\` 节点信息。其中\`models\`节点包含支持的模型列表。 * [OpenClaw 如何开启深度思考模式？](/docs/82379/2165245#7805bea3) * [在 OpenClaw 中无法识别图片，如何处理？](/docs/82379/2165245#95ad3a53) * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/82379/2165245#0a04411f) ::: \`\`\`JSON \{ "models": \{ "providers": \{ "volcengine-plan": \{ "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3", "apiKey": "", "api": "openai-completions", "models": [ \{ "id": "ark-code-latest", "name": "ark-code-latest", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-code", "name": "doubao-seed-code", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "glm-5.1", "name": "glm-5.1", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "glm-4.7", "name": "glm-4.7", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "deepseek-v3.2", "name": "deepseek-v3.2", "contextWindow": 128000, "maxTokens": 32000, "input": [ "text" ] \}, \{ "id": "doubao-seed-2.0-code", "name": "doubao-seed-2.0-code", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-2.0-pro", "name": "doubao-seed-2.0-pro", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "doubao-seed-2.0-lite", "name": "doubao-seed-2.0-lite", "contextWindow": 256000, "maxTokens": 128000, "input": [ "text", "image" ] \}, \{ "id": "minimax-latest", "name": "minimax-latest", "contextWindow": 200000, "maxTokens": 128000, "input": [ "text" ] \}, \{ "id": "kimi-k2.6", "name": "kimi-k2.6", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \}, \{ "id": "kimi-k2.5", "name": "kimi-k2.5", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text", "image" ] \} ] \} \} \}, "agents": \{ "defaults": \{ "model": \{ "primary": "volcengine-plan/ark-code-latest" \}, "models": \{ "volcengine-plan/ark-code-latest": \{\}, "volcengine-plan/doubao-seed-2.0-code": \{\}, "volcengine-plan/doubao-seed-2.0-pro": \{\}, "volcengine-plan/doubao-seed-2.0-lite": \{\}, "volcengine-plan/doubao-seed-code": \{\}, "volcengine-plan/glm-5.1": \{\}, "volcengine-plan/minimax-latest": \{\}, "volcengine-plan/kimi-k2.6": \{\}, "volcengine-plan/glm-4.7": \{\}, "volcengine-plan/deepseek-v3.2": \{\}, "volcengine-plan/kimi-k2.5": \{\} \} \} \}, "gateway": \{ "mode": "local" \} \} \`\`\` 3. 配置完成后保存文件，并在终端执行以下命令重启服务使更改生效。 \`\`\`Bash openclaw gateway restart \`\`\` `}>); ``` ## 开始使用 * 打开 Web UI，在 Chat 页面进行交互。 ```Bash openclaw dashboard ``` * 打开 TUI，并查看 Gateway 状态。 ```Bash openclaw tui /status ``` ## 切换模型请根据模型配置方式，选择对应的模型切换方案。 * 模型配置：Model Name，支持以下两种方式切换模型。前提条件：根据[配置工具](/docs/82379/2183190#48c0b1ea)步骤完成文件配置，其中`agents.defaults.models`包含支持的模型列表。 * 方式一：全局配置（永久有效）在配置文件中直接修改`agents.defaults.model.primary`为目标模型，修改完成后需要重新启动服务。 ```JSON { "agents": { "defaults": { "model": { "primary": "volcengine-plan/doubao-seed-code" } } } } ``` * 方式二：在当前会话切换模型（临时有效）在终端执行`openclaw tui`后，通过`/models`切换模型，当界面返回 "model set to " 时，表示配置生效。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/460d22f563954fef89462ab938fa3e59~tplv-goo7wpa0wc-image.image =346x) * 模型配置：`volcengine-plan/ark-code-latest`，通过控制台切换模型。配置文件中`agents.defaults.model.primary`为`volcengine-plan/ark-code-latest`。模型切换操作：在[开通管理页面](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=subscribe)选择要使用的模型，切换后3\-5分钟即可生效。 # 接入飞书机器人 ## 前置准备安装并配置 OpenClaw，参见[安装步骤](/docs/82379/2183190#ab80aa5e)、[配置工具](/docs/82379/2183190#48c0b1ea)、[开始使用](/docs/82379/2183190#2bdca227)。 :::warning 飞书插件处于快速迭代阶段，本文使用的插件版本为 **2026.3.10**，如果实际使用与以下步骤存在差异，可参见 [OpenClaw 飞书官网插件](https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh)。 ::: ## 安装飞书插件 1. 执行以下命令安装飞书插件。 ```Bash npx -y @larksuite/openclaw-lark-tools install ``` 如果执行命令时报错，可在命令行前增加`sudo`重新执行。 2. 根据界面提示信息，选择**新建机器人**。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9af37555c38f4ffb858932eab3ed05c5~tplv-goo7wpa0wc-image.image =504x) 3. 通过飞书客户端扫描二维码，选择**一键创建飞书机器人**。 ![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/71401f60297543279b95f1c764991f99~tplv-goo7wpa0wc-image.image =508x) 4. 在飞书中向机器人发送`/feishu start`，若返回版本号信息，代表安装成功。 5. 在飞书中向机器人发送消息，开始对话。 # 高级配置：配置 Embedding 模型方舟 Coding Plan 提供的 `doubao-embedding-vision` 模型（Embedding 模型）可以为 OpenClaw 提供语义向量能力，将对话、文档与任务信息转换为高维向量表示，实现基于语义相似度的高效检索。相比传统关键词匹配，Embedding 检索在信息量大、对话长、资料分散的场景下，能够更准确地召回相关内容，显著降低遗漏与误判。同时，Embedding 为记忆检索、知识库问答与工具调用提供统一的语义索引层，帮助 OpenClaw 在不增加主模型推理成本的前提下，提升跨轮次上下文追踪能力与整体效果。选择以下任一方式配置 Embedding 模型。 ```mixin-react return ( \`替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+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": "" \} \} ... \} \} ... \} \`\`\` 3. 配置完成后，先单击右上角 **Save** 保存，保存完成后单击 **Update** 更新配置。 `}> \`替换为您自己的 [API Key](https://console.volcengine.com/ark/region:ark+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": "" \} \} ... \} \} ... \} \`\`\` 3. 配置完成后，重启网关使配置生效。 \`\`\`Bash openclaw gateway restart \`\`\` `}>); ``` # 常见问题 ## OpenClaw 配置问题 * [OpenClaw 如何开启深度思考模式？](/docs/82379/2165245#7805bea3) * [使用 OpenClaw 时，出现不支持 developer role 的报错，如何解决？](/docs/82379/2165245#f7034bc1) * [在 OpenClaw 中无法识别图片，如何处理？](/docs/82379/2165245#95ad3a53) * [安装 OpenClaw 时报错 “gateway connect failed: Error: pairing required”，如何处理？](/docs/82379/2165245#2dbe7807) * [配置 OpenClaw 时报错 “run error: 404 The model or endpoint xxx does not exist or you do not have access to it”，如何处理？](/docs/82379/2165245#0a04411f) ## 飞书插件使用问题 * [如何升级飞书插件版本？](/docs/82379/2165245#cbd18e98) * [在使用飞书插件时遇到问题，如何操作？](/docs/82379/2165245#56d65f8c) * [如何配置飞书机器人，使其具备流式输出、耗时显示及状态展示能力？](/docs/82379/2165245#b81c7462) * [如何修改飞书机器人在群内的回复方式？](/docs/82379/2165245#863901a0) ## Ark Helper 使用问题 * [如何升级 Ark Helper？](/docs/82379/2165245#7bdd6584) * [如何卸载 Ark Helper？](/docs/82379/2165245#e2f455fc) # 错误码在编程工具中使用 Coding Plan 套餐时可能会遇到报错，您可以根据错误信息查看对应的报错场景并定位问题，具体可参考[错误码](/docs/82379/1299023)。

火山方舟