# 使用OpenClaw搭建个人AI助手（飞书） #### 应用场景 随着人工智能技术的进步，个人AI助手已成为提升工作效率和生活质量的重要工具。在日常的在线交流中，人们经常需要与多种不同的AI助手互动，以获取信息或完成任务。然而，这些AI助手通常局限于特定的平台或模型，存在一定的使用限制，导致用户在不同平台间频繁切换，增加了操作复杂度。 [OpenClaw](https://openclaw.ai/)（原名Moltbot、clawdbot）作为一种能够持续运行的AI智能体，能够调用多种大型语言模型，并作为网关，使用户可以通过通讯软件与多个AI模型进行交互，无需在不同平台之间切换，简化了操作流程。 Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信、微信和钉钉，本文档介绍如何在Flexus L实例上使用OpenClaw应用镜像结合飞书快速搭建个人AI助手。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) Flexus L实例提供的OpenClaw应用镜像使用官方开源脚本安装，部署前请阅读[OpenClaw风险说明及安全建议](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0010.html)。 以下步骤为从零开始购买L实例并配置接入通讯软件，如果有部分步骤已完成，可按需跳过。 #### 步骤一：部署OpenClaw应用镜像的L实例 您可以新购买OpenClaw应用镜像的L实例，也可以使用已有L实例部署OpenClaw应用镜像。 - [新购OpenClaw镜像的L实例] 1. 进入[Flexus应用服务器L实例购买页](https://console.huaweicloud.com/smb/?locale=zh-cn#/create/hecs-light?image_name=OpenClaw&plan=basic_v10&resource_spec_code=hf.large.2.3m.linux)。 2. 对Flexus应用服务器L实例进行资源配置。 图1选择OpenClaw镜像 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609480285.png "点击放大") | 参数 | 示例 | 说明 | |:---|:---|:---| | 区域 | **华北-北京四** | 请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。Flexus应用服务器L实例创建后无法更换区域，请谨慎选择。 | | 应用镜像 | **OpenClaw** | 选择OpenClaw应用镜像。 | | 实例规格 | **2核4G** 、**系统盘50GiB** | OpenClaw应用镜像的运行配置**建议选择2核4GiB及以上**，您可根据您的业务需求选择Flexus应用服务器L实例规格。 | | 实例名称 | **OpenClaw-Example** | 请自定义方便您识别的实例名称，例如OpenClaw-Example。 | | 您可能需要（可选） | - **数据盘：** **10GiB** - **主机安全** - **云备份：** **50GB** | 请根据您的业务需要自主选择数据盘、主机安全、云备份附加服务并设置规格。 | | 购买时长 | **1个月** | 设置购买时长。 Flexus应用服务器L实例支持自动续费功能。勾选后，在Flexus应用服务器L实例到期前自动续费。如果您购买时未开通自动续费，后续仍可以在控制台开通。自动续费的更多信息详见[自动续费](https://support.huaweicloud.com/productdesc-flexusl/pd_billing_0002.html#section3)。 | | 购买数量 | **1台** | 设置您购买的Flexus应用服务器L实例数量。 | 3. 单击"下一步：确认配置"，进入订单详情页面。 根据界面提示，请确认配置信息，阅读并勾选协议。 4. 单击"去支付"，根据页面提示完成支付。 5. 单击"返回华为云Flexus云服务控制台"，查看已创建的Flexus应用服务器L实例。 - [使用已有L实例配置OpenClaw] 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)，查看目标L实例是否为OpenClaw应用镜像。 - 如是，请执行[步骤四：通道配置]； - 如不是，请执行步骤[2]。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579160384.png) 2. 单击L实例资源卡片上的![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579000460.png)图标，单击"切换镜像"。按照界面提示切换为OpenClaw应用镜像，待切换成功且L实例为运行中时，进行下一步。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/caution_3.0-zh-cn.png) 切换镜像会清除原系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609360379.png "点击放大") #### （可选）步骤二：配置安全组 创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。 1. 在[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?&locale=zh-cn#/resource/list)，单击资源卡片或名称，进入资源页面。 2. 选择"安全组"页签，确保使用以下默认安全组规则。 您也可以根据实际需要添加更多规则，详情请参见[配置Flexus L实例安全组规则](https://support.huaweicloud.com/usermanual-flexusl/security_admin_0004.html)。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 安全组入方向规则的源地址设置为0.0.0.0/0或::/0，表示允许或拒绝所有外部IP地址访问您的实例，如果将"22、3389、8848"等高危端口暴露到公网，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。**建议您将安全组规则设置为仅允许已知的IP地址访问。** ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586563501.png "点击放大") 表1安全组规则 | 优先级 | 策略 | 类型 | 协议端口 | 源地址 | 描述 | |:---|:---|:---|:---|:---|:---| | 1 | 允许 | IPv4 | TCP：全部 | sg-default-smb | 针对全部IPv4协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。 | | 1 | 允许 | IPv6 | TCP：全部 | sg-default-smb | 针对全部IPv6协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。 | #### 步骤三：模型配置 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。 2. 单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 如果页面未显示"立即配置"，请单击资源卡片，进入资源详情页面，在左侧列表中单击"应用详情"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586338305.png "点击放大") OpenClaw应用镜像的部分功能（如查询网关状态、更新模型及应用配置等）依赖云运维中心（Cloud Operations Center，简称COC），需要**先授权并开通COC服务**。如果出现下图提示，请按界面提示授权并开通。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609479657.png "点击放大") 3. 在应用管理卡片中可以查看应用状态以及执行应用管理操作。 当页面长时间未刷新，或者需要查看网关状态是否有变化时，可以单击刷新按钮，查看当前最新的版本和状态信息。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002664320361.png "点击放大") 表2应用信息 | 应用信息 | 示例 | 说明 | |:---|:---|:---| | 版本 | 2026.3.24 | OpenClaw版本。 | | 状态 | 运行中 | OpenClaw网关状态。 - 运行中：OpenClaw网关状态为运行中时表示OpenClaw服务正常。 - 未知/异常：OpenClaw网关初始状态为加载中，如果等待几分钟后变更为未知或异常，请单击"重启"，重启需要一定时间，请耐心等待，重启成功后将变更为运行中。 说明： 如果单击"重启"后，网关状态依旧为未知或者异常，请[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)。 | **应用管理操作详情请参见[OpenClaw应用管理信息及操作](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#flexusl_bp_0007__li452834413429)。** 4. 在模型配置卡片中可以配置如下信息。 表3模型配置信息 | 参数 | 示例 | 说明 | |:---|:---|:---| | 模型提供商 | 华为云MaaS | - 华为云MaaS Token Plan [MaaS Token Plan](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html)是专为开发者设计的订阅服务，覆盖主流模型。添加前需确认已[购买Token Plan](https://console.huaweicloud.com/modelarts/?region=cn-southwest-2#/model-studio/resourcePlanManagement)套餐，若未购买，添加模型后将无法正常使用。套餐计费详情请参见[MaaS Token Plan计费项](https://support.huaweicloud.com/price-maas/price-maas-0035.html)。 - 华为云MaaS 模型API 华为云MaaS的模型按实际用量计费，详情请参见[计费详情](https://support.huaweicloud.com/price-maas/price-maas-0002.html)。 - 自定义模型 如果华为云MaaS提供对接的AI模型中没有您需要的模型，可以选择对接自定义模型，更多详情请参考[OpenClaw对接自定义AI模型](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0006.html)。 | | API Key | HpkNxxxxxxxxxxxxxxxxxxxxxxxrHZw | API Key支持使用"**西南-贵阳一** "区域已创建的API Key或者按照界面提示新建"**西南-贵阳一** "区域的API Key。 注意： API Key仅会在新建后显示一次，请及时复制并妥善保存，如果丢失，请新建API Key。 | 5. 单击"连通性检测"，系统将按照已填写信息测试模型是否已连通可用。该功能仅首次添加模型前显示。 6. 单击"添加模型"，弹窗会展示即将批量添加的所有可用的AI模型，首次添加MaaS模型时需要阅读并勾选MaaS服务声明。 7. 单击"确定"，可以在模型列表中查看已添加的模型。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - **首次添加模型时，如果您选择的是华为云MaaS或华为云MaaS Token Plan，添加模型后会自动设置DeepSeek-V3.2为默认模型，如需修改请自行切换。** - 如果已添加过模型并设置了默认模型，再次添加其他模型时，需要自行切换默认模型才能使用到新模型。 例如已添加华为云MaaS并设置DeepSeek-V3.2为默认模型，再次添加华为云MaaS Token Plan，则需要设置华为云MaaS Token Plan下的模型为默认模型，才能够使用到华为云MaaS Token Plan。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002665322987.png "点击放大") 8. 模型添加成功后，您可以参考[表3](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#flexusl_bp_0007__table64834218414)对已配置模型进行管理。 #### 步骤四：通道配置 您可以选择扫码快捷配置或者手动配置。 - [快捷配置] 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 2. 在通道配置卡片中，选择"飞书"通道，在快捷配置页签下，单击"添加机器人"。 3. 使用飞书APP扫描弹窗中的二维码。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579163136.png) 4. 在飞书APP中依次单击"立即创建 \> 继续创建 \> 打开应用"，完成机器人的创建并进入机器人的聊天对话框。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609489375.png "点击放大") 5. 在聊天窗口，与机器人对话，机器人可以正常回复表示对接已完成。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609364071.png) 6. 机器人配置完成后，返回[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)，在应用详情页的已接入通道列表中查看已配置的机器人。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002610138757.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - 您也可以继续添加机器人，当前所有通道下的机器人总数最多支持10个。 - 当前一个微信账号仅支持对接一个OpenClaw，如果该微信账号曾对接过其他OpenClaw，再次扫码对接后会自动切换绑定至当前OpenClaw；如需添加更多微信机器人，请使用不同的微信账号进行扫码对接。 - 企业微信、QQ机器人通道下暂时仅支持配置一个机器人。 - [手动配置] 1. 登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，选择已有应用。如果没有自建应用，可以单击"创建企业自建应用"。 图2选择应用 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609480287.png "点击放大") 2. 在左侧菜单单击"添加应用能力"，然后添加机器人。 图3添加机器人 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579160386.png "点击放大") 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配置权限 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579000462.png "点击放大") 4. 发布版本。单击页面左上方的"创建版本"，填写版本号（如1.0.0）、更新说明，单击"保存"后确认发布。 图5发布版本 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609360381.png "点击放大") 5. 获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于OpenClaw应用配置的填写。 图6获取凭证 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609480289.png "点击放大") 6. 返回[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 7. 在通道配置卡片中，配置如下信息后，单击"添加机器人"。 表4机器人配置信息 | 参数 | 示例 | 说明 | |:---|:---|:---| | 通道 | 飞书 | 选择需要对接的通道。 | | 机器人信息 | - cli_xxxxxxxxxxx - your_app_secret | 机器人的凭证信息：填写步骤二中已创建机器人的凭证信息。 - App ID：飞书机器人的ID标识。 - App Secret：飞书机器人的密钥。 | 8. 机器人配置完成后，可以在已接入通道列表中查看已配置的机器人。您也可以参考[机器人管理操作](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html#flexusl_bp_0007__table1249655217486)对已配置机器人进行管理。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609909879.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - 您也可以继续添加机器人，当前所有通道下的机器人总数最多支持10个。 - 当前一个微信账号仅支持对接一个OpenClaw，如果该微信账号曾对接过其他OpenClaw，再次扫码对接后会自动切换绑定至当前OpenClaw；如需添加更多微信机器人，请使用不同的微信账号进行扫码对接。 - 企业微信、QQ机器人通道下暂时仅支持配置一个机器人。 9. 返回[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择"使用长连接接收事件"。 可以单击"验证"测试连接是否成功，验证成功后，单击"保存"。 图7配置回调 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579012368.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 如果报错提示"应用未建立长连接"，请检查前面步骤中的机器人App ID和App Secret是否配置正确。 10. 单击"添加事件"，搜索接收消息，选中后单击"添加"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609372275.png "点击放大") 11. 再次发布版本。单击页面左上方的"创建版本"，填写版本号（如1.0.1）、更新说明，单击"保存"后确认发布。 图8再次发布 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609492195.png "点击放大") 12. 测试对话。 在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口，也可以在搜索框中搜索已创建的机器人名称，选中后进入聊天窗口，可以与机器人直接对话测试效果。 图9测试对话 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579172278.png) #### （可选）步骤五：安装技能 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 2. 在技能卡片中，可以在已安装技能列表中查看当前已安装的技能，包含OpenClaw镜像预置的技能。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002558758764.png "点击放大") 3. 当前支持在线安装官方技能，技能详细信息请前往[ClawHub社区Skills](https://clawhub.ai/skills?sort=downloads)查询。**请单击目标技能进入技能详情页后，在CLI中获取可供安装的技能名称。** 此处以[Skill Vetter](https://clawhub.ai/spclaudehome/skill-vetter)为例，安装时使用Skill Vetter安装会失败，需要使用skill-vetter作为技能名称进行安装。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 部分技能（例如Playwright MCP）使用时需要依赖其他组件，但技能安装时不会自动安装技能所需要的依赖，需要用户自行安装。详情请参见[在线安装技能后无法正常使用？](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0012.html#flexusl_bp_0012__section07861240142116)。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002664196669.png "点击放大") 4. 在输入框中输入需要安装的技能名称，单击"添加技能"。 确认技能名称无误后，单击"确定"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002563112838.png "点击放大") 5. 安装成功后，您可以在技能列表中，查看已安装的技能。 已安装的公共技能支持删除，删除后所有机器人将不能再使用该技能。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002563075490.png "点击放大") #### （可选）步骤六：重置密码并登录Flexus L实例 Flexus L实例无初始密码，创建Flexus L实例后，**如需登录云主机，请先设置Flexus L实例的密码。** 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 1. 在资源卡片上，单击![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002579000468.png)图标，单击"重置密码"，或者在列表视图中单击操作列下的"重置密码"，设置Flexus L实例的密码。 图10重置密码 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609360387.png) 2. 单击资源卡片上的"远程登录"按钮，或者单击列表视图操作列下的"远程登录"，在弹出的登录窗口中，单击"VNC登录"，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。 用户名为root，密码为上一步设置的密码。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002609480295.png) #### 常见问题 #### 在群聊中@飞书机器人时，机器人不回复 **问题现象**：已按照指导完成配置，在飞书APP中创建群组并邀请机器人入群后，@飞书机器人，机器人不回复。 **可能原因**：飞书APP中的机器人名称与L实例控制台中的机器人别名（即OpenClaw应用配置文件中的飞书机器人botName名称）不一致。 **解决建议**： - 方法一：登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，查看已创建应用名称，将其**修改为L实例控制台中的机器人别名** 。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002619182831.png "点击放大") - 方法二：在飞书机器人聊天窗口直接对话修改，其中xxx**替换为飞书APP中机器人的名称** 。 ``` 请修改配置文件 /home/openclaw/.openclaw/openclaw.json，将 botName 字段改为"xxx"。 ``` 修改完成后，让机器人执行以下命令，重启网关。 ``` openclaw gateway restart ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002588625546.png "点击放大") - 方法三：登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)，单击资源卡片上的"立即配置"，进入应用详情页，在已接入通道中，单击目标机器人的别名修改按钮，**修改别名使其与飞书APP中机器人名称一致** 。修改完成后单击应用管理中的**重启** 。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002619190119.png "点击放大") ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) L实例控制台设置机器人别名时，长度支持3到20个字符，输入支持小写英文字母、数字、中划线，暂不支持中文字符。如果需要将机器人别名修改为包含中文字符的名称，请参考方法二操作。 #### 对话时飞书机器人不回复 **问题现象**：已按照指导完成配置，与飞书机器人对话，机器人不回复。 **可能原因**：飞书机器人缺少"cardkit:card:write"权限。 **解决建议**： 1. 登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，在应用的权限管理页面查看已开通权限中是否存在"cardkit:card:write"权限，若没有，单击"开通权限"，查找并开通"cardkit:card:write"权限。 2. 返回L实例控制台，参考[通道配置](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0002.html#section4)，重新配置飞书应用信息。 **更多常见问题请参见[OpenClaw常见问题汇总](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0012.html)。** #### 相关文档 - 如果您需要对OpenClaw进行应用管理、模型配置、通道配置或在线安装技能，请参考[配置OpenClaw应用](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html)操作。 - OpenClaw应用镜像的运行配置**建议选择2核4GiB及以上** 。如需升级规格请参见[变更Flexus L实例规格](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0003.html)。