面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/coding-plan-enterprise-ai-openclaw.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

OpenClaw

OpenClaw(原 Clawdbot) 是一款开源的个人 AI 助手,支持连接到多种消息渠道。本文介绍如何在 OpenClaw 中使用方舟 Coding Plan 企业版,并接入飞书机器人。

核心配置#

需要获取 Coding Plan 企业版支持的模型、Base URL和专属的 API Key,才能正常使用并抵扣套餐额度。

模型配置#

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

在工具配置文件中指定 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.1-pro
  1. 在配置文件中指定模型为ark-code-latest。
  2. 通过 Coding Plan 企业版页面 选择或切换目标模型,切换模型后 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

coding-plan-enterprise-api-key.png

一、前置操作#

需由管理员账号完成以下前置操作后,子账号方可配置并使用编程工具:

  1. 购买方舟 Coding Plan 企业版套餐:一、购买 Coding Plan 企业版。
  2. 为子账号分配席位:二、分配席位。

二、安装OpenClaw#

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

  1. 执行以下命令安装 OpenClaw。
Bash
curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell 环境下安装命令如下:

Bash
iwr -useb https://openclaw.ai/install.ps1 | iex
  1. 根据提示信息完成 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 兼容 OpenAI 接口协议,支持 Responses API、Chat API。推荐使用 Responses API 的配置,推理效果更好。
两类 API 的配置方式基本一致,只需在 models.providers 中指定对应的 API 适配器:

  • Responses API 配置:"api": "openai-responses"
  • Chat API 配置:"api": "openai-completions"
  1. 执行以下命令打开 Web UI。
Bash
openclaw dashboard
  1. 在左侧菜单栏选择配置 - Advanced - Raw或者配置 - Advanced - open,查看并修改配置信息。具体配置信息如下,其中需要将<ARK_API_KEY>替换为您自己的 专属 API Key。

以下是 Responses API 的配置示例。

JSON
{
  "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": "deepseek-v4.1-flash-economy",
            "name": "deepseek-v4.1-flash-economy",
            "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.1-pro",
            "name": "kimi-k3.1-pro",
            "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/kimi-k2.8-preview": {},
        "volcengine-plan/kimi-k3.1-pro": {},
        "volcengine-plan/deepseek-v4.1-flash": {},
        "volcengine-plan/deepseek-v4.1-flash-economy": {},
        "volcengine-plan/deepseek-v4-flash": {},
        "volcengine-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}
  1. 配置完成后,先单击右上角 Save 保存,保存完成后单击 Update 更新配置。
  1. 在终端执行以下命令打开 OpenClaw 配置文件。
Bash
nano ~/.openclaw/openclaw.json
  1. 修改配置信息,完成 Coding Plan 对接。将<ARK_API_KEY>替换为您自己的 专属 API Key。

以下是 Responses API 的配置示例。

JSON
{
  "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": "deepseek-v4.1-flash-economy",
            "name": "deepseek-v4.1-flash-economy",
            "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.1-pro",
            "name": "kimi-k3.1-pro",
            "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/kimi-k2.8-preview": {},
        "volcengine-plan/kimi-k3.1-pro": {},
        "volcengine-plan/deepseek-v4.1-flash": {},
        "volcengine-plan/deepseek-v4.1-flash-economy": {},
        "volcengine-plan/deepseek-v4-flash": {},
        "volcengine-plan/deepseek-v4-pro": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}
  1. 配置完成后保存文件,并在终端执行以下命令重启服务使更改生效。

    Bash
    openclaw gateway restart
    

四、使用 OpenClaw#

  • 打开 Web UI,在 Chat 页面进行交互。
Bash
openclaw dashboard
  • 打开 TUI,并查看 Gateway 状态。
Bash
openclaw tui
/status

其他操作#

切换模型#

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

  • 模型配置:Model Name,支持以下两种方式切换模型。

    前提条件:根据 配置工具 步骤完成文件配置,其中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 <Model_Name>" 时,表示配置生效。

    Image
  • 模型配置:volcengine-plan/ark-code-latest,通过控制台切换模型。

    配置文件中agents.defaults.model.primary为volcengine-plan/ark-code-latest。
    模型切换操作:在 订阅页面,选择我的 - 使用配置,选择要使用的模型,切换后3-5分钟即可生效。

接入飞书机器人#

前置准备#

安装并配置 OpenClaw,参见 安装和配置 OpenClaw。

安装飞书插件#

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

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

如果执行命令时报错,可在命令行前增加sudo重新执行。
2. 根据界面提示信息,选择新建机器人。

Image
  1. 通过飞书客户端扫描二维码,选择一键创建飞书机器人。
Image
  1. 在飞书中向机器人发送/feishu start,若返回版本号信息,代表安装成功。
  2. 在飞书中向机器人发送消息,开始对话。

高级配置:配置 Embedding 模型#

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

  1. 执行以下命令打开 Web UI。
Bash
openclaw dashboard
  1. 在左侧菜单栏选择配置 - All Settings - Raw,在agents.defaults节点下增加 memorySearch相关配置信息,增加的配置信息如下。其中需要将<ARK_API_KEY>替换为您自己的 专属 API Key。

    JSON
    {
      ...
      "agents": {
        "defaults": {
          ...
          "memorySearch": {
            "provider": "openai",
            "model": "doubao-embedding-vision",
            "remote": {
              "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
              "apiKey": "<ARK_API_KEY>"
            }
          }
          ...
        }
      }
      ...
     }
    
  2. 配置完成后,先单击右上角 Save 保存,保存完成后单击 Update 更新配置。

  1. 在终端执行以下命令打开 OpenClaw 配置文件。
Bash
nano ~/.openclaw/openclaw.json
  1. 在agents.defaults节点下增加 memorySearch相关配置信息,增加的配置信息如下。其中需要将<ARK_API_KEY>替换为您自己的 专属 API Key。

    JSON
    {
      ...
      "agents": {
        "defaults": {
          ...
          "memorySearch": {
            "provider": "openai",
            "model": "doubao-embedding-vision",
            "remote": {
              "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
              "apiKey": "<ARK_API_KEY>"
            }
          }
          ...
        }
      }
      ...
    }
    
  2. 配置完成后,重启网关使配置生效。

    Bash
    openclaw gateway restart