# 使用OpenClaw快速集成飞书AI助手
在传统AI助手仅能提供文本建议的局限性下，OpenClaw作为开源本地优先的智能体执行框架，创新性地实现了大语言模型与本地系统的深度整合。该框架通过自然语言指令驱动文件系统操作、Shell命令执行、浏览器控制及API调用等多模态交互能力，使AI从"只会说"升级为"能动手做"。华为云已开放OpenClaw体验计划，本文重点指导开发者在ModelArts Notebook环境中，利用该框架在ModelArts平台快速集成飞书AI助手的完整实践流程。
![](https://support.huaweicloud.com/bestpractice-modelarts/public_sys-resources/warning_3.0-zh-cn.png)
Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install、apt-get install、yum install、pip install和OpenClaw安装后的配置对话等，以避免Notebook运行环境中的数据或对话session丢失。关于如何保存镜像，请参见[保存镜像](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_0008.html)。
#### 约束限制
Notebook OpenClaw功能仅支持"华北-北京四"、"西南-贵阳一"、"华北-乌兰察布一"、"华东-上海一"和"华南-广州"区域。
#### 前提条件
已完成[在Notebook中安装配置OpenClaw](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0038.html)。
#### 计费说明
- 在ModelArts开发环境中运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见[开发环境计费项](https://support.huaweicloud.com/price-modelarts/price-modelarts-0010.html)。
- OpenClaw本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。
 
#### 操作步骤
1. 创建飞书机器人应用并获取配置。 
   1. 创建企业自建应用。
      1. 登录[飞书开发者平台](https://open.larkoffice.com/app?lang=zh-CN)，单击**创建企业自建应用**按钮。
      
      2. 需配置应用名（如"OpenClaw办公助手"）、描述及图标。
      
      3. 单击**创建**按钮，完成操作。
       
   
   2. 添加机器人能力。
      1. 在左侧目录树选择"应用能力 \> 添加应用能力"。
      
      2. 在**按能力添加** 页签，单击**机器人** 卡片的**添加** 按钮。
         图1**机器人**   
         ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002561097926.png "点击放大") 
       
   
   3. 配置权限。
      1. 在左侧目录树选择"开发配置 \> 权限管理"，单击"**批量导入/导出权限**"按钮。
      
      2. 在**导入** 页签中，将如下权限替换原有示例，单击**下一步，确认新增权限** 按钮。
         ```
         {
             "scopes": {
                 "tenant": [
                     "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",
                     "contact:contact.base:readonly"
                 ],
                 "user": [
                     "contact:user.employee_id:readonly"
                 ]
             }
         }
         ```
         图2配置权限   
         ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002591818369.png "点击放大") 
      
      3. 在弹窗中确认权限无误后，单击**申请开通** 按钮，完成操作。相关权限的具体含义可查看[飞书API权限列表](https://open.larkoffice.com/document/server-docs/application-scope/scope-list)。
       
   
   4. 获取配置信息。
      1. 在左侧目录树，选择"基础信息 \> 凭证与基础信息"。
      
      2. 在**应用凭证** 模块中，获取并记录App ID与App Secret信息。获取的App ID与App Secret将用于配置OpenClaw，请妥善保存，将在下面配置OpenClaw中使用。
         图3凭证与基础信息   
         ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002561258608.png "点击放大") 
       
   
   5. 发布应用。
      1. 单击顶部的**创建版本**按钮。
      
      2. 按需配置应用版本号、默认能力、更新说明、申请理由等信息。
      
      3. 单击页面底部的**保存**按钮，创建版本。
      
      4. 单击页面右上角的**确认发布** 或**申请线上发布**按钮，完成应用发布。
       
   
   
   
   
2. 初始化Notebook OpenClaw。
   
   1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts/)，在左侧导航栏按需选择以下操作。
      - 新版控制台：选择"模型开发与训练 \> Notebook"，进入"Notebook"页面。
      
      - 旧版控制台：选择"开发空间 \> Notebook"，进入"Notebook"页面。
       
   
   2. 在"状态"为"运行中"的Notebook实例的操作列，单击"接入环境"，在"接入方式"对话框的"WebIDE"页签，单击"JupyterLab 接入"右侧的"接入"。
   
   3. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"OpenClaw"，打开OpenClaw。
   
   4. 在OpenClaw左侧导航栏，选择进入安装配置 OpenClaw \> 即时通讯配置 \> 配置飞书，请耐心等待并等待飞书插件下载完成。
   
   5. 将[上文]获取飞书的**App ID与App Secret** 依次填入，确认后选择重启Gateway。
      图4飞书配置   
      ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002561258766.png "点击放大") 
   
   
   
   
3. 发布飞书应用并验证。 
   1. 登录[飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择"使用长连接接收事件"。
      可以单击"验证"测试连接是否成功，验证成功后，单击"保存"。
      图5长连接   
      ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002591738653.png "点击放大") 
   
   2. 单击"添加事件"，搜索接收消息，选中后单击"添加"。
      图6添加事件   
      ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002561099358.png "点击放大") 
   
   3. 再次发布版本。单击页面左上方的"创建版本"，填写版本号（如1.0.1）、更新说明，单击"保存"后确认发布。
      图7版本号   
      ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002561099526.png "点击放大") 
   
   4. 测试对话。在飞书APP中的开发者小助手对话框中可以看到版本发布成功的提示，单击打开应用即可进入机器人的聊天窗口也可以在搜索框中搜索已创建的机器人名称，选中后进入聊天窗口，可以与机器人直接对话测试效果。
   
   
   
   
 
#### 常见问题
- 报错提示"应用未建立长连接"。 处理方案：请检查前面步骤中的机器人App ID和App Secret是否配置正确。如需修改请参考[初始化Notebook OpenClaw。]
  
- 发送消息，提示"OpenClaw: access not configured." 处理方案：请将提示代码"openclaw pairing"在openclaw中执行即可，如下图所示：
  图8执行示例   
  ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002591733379.png "点击放大") 
 
#### 相关文档
- [使用OpenClaw开发贪吃蛇](https://support.huaweicloud.com/bestpractice-modelarts/develop-modelarts-0119.html)
- [使用AI助手在线管理Notebook](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0040.html)
- [使用AI助手自动保存Notebook镜像](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0042.html)
- [使用AI助手在线部署推理服务](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0043.html)
- [使用AI助手在线创建训练作业](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0044.html)
- [使用AI助手在线管理专属资源池](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_10_0045.html)
- [使用AI助手处理ModelArts典型开发与运维场景](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_20_00026.html)