使用OpenClaw搭建个人AI助手（飞书）
应用场景
随着人工智能技术的进步，个人AI助手已成为提升工作效率和生活质量的重要工具。在日常的在线交流中，人们经常需要与多种不同的AI助手互动，以获取信息或完成任务。然而，这些AI助手通常局限于特定的平台或模型，存在一定的使用限制，导致用户在不同平台间频繁切换，增加了操作复杂度。
OpenClaw（原名Moltbot、clawdbot）作为一种能够持续运行的AI智能体，能够调用多种大型语言模型，并作为网关，使用户可以通过通讯软件与多个AI模型进行交互，无需在不同平台之间切换，简化了操作流程。
Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信和钉钉，本文档介绍如何在Flexus L实例上使用OpenClaw应用镜像结合飞书快速搭建个人AI助手。
以下步骤为从零开始购买L实例并配置接入通讯软件，如果有部分步骤已完成，可按需跳过。
步骤一：部署OpenClaw应用镜像的L实例
您可以新购买OpenClaw应用镜像的L实例，也可以使用已有L实例部署OpenClaw应用镜像。
- 进入Flexus应用服务器L实例购买页。
- 对Flexus应用服务器L实例进行资源配置。 图1 选择OpenClaw镜像
参数
示例
说明
区域
北京-北京四
请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。
应用镜像
OpenClaw
选择OpenClaw应用镜像。
实例规格
2核4G、系统盘50GiB
OpenClaw应用镜像的运行配置建议选择2核4GiB及以上，您可根据您的业务需求选择Flexus应用服务器L实例规格。
实例名称
OpenClaw-Example
请自定义方便您识别的实例名称，例如OpenClaw-Example。
您可能需要（可选）
- 数据盘：10GiB
- 主机安全
- 云备份：50GB
请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。
购买时长
1个月
单次购买最短为1个月，最长为3年。
Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见自动续费。
购买数量
1台
设置您购买的Flexus应用服务器L实例数量。
- 单击“下一步：确认配置”，进入订单详情页面。
- 单击“去支付”，根据页面提示完成支付。
- 单击“返回华为云Flexus云服务控制台”，查看已创建的Flexus应用服务器L实例。
- 登录Flexus应用服务器L实例控制台，查看目标L实例是否为OpenClaw应用镜像。
- 单击L实例资源卡片上的
图标，单击“切换镜像”。按照界面提示切换为OpenClaw应用镜像，待切换成功且L实例为运行中时，进行下一步。 
切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。
（可选）步骤二：配置安全组
创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。
- 在Flexus应用服务器L实例控制台，单击资源卡片或名称，进入资源页面。
- 在左侧列表中选择“云主机 VM”，单击云主机名称，进入云主机详情页面。
- 选择“安全组”页签，确保使用以下默认安全组规则。 您也可以根据实际需要添加更多规则，详情请参见配置Flexus L实例安全组规则。
安全组入方向规则的源地址设置为0.0.0.0/0或::/0，表示允许或拒绝所有外部IP地址访问您的实例，如果将“22、3389、8848”等高危端口暴露到公网，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。建议您将安全组规则设置为仅允许已知的IP地址访问。
表1 安全组规则 优先级
策略
类型
协议端口
源地址
描述
1
允许
IPv4
TCP：全部
sg-default-smb
针对全部IPv4协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。
1
允许
IPv6
TCP：全部
sg-default-smb
针对全部IPv6协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。
步骤三：模型配置
- 登录Flexus应用服务器L实例控制台。
- 单击目标L实例资源卡片上的“立即配置”，进入应用详情页面。
如果页面未显示“立即配置”，请单击资源卡片，进入资源详情页面，在左侧列表中单击“应用详情”。
OpenClaw应用镜像的部分功能（如查询网关状态、更新模型及应用配置等）依赖云运维中心（Cloud Operations Center，简称COC），需要先授权并开通COC服务。如果出现下图提示，请按界面提示授权并开通。
- 在应用管理卡片中可以查看应用状态以及执行应用管理操作。
当页面长时间未刷新，或者需要查看网关状态是否有变化时，可以单击刷新按钮，查看当前最新的版本和状态信息。
表2 应用信息 应用信息
示例
说明
版本
2026.3.24
OpenClaw版本。
状态
运行中
OpenClaw网关状态。
- 运行中：OpenClaw网关状态为运行中时表示OpenClaw服务正常。
- 未知/异常：OpenClaw网关初始状态为加载中，如果等待几分钟后变更为未知或异常，请单击“重启”，重启需要一定时间，请耐心等待，重启成功后将变更为运行中。
说明：如果单击“重启”后，网关状态依旧为未知或者异常，请提交工单。
应用管理操作详情请参见OpenCLaw应用管理信息及操作。
- 在模型配置卡片中可以配置如下信息。
表3 模型配置信息 参数
示例
说明
模型提供商
华为云MaaS
模型提供商当前支持选择华为云MaaS。华为云MaaS的模型按实际用量计费，详情请参见计费详情。
如果华为云MaaS提供对接的AI模型中没有您需要的模型，可以选择对接自定义模型，更多详情请参考OpenClaw对接自定义AI模型。
API Key
HpkNxxxxxxxxxxxxxxxxxxxxxxxrHZw
API Key支持使用“西南-贵阳一”区域已创建的API Key或者按照界面提示新建“西南-贵阳一”区域的API Key。注意：API Key仅会在新建后显示一次，请及时复制并妥善保存，如果丢失，请新建API Key。
- 单击“添加模型”，弹窗中会展示即将批量添加的华为云MaaS所有可用的AI模型，首次添加模型时需要阅读并勾选MaaS服务声明。
- 单击“确定”，可以在模型列表中查看已添加的模型。首次添加华为云MaaS模型会自动设置DeepSeek-V3.2为默认模型。
- 模型添加成功后，您可以参考表3对已配置模型进行管理。
- 登录Flexus应用服务器L实例控制台。单击目标L实例资源卡片上的“立即配置”，进入应用详情页面。
- 在通道配置卡片中，选择“飞书”通道，在快捷配置页签下，单击“添加机器人”。
- 使用飞书APP扫描弹窗中的二维码。
- 在飞书APP中依次单击“立即创建 > 继续创建 > 打开应用”，完成机器人的创建并进入机器人的聊天对话框。
- 在聊天窗口，与机器人对话，机器人可以正常回复表示对接已完成。
- 机器人配置完成后，返回Flexus应用服务器L实例控制台，在应用详情页的已接入通道列表中查看已配置的机器人。
- 您也可以继续添加机器人，当前所有通道下的机器人总数最多支持10个。
- 企业微信、QQ机器人通道下暂时仅支持配置一个机器人。
- 登录飞书开放平台，选择已有应用。如果没有自建应用，可以单击“创建企业自建应用”。 图2 选择应用
- 在左侧菜单单击“添加应用能力”，然后添加机器人。 图3 添加机器人
- 配置相关权限，允许机器人拥有获取信息等基础能力。选择左侧菜单的权限管理，单击“批量导入/导出权限”，导入以下权限：
{ "scopes": { "tenant": [ "contact:contact.base:readonly", "docx:document", "docx:document.block:convert", "docx:document:readonly", "drive:drive", "drive:drive:readonly", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message.reactions:read", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:update", "im:resource", "wiki:wiki", "wiki:wiki:readonly", "cardkit:card:write", "contact:user.id:readonly" ], "user": [] } }图4 配置权限
- 发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.0）、更新说明，单击“保存”后确认发布。 图5 发布版本
- 获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于OpenClaw应用配置的填写。 图6 获取凭证
- 返回Flexus应用服务器L实例控制台。单击目标L实例资源卡片上的“立即配置”，进入应用详情页面。
- 在通道配置卡片中，配置如下信息后，单击“添加机器人”。
表4 机器人配置信息 参数
示例
说明
通道
飞书
选择需要对接的通道。
机器人信息
- cli_xxxxxxxxxxx
- your_app_secret
机器人的凭证信息：填写步骤二中已创建机器人的凭证信息。- App ID：飞书机器人的ID标识。
- App Secret：飞书机器人的密钥。
- 机器人配置完成后，可以在已接入通道列表中查看已配置的机器人。您也可以参考机器人管理操作对已配置机器人进行管理。
- 您也可以继续添加机器人，当前所有通道下的机器人总数最多支持10个。
- 企业微信、QQ机器人通道下暂时仅支持配置一个机器人。
- 返回飞书开放平台，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择“使用长连接接收事件”。 可以单击“验证”测试连接是否成功，验证成功后，单击“保存”。图7 配置回调
如果报错提示“应用未建立长连接”，请检查前面步骤中的机器人App ID和App Secret是否配置正确。
- 单击“添加事件”，搜索接收消息，选中后单击“添加”。
- 再次发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.1）、更新说明，单击“保存”后确认发布。 图8 再次发布
- 测试对话。
（可选）步骤五：安装技能
- 登录Flexus应用服务器L实例控制台。单击目标L实例资源卡片上的“立即配置”，进入应用详情页面。
- 在技能卡片中，可以在已安装技能列表中查看当前已安装的技能，包含OpenClaw镜像预置的技能。
- 当前支持在线安装官方技能，技能详细信息请前往ClawHub社区Skills查询。请单击目标技能进入技能详情页后，在CLI中获取可供安装的技能名称。此处以Skill Vetter为例，安装时使用Skill Vetter安装会失败，需要使用skill-vetter作为技能名称进行安装。
- 在输入框中输入需要安装的技能名称，单击“添加技能”。
- 安装成功后，您可以在技能列表中，查看已安装的技能。
（可选）步骤六：重置密码并登录Flexus L实例
Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
- 在资源卡片上，单击
图标，单击“重置密码”，或者在列表视图中单击操作列下的“重置密码”，设置Flexus L实例的密码。 图10 重置密码
- 单击资源卡片上的“远程登录”按钮，或者单击列表视图操作列下的“远程登录”，在弹出的登录窗口中，单击“VNC登录”，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见登录方式概述。
用户名为root，密码为上一步设置的密码。
常见问题
在群聊中@飞书机器人时，机器人不回复
问题现象：已按照指导完成配置，在飞书APP中创建群组并邀请机器人入群后，@飞书机器人，机器人不回复。
可能原因：飞书APP中的机器人名称与L实例控制台中的机器人别名（即OpenClaw应用配置文件中的飞书机器人botName名称）不一致。
解决建议：
- 方法一：登录飞书开放平台，查看已创建应用名称，将其修改为L实例控制台中的机器人别名。
- 方法二：在飞书机器人聊天窗口直接对话修改，其中xxx替换为飞书APP中机器人的名称。
请修改配置文件 /home/openclaw/.openclaw/openclaw.json，将 botName 字段改为"xxx"。
修改完成后，让机器人执行以下命令，重启网关。
openclaw gateway restart
- 方法三：登录Flexus应用服务器L实例控制台，单击资源卡片上的“立即配置”，进入应用详情页，在已接入通道中，单击目标机器人的别名修改按钮，修改别名使其与飞书APP中机器人名称一致。修改完成后单击应用管理中的重启。
L实例控制台设置机器人别名时，长度支持3到20个字符，输入支持小写英文字母、数字、中划线，暂不支持中文字符。如果需要将机器人别名修改为包含中文字符的名称，请参考方法二操作。
更多常见问题请参见OpenClaw常见问题汇总。
相关文档
- 如果您需要对OpenClaw进行应用管理、模型配置、通道配置或在线安装技能，请参考配置OpenClaw应用操作。
- OpenClaw应用镜像的运行配置建议选择2核4GiB及以上。如需升级规格请参见变更Flexus L实例规格。
