文档中心

云服务器

通过应用模板快速部署OpenClaw

快速部署OpenClaw，集成飞书AI助手

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

变更历史

注意

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

更新时间	说明
2026年03月05日	同步支持社区2026年3月2日版本最新能力，并支持2026.3.4版飞书插件。说明使用旧版本应用模板创建的云服务器实例，可根据解决方案指引升级OpenClaw及飞书插件版本，升级后即可体验新版飞书插件功能。
2026年02月27日	同步支持社区2026年2月23日版本最新能力。
2026年02月12日	集成AI助手安全防护功能，开启后即可获得针对OpenClaw的企业级安全防护。说明未通过控制台开启本功能的新购/已有实例，可根据解决方案指引，手动开启本功能。
2026年02月10日	修复飞书插件冲突问题，并同步支持社区2026年2月6日版本的最新能力。

功能特色

火山引擎为您提供了快速部署OpenClaw的应用模板，不仅可以帮助您快速完成OpenClaw部署并集成飞书企业应用，还为您集成了AgentKit提供的常用Skills。同时，还支持了原生支持生图、生视频的多模态能力。

对于开发者，特别是个人开发场景，火山方舟为您提供了Coding Plan方案，支持主流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)模型。

接入说明

本文主要通过如下两个场景介绍如何快速在云服务器中部署OpenClaw，并在飞书中配置您的定制化私人AI助手。

场景一：购买后配置模型并集成飞书应用：本场景适用于还未开通火山方舟大模型服务或未创建飞书企业应用的用户，为您提供了开通服务、创建飞书企业应用及在实例内完成OpenClaw与飞书集成的配置完整指引。

场景二：购买时配置模型并集成飞书应用：本场景适用于已开通火山方舟大模型服务且已创建飞书企业应用的用户，您可以在购买实例时通过“高级配置”快速配置方舟模型与飞书企业应用信息，后续仅需在OpenClaw服务启动成功后，确认已有飞书应用权限及长连接配置符合要求即可完成集成操作。

购买后配置模型并集成飞书应用

您可以在购买ECS实例后，开通火山方舟大模型服务并创建飞书企业应用，并在实例内快速与OpenClaw进行集成。

注意

本节内容适用于还未开通火山方舟大模型服务或未创建飞书企业应用的用户。否则，请参考购买时配置模型并集成飞书应用指引进行操作。

步骤一：创建ECS服务器

点此登录云服务器控制台。

通过应用模板快速购买预置了OpenClaw的云服务器，配置如下参数。

参数	说明
实例配置
应用模板	选择“OpenClaw”。
计费类型	选择实例计费类型，本文以“包年包月”为例。了解更多。
地域	选择实例所在地域，本文以“华东2（上海）”为例。了解更多。说明暂仅支持华南1（广州）、华北2（北京）、华东2（上海）及亚太东南（雅加达）地域。了解更多。
套餐规格	选择实例规格，选择2 vCPU、2 GiB内存及以上规格即可。本文以“e-c1m1、2 vCPU、2 GiB”规格为例。
登录密码	配置实例登录密码。
确认密码	再次输入实例登录密码进行确认。
安全防护	选择是否启用AI助手安全功能。（推荐）启用：请阅读《AI 助手安全 SDK 协议》后，勾选开启AI助手安全功能。说明开启后，AI助手安全功能将在不影响OpenClaw正常工作的前提下，实时监测和防御提示词注入（Prompt Injection）、敏感信息泄露（PII Leakage）、高危操作（Risky Operations）三类核心风险。了解更多。未通过控制台开启本功能的新购/已有实例，建议您根据解决方案指引手动开启本功能，降低数据泄露、系统损坏及财产损失等风险。不启用：不使用相关服务。
角色授权	选择是否为云助手完成所需角色授权。（推荐）授权：请勾选“确认授权云助手所需角色”按钮，授权完成后方可执行版本升级、数据同步等相关操作。说明授权后，您可通过应用管理功能，查看Coding Plan套餐用量、升级OpenClaw版本、管理其关联模型与消息渠道。了解更多。不授权：不使用相关服务。
高级配置：购买后进行配置，保持默认即可。

在右侧“配置详情”中确认实例配置及费用信息，并勾选“我已阅读并同意《云服务器服务条款》”。

单击“立即购买”按钮，完成购买操作。

您还可以单击“去控制台”按钮，前往实例列表页查看新创建的实例规格信息，还可通过控制台登录实例。

步骤二：开通方舟大模型服务并获取配置

您可以参考本节指引，开通方舟大模型服务并获取API Key。

请登录开通管理页面，选择您期望为OpenClaw提供推理服务的模型家族。

在左侧目录树选择“系统管理 > API Key 管理”，创建并获取API Key。

说明

获取的API Key将用于配置OpenClaw，请妥善保存。

在左侧目录树选择“智能广场 > 模型广场”，单击您期望OpenClaw使用的具体模型进入其详情页。本文以“Doubao-Seed-Code”为例。

单击复制按钮，获取模型的“Model ID”。

说明

获取的Model ID将用于配置OpenClaw，请妥善保存。

步骤三：创建飞书机器人并获取配置

创建企业自建应用。

登录飞书开发者平台，单击“创建企业自建应用”按钮。

需配置应用名、描述及图标。

单击“创建”按钮，完成操作。

添加机器人能力。

在左侧目录树选择“应用能力 > 添加应用能力”。

选择“按能力添加”页签，单击“机器人”能力卡片的“添加”按钮。

配置权限。

在左侧目录树选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。

在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。

{
"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"
]
}
}

在弹窗中确认权限无误后，单击“申请开通”按钮。

说明

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

单击“配置”按钮设置权限可访问的数据范围（本文保持默认“与应用的可用范围一致”），单击“确定”按钮完成操作。

获取配置信息。

在左侧目录树选择“基础信息 > 凭证与基础信息”。

在“应用凭证”模块中，获取并记录App ID与App Secret信息。

说明

获取的App ID与App Secret将用于配置OpenClaw，请妥善保存。

发布应用。

单击顶部的“创建版本”按钮。

按需配置应用版本号、默认能力及更新说明等信息。了解更多。

单击页面底部的“保存”按钮，创建版本。

单击页面右上角的“确认发布”按钮，完成应用发布。

步骤四：配置OpenClaw飞书AI助手

登录云服务器实例。

执行如下命令，配置模型和飞书集成的参数。

curl -fsSL https://openclaw.tos-cn-beijing.volces.com/setup.sh | bash -s -- \
--ark-coding-plan "true" \
--ark-model-id "doubao-seed-code" \
--ark-api-key "请替换为方舟API Key" \
--feishu-app-id "请替换为飞书APP ID" \
--feishu-app-secret "请替换为飞书APP Secret"

说明

请根据实际情况，调整命令中如下参数取值：

--ark-coding-plan：用于指定是否使用您订阅的Coding Plan。

若您已经订阅了Coding Plan，请传入true。

若您未订阅方舟Coding Plan，请传入false。建议您订阅方舟Coding Plan，包月低至9.9元，模型调用自由。

--ark-model-id：用于指定您期望OpenClaw使用的方舟模型。

若--ark-coding-plan参数配置为true，请将doubao-seed-code替换为Coding Plan支持的模型名称。您可以参考配置 Model Name（配置文件指定），获取模型名称。

若--ark-coding-plan参数配置为false，请将doubao-seed-code替换为您期望使用的方舟模型ID。

--ark-api-key：用于指定方舟模型API Key。

--feishu-app-id：用于指定飞书机器人App ID。

--feishu-app-secret：用于指定飞书机器人App Secret。

回显如下所示时，表示已成功完成配置。

登录飞书开发者平台。

选择“企业自建应用”页签，并单击您创建的飞书开放应用。

在左侧目录树选择“开发配置 > 事件与回调”。

事件配置

选择“事件配置”页签，单击“订阅方式”旁的编辑按钮。

选择“使用长连接接收事件”，并单击“保存”按钮。

在“已添加事件”区域，单击“添加事件”按钮。

在添加事件对话框中，选择“应用身份订阅”页签，搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件，单击“确认添加”按钮。

（可选）若您期望将机器人添加到聊天群组中使用，需开通获取群组消息权限。否则，请跳过本步骤。

注意

由于OpenClaw是个人AI助手，在群聊场景下可能存在凭证泄露等风险，请谨慎使用。

在“已添加事件”模块中，单击“接收消息”事件“所需权限”列的“查看其它权限”按钮。

单击“获取群组中所有消息（敏感权限）”。

在弹窗中单击“开通权限”按钮，申请开通。

回调配置

选择“回调配置”页签，单击“订阅方式”旁的编辑按钮。

选择“使用长连接接收回调”，并单击“保存”按钮。

在添加回调对话框中，选择“卡片”页签，并勾选“卡片回传交互”，单击“确认添加”按钮。

新建机器人版本并发布。

单击顶部的“创建版本”按钮。

按需配置应用版本号、默认能力及更新说明等信息。了解更多。

单击页面底部的“保存”按钮，创建版本。

单击页面右上角的“确认发布”按钮，完成应用发布。

和飞书应用配对。

向机器人发送任意消息（例如：介绍下自己）。

根据机器人回复，获取Pairing code。

登录目标实例。

执行openclaw pairing approve feishu <您获取的Pairing code> --notify命令完成配对。

回到飞书机器人聊天框，根据提示完成授权。

说明

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

Replay

Play
00:00 / 00:00 Live

00:00

Fullscreen

Cssfullscreen

1x

2x
1.5x
1x
0.75x
0.5x

Click and hold to drag

至此，您已成功集成飞书机器人，可正式在飞书中使用您的定制化私人AI助手。

购买时配置模型并集成飞书应用

您可以在购买ECS实例时，快速集成OpenClaw，更加高效便捷。

注意

本节内容适用于已开通火山方舟大模型服务并创建了飞书企业应用的用户。否则，请参考购买后配置模型并集成飞书应用指引进行操作。

前提条件

已开通火山方舟大模型服务，创建并获取API Key。

已创建飞书应用，并为应用添加“机器人”能力。

步骤一：创建ECS服务器

点此登录云服务器控制台。

通过应用模板快速购买预置了OpenClaw的云服务器，配置如下参数。

参数	说明
实例配置
应用模板	选择“OpenClaw”。
计费类型	选择实例计费类型，本文以“包年包月”为例。了解更多。
地域	选择实例所在地域，本文以“华东2（上海）”为例。说明暂仅支持华南1（广州）、华北2（北京）、华东2（上海）及亚太东南（雅加达）地域。了解更多。
套餐规格	选择实例规格，选择2 vCPU、2 GiB内存及以上规格即可。本文以“e-c1m1、2 vCPU、2 GiB”规格为例。
登录密码	配置实例登录密码。
确认密码	再次输入实例登录密码进行确认。
安全防护	选择是否启用AI助手安全功能。（推荐）启用：请阅读《AI 助手安全 SDK 协议》后，勾选开启AI助手安全功能。说明开启后，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的重要身份标识，请妥善保管，避免泄露。

在右侧“配置详情”中确认实例配置及费用信息，并勾选“我已阅读并同意《云服务器服务条款》”。

单击“立即购买”按钮，完成购买操作。

您还可以单击“去控制台”按钮，前往实例列表页查看新创建的实例规格信息，还可通过控制台登录实例。

步骤二：配置OpenClaw飞书AI助手

登录云服务器实例。

执行如下命令，查看OpenClaw服务运行状态，确认其是否正常启动。

systemctl --user status openclaw-gateway.service

若回显中服务状态为 active (running)，表示OpenClaw服务已正常启动，请继续进行后续操作。

登录飞书开发者平台。

选择“企业自建应用”页签，并单击您创建的飞书开放应用。

配置权限。

在左侧目录树选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。

在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。

{
"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"
]
}
}

在弹窗中确认权限无误后，单击“申请开通”按钮，完成操作。

说明

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

进入您创建的飞书应用详情页，并在左侧目录树选择“开发配置 > 事件与回调”。

事件配置

选择“事件配置”页签，单击“订阅方式”旁的编辑按钮。

选择“使用长连接接收事件”，并单击“保存”按钮。

在“已添加事件”区域，单击“添加事件”按钮。

在添加事件对话框中，选择“应用身份订阅”页签，搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件，单击“确认添加”按钮。

（可选）若您期望将机器人添加到聊天群组中使用，需开通获取群组消息权限。否则，请跳过本步骤。

在“已添加事件”模块中，单击“接收消息”事件“所需权限”列的“查看其它权限”按钮。

单击“获取群组中所有消息（敏感权限）”。

在弹窗中单击“开通权限”按钮，申请开通。

回调配置

选择“回调配置”页签，单击“订阅方式”旁的编辑按钮。

选择“使用长连接接收回调”，并单击“保存”按钮。

在添加回调对话框中，选择“卡片”页签，并勾选“卡片回传交互”，单击“确认添加”按钮。

新建机器人版本并发布。

单击顶部的“创建版本”按钮。

按需配置应用版本号、默认能力及更新说明等信息。了解更多。

单击页面底部的“保存”按钮，创建版本。

单击页面右上角的“确认发布”按钮，完成应用发布。

和飞书应用配对。

向机器人发送任意消息（例如：介绍下自己）。

根据机器人回复，获取Pairing code。

登录目标实例。

执行openclaw pairing approve feishu <您获取的Pairing code> --notify命令完成配对。

回到飞书机器人聊天框，根据提示完成授权。

说明

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

Replay

Play
00:00 / 00:00 Live

00:00

Fullscreen

Cssfullscreen

1x

2x
1.5x
1x
0.75x
0.5x

Click and hold to drag

至此，您已成功集成飞书机器人，可正式在飞书中使用您的定制化私人AI助手。

使用AI助手

飞书应用发布成功后，您可以在飞书中与AI助手进行对话并为其安排任务。

在您的飞书中打开“开发者小助手”的消息通知，并单击“打开应用”按钮。

本文以如下示例，展示了AI助手的工作流程。

飞书机器人玩法示例
您不仅可以通过飞书机器人与ArkClaw进行对话，ArkClaw也能通过飞书机器人帮您管理飞书文档、搜索飞书中的消息进行汇总、为您添加飞书日程等操作。
通过对话安排任务

查看当前飞书插件支持的功能

生成飞书文档

安排日程

配置方舟Coding Plan

若您期望改用已订阅的Coding Plan及其支持的模型，可根据本节指引，调整OpenClaw配置。

登录云服务器实例。

执行如下命令，修改OpenClaw配置。

说明

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

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

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

最近更新时间：2026.05.28 19:37:03

这个页面对您有帮助吗？

有用

无用