OpenClaw是一款开源的本地优先AI代理与自动化平台。您可以通过OpenClaw将多渠道通信能力与大语言模型深度集成，创建拥有持久记忆与主动执行能力的定制化AI助理。 ## 变更历史

注意

若您期望升级、重置云服务器中已部署的OpenClaw，可创建OpenClaw应用更新任务完成操作。

|更新时间 |说明 | |---|---| |2026年03月05日 |同步支持**社区2026年3月2日版本**最新能力，并支持**2026.3.4**版飞书插件。 | |2026年02月27日 |同步支持**社区2026年2月23日版本**最新能力。 | |2026年02月12日 |集成AI助手安全防护功能，开启后即可获得针对OpenClaw的企业级安全防护。 | |2026年02月10日 |修复飞书插件冲突问题，并同步支持**社区2026年2月6日版本**的最新能力。 | ## 功能特色火山引擎为您提供了快速部署OpenClaw的应用模板，不仅可以帮助您快速完成OpenClaw部署并集成飞书企业应用，还为您集成了AgentKit提供的常用Skills。同时，还支持了原生支持生图、生视频的多模态能力。 * 对于开发者，特别是**个人开发场景**，火山方舟为您提供了[Coding Plan](https://www.volcengine.com/activity/codingplan)方案，支持主流Code模型（Doubao\-Seed\-Code、GLM、Kimi、DeepSeek等最新版本）的使用和自由切换，帮助您完成个人项目、学习实践、工具搭建等编码任务。 * 对于**企业级开发需求**，支持您选择火山方舟模型广场的任意大语言模型，其中Doubao\-Seed\-Code、GLM\-4.7、DeepSeek\-V3.2和Kimi\-K2\-Thinking等多款模型服务现已全面适配OpenClaw的技术生态。

注意

如需使用原生支持生图、生视频的多模态能力，请前往开通后，为OpenClaw选择doubao\-seedream\-4\-5 (251128)或doubao\-seedance\-1\-5\-pro (251215)模型。

## 前提条件 * 已开通[火山方舟大模型服务](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=model)，创建并获取[API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D)。 * 已创建飞书应用，并为应用添加“机器人”能力。 ## 操作步骤 ### 步骤一：创建ECS服务器 1. [点此](https://console.volcengine.com/ecs/region:ecs+cn-shanghai/buy?type=app)登录云服务器控制台。 2. 通过应用模板快速购买预置了OpenClaw的云服务器，配置如下参数。 |参数 |说明 | |---|---| |**实例配置** || |应用模板 |选择“OpenClaw”。 | |计费类型 |选择实例计费类型，本文以“包年包月”为例。[了解更多](https://www.volcengine.com/docs/6396/68420) | |地域 |选择实例所在地域，本文以“华东2（上海）”为例。

说明

暂仅支持华南1（广州）、华北2（北京）、华东2（上海）及亚太东南（雅加达）地域。了解更多

说明

开启后，AI助手安全功能将在不影响OpenClaw正常工作的前提下，实时监测和防御提示词注入（Prompt Injection）、敏感信息泄露（PII Leakage）、高危操作（Risky Operations）三类核心风险。

* 不启用：不使用相关服务。 | |角色授权 |选择是否为云助手完成所需角色授权。

* **（推荐）** 授权：请勾选“确认授权云助手所需角色”按钮，授权完成后方可执行版本升级、数据同步等相关操作。

说明

授权后，您可通过应用管理功能，查看Coding Plan套餐用量、升级OpenClaw版本、管理其关联模型与消息渠道。了解更多

* 不授权：不使用相关服务。 | |**高级配置** || |模型配置 |配置方舟平台的模型，OpenClaw将在ECS实例启动后，使用该模型进行推理服务。

* **配置方式：**

* **模型广场：** 支持选择火山方舟模型广场的大语言模型，其中Doubao\-Seed\-Code、GLM\-4.7、DeepSeek\-V3.2 和 Kimi\-K2\-Thinking等多款模型服务现已全面适配OpenClaw的技术生态。

说明

若您还尚未开通方舟模型服务，在选择模型并创建实例后，平台将自动为您开通所选模型服务，且后续将按Token计费。

通过“OpenClaw”应用模板所部署的OpenClaw，集成了AgentKit提供的常用Skills，原生支持生图、生视频的多模态能力。如需使用相关能力，请前往开通后，选择doubao\-seedream\-4\-5 (251128)或doubao\-seedance\-1\-5\-pro (251215)模型。

* **Coding Plan：** 方舟Coding Plan是为开发者量身打造的AI Coding场景订阅服务，支持主流Code模型（Doubao\-Seed\-Code、GLM、Kimi、DeepSeek等最新版本）的使用和自由切换。

说明

您可以单击“立即订阅”按钮，前往方舟Coding Plan活动页面，按需订阅套餐。

* **模型选择：** 选择为OpenClaw提供实际推理服务的模型。

* **API Key**：在下拉列表中选择您期望使用的API Key。

注意

请妥善保管方舟API Key。若发生泄露，第三方将有机会冒用您的身份进行恶意使用，产生超出预期的token费用。

| |消息渠道集成 |请选择 **飞书**，OpenClaw将在ECS实例启动后，自动将飞书作为消息通知渠道。

* App Id：目标飞书机器人的App ID。

* App Secret：目标飞书机器人的密钥。

说明

您可以登录飞书开发者平台，在目标应用详情页的“基础信息 \> 凭证与基础信息”页面，查看应用的App ID 和App Secret。

注意，App ID和App Secret是调用飞书开放平台API的重要身份标识，请妥善保管，避免泄露。

| 3. 在右侧“配置详情”中确认实例配置及费用信息，并勾选“我已阅读并同意《云服务器服务条款》”。 4. 单击“立即购买”按钮，完成购买操作。 5. 您还可以单击“去控制台”按钮，前往实例列表页查看新创建的实例规格信息，还可[通过控制台登录实例](https://www.volcengine.com/docs/6396/67747)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2810ffd0a1da7ac82c7f4817b35030a0.png) ### 步骤二：配置OpenClaw飞书AI助手 1. [登录云服务器实例](https://www.volcengine.com/docs/6396/67747)。 2. 执行如下命令，查看OpenClaw服务运行状态，确认其是否正常启动。 ```Bash systemctl --user status openclaw-gateway.service ``` 若回显中服务状态为 **active (running)** ，表示OpenClaw服务已正常启动，请继续进行后续操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_20ee6b4364ffd5e526fb2f7ab424cfb6.png) 3. 登录[飞书开发者平台](https://open.larkoffice.com/app?lang=zh-CN)。 4. 选择“企业自建应用”页签，并单击您创建的飞书开放应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c8749b3fd85a94985eef7b44e011a18e.png) 5. 配置权限。 1. 在左侧目录树选择“开发配置 \> 权限管理”，单击“批量导入/导出权限”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_36edbb3938475f6fc86104a368b809b8.png) 1. 在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。 ```JSON { "scopes": { "tenant": [ "contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read" ], "user": [ "contact:user.employee_id:readonly", "offline_access", "base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve", "base:record:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "base:app:create", "base:app:update", "base:app:read", "board:whiteboard:node:create", "board:whiteboard:node:read", "calendar:calendar:read", "calendar:calendar.event:create", "calendar:calendar.event:delete", "calendar:calendar.event:read", "calendar:calendar.event:reply", "calendar:calendar.event:update", "calendar:calendar.free_busy:read", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user:search", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.media:download", "docs:document:copy", "docx:document:create", "docx:document:readonly", "docx:document:write_only", "drive:drive.metadata:readonly", "drive:file:download", "drive:file:upload", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg:get_as_user", "im:message.p2p_msg:get_as_user", "im:message:readonly", "search:docs:read", "search:message", "space:document:delete", "space:document:move", "space:document:retrieve", "task:comment:read", "task:comment:write", "task:task:read", "task:task:write", "task:task:writeonly", "task:tasklist:read", "task:tasklist:write", "wiki:node:copy", "wiki:node:create", "wiki:node:move", "wiki:node:read", "wiki:node:retrieve", "wiki:space:read", "wiki:space:retrieve", "wiki:space:write_only" ] } } ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_88158509cab47e8e5cbae2a20ba6350f.png) 2. 在弹窗中确认权限无误后，单击“申请开通”按钮，完成操作。

说明

相关权限的具体含义可查看飞书API权限列表。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8e263eefc535900a5a725e533871ce32.png) 6. 进入您创建的飞书应用详情页，并在左侧目录树选择“开发配置 \> 事件与回调”。 * 事件配置 1. 选择“事件配置”页签，单击“订阅方式”旁的编辑按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c600e17924027f801d14e0f26139e9ae.png) 2. 选择“使用 **长连接** 接收事件”，并单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f1a689fd1a096e874bdb4a4355c899ad.png) 3. 在“已添加事件”区域，单击“添加事件”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e15635ae9baec480e2fa89546e4336cc.png) 4. 在添加事件对话框中，选择“应用身份订阅”页签，搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件，单击“确认添加”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bb0980c27f03101039747ccd72f15878.png) 5. **（可选）** 若您期望将机器人添加到聊天群组中使用，需开通获取群组消息权限。否则，请跳过本步骤。 1. 在“已添加事件”模块中，单击“接收消息”事件“所需权限”列的“查看其它权限”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_924b24c010673a4bae47b9f652dac8b9.png) 2. 单击“获取群组中所有消息（敏感权限）”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_713700bfcbb23bfff272fcf55a938072.png) 3. 在弹窗中单击“开通权限”按钮，申请开通。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_caa3d7063af9b35666933809a03e6a1a.png) * 回调配置 1. 选择“回调配置”页签，单击“订阅方式”旁的编辑按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_854a4ec4031019ba11d48ab6c3438806.png) 2. 选择“使用 **长连接** 接收回调”，并单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_130cf2011c8b9dcd30e81e41f9b602ee.png) 3. 在添加回调对话框中，选择“卡片”页签，并勾选“卡片回传交互”，单击“确认添加”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f5f0d888fa1e24d1d54d5de250f584e2.png) 7. 新建机器人版本并发布。 1. 单击顶部的“创建版本”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_800d6c7dd926bb77b7cead67ef8586e5.png) 2. 按需配置应用版本号、默认能力及更新说明等信息。[了解更多](https://open.larkoffice.com/document/best-practices/intro-to-custom-app-review) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0d5aed2b0fec9906af56a0284f656c75.png) 3. 单击页面底部的“保存”按钮，创建版本。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f5e63e15c8b10e13cc1be20b93841fd1.png) 4. 单击页面右上角的“确认发布”按钮，完成应用发布。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_25550af4ea9aea79198c7c75d756f36f.png) 8. 和飞书应用配对。 1. 向机器人发送任意消息（例如：介绍下自己）。 2. 根据机器人回复，获取Pairing code。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ef31985647328fc409ab606bdae16a19.png) 3. [登录目标实例](https://www.volcengine.com/docs/6396/67747)。 1. 执行`openclaw pairing approve feishu <您获取的Pairing code> --notify`命令完成配对。 2. 回到飞书机器人聊天框，根据提示完成授权。

说明

若您不想在此刻进行授权，也可以直接与飞书机器人开始对话。有需要时，可在飞书机器人对话框中输入/feishu auth发起批量授权。

9. 至此，您已成功集成飞书机器人，可正式在飞书中使用您的定制化私人AI助手。 ## 使用AI助手飞书应用发布成功后，您可以在飞书中与AI助手进行对话并为其安排任务。 1. 在您的飞书中打开“开发者小助手”的消息通知，并单击“打开应用”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3b3c2e6a0712519a4202e453b644288d.png) 2. 本文以如下示例，展示了AI助手的工作流程。 **飞书机器人玩法示例** 您不仅可以通过飞书机器人与ArkClaw进行对话，ArkClaw也能通过飞书机器人帮您管理飞书文档、搜索飞书中的消息进行汇总、为您添加飞书日程等操作。 **通过对话安排任务** * **任务1：生成春节主题图片** * 使用的Prompt：春节主题，使用image_generate工具按时间顺序生成四张分镜图片，一次性构造4个独立task来生成图片；若用户未指定风格，默认采用“上海美术卡通风格”。生成后，4张图片发给我。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ac399625d315d7022dbd46d3193a6531.png) * 生成结果： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b3a41a81e59142cd10ea0fa586b532f2.png) * **任务2：使用“任务1”生成的图片制作视频** * 使用的Prompt：用这4张图片做完首尾帧生成3段视频带配音，使用video\-generate和480P配置，单个文件不要超过5MB，把生成的mp4文件压缩后单独发给我。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8c84697d7a7ad2eb80e84f89226a437c.png) * 生成结果： ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9c5e3dd1dfb62e1185485118e660ab9.png) **查看当前飞书插件支持的功能** * **Prompt示例：** 学习下最新安装的飞书插件，罗列出它有什么能力。 * **效果示例：**

**生成飞书文档** 您可以让ArkClaw将任务的结果保存为飞书文档，方便您通过飞书查看、分享。 * **Prompt示例：** 帮我调研下ClawHub中下载量最多的前10个Skill，将它们的功能、特点、安装方式等信息汇总为一个飞书文档。 * **效果示例：**

**安排日程** 您可以随时让ArkClaw帮您创建飞书日程、任务。 * **Prompt示例：** 帮我约一个明早上11\-12点的会，主题是业务进展汇总。 * **效果示例**

## 配置方舟Coding Plan 若您期望改用已订阅的[Coding Plan](https://www.volcengine.com/activity/codingplan)及其支持的模型，可根据本节指引，调整OpenClaw配置。 1. [登录云服务器实例](https://www.volcengine.com/docs/6396/67747)。 2. 执行如下命令，修改OpenClaw配置。

说明

请将替换为您在火山方舟创建的API Key。

请将替换为Coding Plan中包含的模型名称。您可以参考配置 Model Name（配置文件指定），获取模型名称。

```Bash openclaw config set models.providers.ark.baseUrl https://ark.cn-beijing.volces.com/api/coding/v3 openclaw config set models.providers.ark.apiKey openclaw config set models.providers.ark.models[0].id openclaw config set models.providers.ark.models[0].name openclaw models set ark/ openclaw gateway restart ```