使用OpenClaw搭建个人AI助手（飞书）

应用场景

随着人工智能技术的进步，个人AI助手已成为提升工作效率和生活质量的重要工具。在日常的在线交流中，人们经常需要与多种不同的AI助手互动，以获取信息或完成任务。然而，这些AI助手通常局限于特定的平台或模型，存在一定的使用限制，导致用户在不同平台间频繁切换，增加了操作复杂度。

OpenClaw（原名Moltbot、clawdbot）作为一种能够持续运行的AI智能体，能够调用多种大型语言模型，并作为网关，使用户可以通过通讯软件与多个AI模型进行交互，无需在不同平台之间切换，简化了操作流程。

Flexus L实例提供的OpenClaw应用镜像支持对接飞书、QQ、企业微信和钉钉，本文档介绍如何在Flexus L实例上使用OpenClaw应用镜像结合飞书快速搭建个人AI助手。

Flexus L实例提供的OpenClaw应用镜像使用官方开源脚本安装，部署前请阅读OpenClaw风险说明及安全建议。

步骤一：部署OpenClaw应用镜像的L实例

您可以新购买OpenClaw应用镜像的L实例，也可以使用已有L实例部署OpenClaw应用镜像。

步骤二：创建通讯软件的应用

1. 登录飞书开放平台，选择已有应用。如果没有自建应用，可以单击“创建企业自建应用”。
   图2 选择应用
   
2. 在左侧菜单单击“添加应用能力”，然后添加机器人。
   图3 添加机器人
   
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"
       ],
       "user": []
     }
   }

   图4 配置权限
   
4. 发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.0）、更新说明，单击“保存”后确认发布。
   图5 发布版本
   
5. 获取凭证。选择左侧菜单的凭证与基础信息，复制App ID、App Secret用于OpenClaw应用配置的填写。
   图6 获取凭证
   

步骤三：配置OpenClaw应用

1. 登录Flexus应用服务器L实例控制台。
2. 单击目标L实例资源卡片上的“立即配置”，进入应用管理页面。

   如果页面未显示“立即配置”，请单击资源卡片，进入资源详情页面，在左侧列表中单击“应用管理”。

   OpenClaw应用镜像的部分功能（如查询网关状态、更新模型及应用配置等）依赖云运维中心（Cloud Operations Center，简称COC），需要先授权并开通COC服务。如果出现下图提示，请按界面提示授权并开通。

   

3. 在基础信息模块中可以查看以下信息，当UniAgent状态、网关状态均为运行中时，可进行下一步。
   

   表1 应用详情基础信息

   参数	示例	说明
   UniAgent状态	运行中	OpenClaw网关状态查询以及配置脚本下发等操作依赖应用运维管理（Application Operations Management，简称AOM）的统一数据采集Agent（简称UniAgent）。购买L实例后系统会自动安装UniAgent插件。UniAgent状态如下： 运行中：UniAgent插件状态正常。 安装中：UniAgent插件安装中，请耐心等待，安装完成后再对L实例进行操作。 异常：UniAgent插件状态异常。 安装失败：UniAgent插件安装失败。 未安装：UniAgent插件未安装。 说明： 如果UniAgent状态为异常、安装失败或未安装，请参考安装UniAgent进行手动安装。
   网关状态	运行中	OpenClaw网关状态。 运行中：OpenClaw网关状态为运行中时表示OpenClaw服务正常。 未知/异常：OpenClaw网关初始状态为加载中，如果等待几分钟后变更为未知或异常，请单击“重启”，重启需要一定时间，请耐心等待，重启成功后将变更为运行中。 说明： 如果单击“重启”后，网关状态依旧为未知或者异常，请提交工单。

4. 在配置信息模块，您可以配置模型、通道及按需安装Skills。

   模型配置

   1. 单击“模型配置”。单击“添加模型”，在右侧半屏页面中配置模型信息。

      表2 模型配置信息

      参数	示例	说明
      模型提供商	华为云MaaS	模型提供商当前支持选择华为云MaaS。 如果华为云MaaS提供对接的AI模型中没有您需要的模型，可以选择对接自定义模型，更多详情请参考OpenClaw对接自定义AI模型。
      模型	deepseek-v3.2	选择华为云MaaS提供的模型，如果所选模型尚未开通，在确定添加模型后，系统将自动开通“西南-贵阳一”区域的对应模型。模型开通后，将按模型实际调用用量计费，详情请见模型服务计费项。
      模型别名	ds3.2	自定义便于识别的模型名称。
      API Key	HpkNxxxxxxxxxxxxxxxxxxxxxxxrHZw	API Key支持使用“西南-贵阳一”区域已创建的API Key或者按照界面提示新建“西南-贵阳一”区域的API Key，更多详细信息请参见创建API Key。 注意： API Key仅会在新建后显示一次，请及时复制并妥善保存，如果丢失，请新建API Key。

   2. 模型配置完成后，单击“确定”，可以在模型列表中查看已配置的模型。首个添加的模型会自动设置为默认模型。
   3. 您也可以继续添加模型。单击模型操作列下的“设置默认”可以切换默认模型。

      变更默认模型后，重新发起的对话才会生效。您可以在机器人对话框中输入“/new 模型别名”（开启新对话）或“/model 模型别名”（保留上下文） 。

      

      在机器人对话框中输入/new开启新会话时，会导致机器人的记忆丢失，请谨慎操作。

   4. 您也可以删除模型，华为云MaaS已开通的模型删除后，可以在MaaS控制台进行查看和管理。
      

      删除模型后，机器人将无法再使用该模型，如需再次使用请重新添加模型。

   通道配置

   1. 单击“通道配置”，单击“添加机器人”，在弹窗中配置通道及机器人信息。
      

      表3 机器人配置信息

      参数	示例	说明
      通道	飞书	选择需要对接的通道。
      机器人信息	bot1 cli_xxxxxxxxxxx your_app_secret	机器人名称：您可以自定义设置方便识别的名称。 应用的凭证信息：填写步骤二中已创建机器人的凭证信息。 App ID：飞书机器人的ID标识。 App Secret：飞书机器人的密钥。

   2. 机器人配置完成后，可以在机器人列表中查看已配置的机器人。
      您也可以继续添加机器人，当前所有通道下的机器人总数最多支持10个。

      

      • 企业微信、QQ机器人通道下暂时仅支持配置一个机器人。
      • 单击删除通道或删除机器人，已配置的机器人将不可用，请谨慎操作。

   技能配置（可选）

   1. 单击“技能配置（可选）”，技能列表中显示当前已安装的技能，技能详细信息请前往ClawHub社区Skills查询。

      

   2. 单击“添加技能”，在弹窗中按名称搜索需要安装的Skills。当前仅支持安装官方技能，更多详情请参见ClawHub社区。

      

   3. 安装成功后，您可以在技能列表中，查看已安装的技能。

      

（可选）步骤四：配置安全组

创建Flexus L实例时，系统会自动为您创建默认安全组（sg-default-smb）并关联至该实例。默认安全组仅确保安全组内实例互通，默认拒绝所有外部请求进入实例。本示例使用默认安全组及默认安全组规则，您可以按照本步骤进行查看。

1. 在Flexus应用服务器L实例控制台，单击资源卡片或名称，进入资源页面。
2. 在左侧列表中选择“云主机 VM”，单击云主机名称，进入云主机详情页面。

   

3. 选择“安全组”页签，入方向规则确保使用以下默认安全组规则。

   您也可以根据实际需要添加更多规则，详情请参见配置Flexus L实例安全组规则。

   

   安全组入方向规则的源地址设置为0.0.0.0/0或::/0，表示允许或拒绝所有外部IP地址访问您的实例，如果将“22、3389、8848”等高危端口暴露到公网，可能导致网络入侵，造成业务中断、数据泄露或数据勒索等严重后果。建议您将安全组规则设置为仅允许已知的IP地址访问。

   

   表4 安全组入方向规则

   优先级	策略	类型	协议端口	源地址	描述
   1	允许	IPv4	TCP：全部	sg-default-smb	针对全部IPv4协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。
   1	允许	IPv6	TCP：全部	sg-default-smb	针对全部IPv6协议，允许本安全组内实例的请求进入，即该条规则确保安全组内的实例网络互通。

步骤五：发布通讯软件应用并验证

1. 登录飞书开放平台，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择“使用长连接接收事件”。
   单击“添加事件”，搜索接收消息，选中后单击“确认添加”。

   图7 配置回调
   

   

   如果报错提示“应用未建立长连接”，请检查前面步骤中的机器人App ID和App Secret是否配置正确。如需修改请参见配置OpenClaw应用。

2. 再次发布版本。单击页面左上方的“创建版本”，填写版本号（如1.0.1）、更新说明，单击“保存”后确认发布。
   图8 再次发布
   
3. 测试对话。
   在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口，也可以在搜索框中搜索已创建的机器人名称，选中后进入聊天窗口，可以与机器人直接对话测试效果。

   图9 测试对话
   

（可选）步骤六：重置密码并登录Flexus L实例

Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。

1. 在资源卡片上，单击图标，单击“重置密码”，或者在列表视图中单击操作列下的“重置密码”，设置Flexus L实例的密码。
   图10 重置密码
   
2. 单击资源卡片上的“远程登录”按钮，或者单击列表视图操作列下的“远程登录”，在弹出的登录窗口中，单击“VNC登录”，根据界面提示，输入用户名密码登录Flexus L实例。更多登录方式请参见登录方式概述。

   用户名为root，密码为上一步设置的密码。

   

常见问题

更多常见问题请参见OpenClaw常见问题汇总。

相关文档

• 如果您需要配置或修改对接的AI模型或应用，请参考配置OpenClaw应用操作。
• OpenClaw应用镜像的运行配置建议选择2核4GiB及以上。如需升级规格请参见变更Flexus L实例规格。