You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
接入 AI 工具
OpenClaw
复制全文
下载 pdf
OpenClaw
本文介绍如何在 OpenClaw 中配置并使用方舟 Agent Plan。​
前提条件​
您已按需订阅 Agent Plan 套餐。如未订阅,请访问 开通管理-Agent Plan 页面订阅套餐。​
安装 OpenClaw​
前提条件:安装 Node.js 22 或更新版本。​
  1. 执行以下命令安装 OpenClaw。​
​
macOS / Linux
Windows
​
​
curl -fsSL https://openclaw.ai/install.sh | bash​
​
​
  1. 根据提示信息完成 OpenClaw 配置,配置信息如下。​
注意​
OpenClaw 在不断迭代,如果实际使用与以下配置存在差异,可以选择 "Skip" 或默认选项完成配置流程,后续可以参考文档配置并使用 Agent Plan。​
​
<span aceTableMode="table" aceTableWidth="3,3"></span>​
|提示信息 |配置 |​
|---|---|​
|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​
需配置的信息​
如您对 OpenClaw 熟悉,或本地已有配置,可获取以下信息直接配置。​
  • Base URL:https://ark.cn-beijing.volces.com/api/plan/v3。​
  • Model:配置文本生成模型。可配置 ark-code-latest 或 Model Name,模型信息参见支持模型及 Harness。​
方式 1:一键配置(推荐)​
Ark CLI 是火山方舟平台官方命令行工具,支持在本地终端快速完成认证与资源管理,并可将能力安装到常用 AI Agent 中,降低手动配置的时间成本和出错风险。​
  1. 安装 Ark CLI​
  • 环境要求:Node.js 18 或更新版本。支持 macOS、Linux、Windows。​
​
npm install -g @volcengine/ark-cli@latest​
arkcli --version​
​
  1. 登录 Ark CLI​
  • 根据界面提示选择登录方式,推荐选择 火山 SSO (浏览器登录),在浏览器中完成授权即可。​
​
arkcli auth login​
​
  1. 一键配置 OpenClaw​
​
arkcli helper​
​
运行 ArkCLI Helper,根据界面提示完成配置。​
  • 选择 Profile:agent-plan_cn-beijing_personal。​
  • 选择默认 model:按需选择。​
  • 选择 AI Agent:OpenClaw。​
  • 支持配置 Harness 能力,根据界面提示按需选择配置或者跳过。​
配置完成后,OpenClaw 会自动识别配置的模型。启动 OpenClaw 即可使用。​
方式 2:手动配置​
Agent Plan 兼容 OpenAI 接口协议,支持 Responses API、Chat API。推荐使用 Responses API 的配置,推理效果更好。​
两类 API 的配置方式基本一致,只需在 models.providers 中指定对应的 API 适配器:​
  • Responses API 配置:"api": "openai-responses"​
  • Chat API 配置:"api": "openai-completions"​
​
Web UI 方式
终端方式
​
  1. 执行以下命令打开 Web UI。​
​
openclaw dashboard​
​
  1. 在左侧菜单栏选择配置 - Settings - Advanced,单击 Open 查看并修改配置信息。具体配置信息如下,其中需要将<ARK_API_KEY>替换为您的 专属 API Key。​
​image-20260908-203322-616.png​​
注意​
如果已经配置过 OpenClaw,请勿直接覆盖原有配置,建议根据提供的配置更新models、agents 和 gateway 节点信息。其中models节点包含支持的模型列表。​
以下是 Responses API 的配置示例。​
​
{​
"models": {​
"providers": {​
"volcengine-agent-plan": {​
"baseUrl": "https://ark.cn-beijing.volces.com/api/plan/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-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.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": "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": "doubao-seed-2.0-mini",​
"name": "doubao-seed-2.0-mini",​
"contextWindow": 256000,​
"maxTokens": 65536,​
"input": [​
"text",​
"image"​
]​
},​
{​
"id": "kimi-k3.1-pro",​
"name": "kimi-k3.1-pro",​
"contextWindow": 1024000,​
"maxTokens": 65536,​
"input": [​
"text",​
"image"​
]​
},​
{​
"id": "kimi-k2.8-preview",​
"name": "kimi-k2.8-preview",​
"contextWindow": 1024000,​
"maxTokens": 65536,​
"input": [​
"text",​
"image"​
]​
}​
]​
}​
}​
},​
"agents": {​
"defaults": {​
"model": {​
"primary": "volcengine-agent-plan/ark-code-latest"​
},​
"models": {​
"volcengine-agent-plan/ark-code-latest": {},​
"volcengine-agent-plan/doubao-seed-2.1-pro": {},​
"volcengine-agent-plan/doubao-seed-2.1-lite": {},​
"volcengine-agent-plan/doubao-seed-2.0-mini": {},​
"volcengine-agent-plan/glm-5.3": {},​
"volcengine-agent-plan/glm-5.3-flash": {},​
"volcengine-agent-plan/glm-latest": {},​
"volcengine-agent-plan/kimi-k3.1-pro": {},​
"volcengine-agent-plan/kimi-k2.8-preview": {},​
"volcengine-agent-plan/deepseek-v4.1-flash": {},​
"volcengine-agent-plan/deepseek-v4.1-flash-economy": {},​
"volcengine-agent-plan/deepseek-v4-flash": {},​
"volcengine-agent-plan/deepseek-v4-pro": {}​
}​
}​
},​
"gateway": {​
"mode": "local"​
}​
}​
​
  1. 配置完成后,先保存配置文件,然后单击 Update 更新配置,配置更新完成后需要重新连接服务进入 Web UI。​
​Image​​
​
使用 OpenClaw​
  • 打开 Web UI,在 Chat 页面进行交互。​
​
​
openclaw dashboard​
​
​
  • 打开 TUI,并查看 Gateway 状态。​
​
​
openclaw tui​
/status​
​
​
其他操作​
切换模型​
请根据模型配置方式,选择对应的模型切换方案。​
  • 模型配置:Model Name,支持以下两种方式切换模型。​
  • 前提条件:根据 配置 OpenClaw 步骤完成文件配置,其中agents.defaults.models包含支持的模型列表。​
  • 方式一:全局配置(永久有效)​
  • 在配置文件中直接修改agents.defaults.model.primary为目标模型,修改完成后需要重新启动服务。​
  • ​
    {​
    "agents": {​
    "defaults": {​
    "model": {​
    "primary": "volcengine-agent-plan/doubao-seed-2.1-pro"​
    }​
    }​
    }​
    }​
    ​
  • 方式二:在当前会话切换模型(临时有效)​
  • 在终端执行openclaw tui后,通过/models切换模型,当界面返回 "model set to <Model_Name>" 时,表示配置生效。​
  • 模型配置:volcengine-agent-plan/ark-code-latest,通过控制台切换模型。​
  • 配置文件中agents.defaults.model.primary为volcengine-agent-plan/ark-code-latest。​
  • 模型切换操作:在 开通管理页面 选择要使用的模型,切换后3-5分钟即可生效。​
配置向量模型​
方舟 Agent Plan 提供的 doubao-embedding-vision 模型(向量模型)可以为 OpenClaw 提供语义向量能力,将对话、文档与任务信息转换为高维向量表示,实现基于语义相似度的高效检索。​
相比传统关键词匹配,Embedding 检索在信息量大、对话长、资料分散的场景下,能够更准确地召回相关内容,显著降低遗漏与误判。同时,Embedding 为记忆检索、知识库问答与工具调用提供统一的语义索引层,帮助 OpenClaw 在不增加主模型推理成本的前提下,提升跨轮次上下文追踪能力与整体效果。​
选择以下任一方式配置向量模型。​
​
Web UI 方式
终端方式
​
  1. 执行以下命令打开 Web UI。​
  • ​
    openclaw dashboard​
    ​
  1. 在左侧菜单栏选择配置 - Settings - Advanced,单击 Open 查看并修改配置信息,在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/plan/v3",​
    "apiKey": "<ARK_API_KEY>"​
    }​
    }​
    ...​
    }​
    }​
    ...​
    }​
    ​
  1. 配置完成后,先保存配置文件,然后单击 Update 更新配置,配置更新完成后需要重新连接服务进入 Web UI。​
​
添加图片生成/视频生成能力​
方舟 Agent Plan 提供生图、生视频模型,支持通过 AI 工具的 Skill 接入并使用。具体配置方法请参见 配置视觉模型。​
注意​
  • 视觉模型不支持通过 Auto 及控制台切换使用。​
接入飞书机器人​
前置准备​
安装并配置 OpenClaw,参见 安装 OpenClaw、配置 OpenClaw。​
注意​
飞书插件处于快速迭代阶段,本文使用的插件版本为 2026.3.10,如果实际使用与以下步骤存在差异,可参见 OpenClaw 飞书官网插件。​
安装飞书插件​
  1. 执行以下命令安装飞书插件。​
  • ​
    npx -y @larksuite/openclaw-lark-tools install​
    ​
  • 如果执行命令时报错,可在命令行前增加sudo重新执行。​
  1. 根据界面提示信息,选择新建机器人。​
  • ​Image​​
  1. 通过飞书客户端扫描二维码,选择一键创建飞书机器人。​
  • ​Image​​
  1. 在飞书中向机器人发送/feishu start,若返回版本号信息,代表安装成功。​
  1. 在飞书中向机器人发送消息,开始对话。​
​
最近更新时间:2026.11.11 16:50:43
这个页面对您有帮助吗?
有用
有用
无用
无用