文档首页/ 魔坊（ModelArts）模型训推平台/ 最佳实践/ Notebook OpenClaw最佳实践/ 使用OpenClaw快速集成飞书AI助手
更新时间：2026-06-01 GMT+08:00
查看PDF
分享

使用OpenClaw快速集成飞书AI助手

在传统AI助手仅能提供文本建议的局限性下，OpenClaw作为开源本地优先的智能体执行框架，创新性地实现了大语言模型与本地系统的深度整合。该框架通过自然语言指令驱动文件系统操作、Shell命令执行、浏览器控制及API调用等多模态交互能力，使AI从"只会说"升级为"能动手做"。华为云已开放OpenClaw体验计划，本文重点指导开发者在ModelArts Notebook环境中，利用该框架在ModelArts平台快速集成飞书AI助手的完整实践流程。

Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install、apt-get install、yum install、pip install和OpenClaw安装后的配置对话等，以避免Notebook运行环境中的数据或对话session丢失。关于如何保存镜像，请参见保存镜像。

约束限制

Notebook OpenClaw功能仅支持“华北-北京四”区域。

前提条件

已完成在Notebook中安装配置OpenClaw。

计费说明

在ModelArts开发环境中运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见开发环境计费项。

操作步骤

  1. 创建飞书机器人应用并获取配置。

    1. 创建企业自建应用。
      1. 登录飞书开发者平台，单击创建企业自建应用按钮。
      2. 需配置应用名（如“OpenClaw办公助手”）、描述及图标。
      3. 单击创建按钮，完成操作。
    2. 添加机器人能力。
      1. 在左侧目录树选择“应用能力 > 添加应用能力”。
      2. 在按能力添加页签，单击机器人卡片的添加按钮。
        图1 机器人
    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 配置权限
      3. 在弹窗中确认权限无误后，单击申请开通按钮，完成操作。相关权限的具体含义可查看飞书API权限列表。
    4. 获取配置信息。
      1. 在左侧目录树，选择“基础信息 > 凭证与基础信息”。
      2. 在应用凭证模块中，获取并记录App ID与App Secret信息。获取的App ID与App Secret将用于配置OpenClaw，请妥善保存，将在下面配置OpenClaw中使用。
        图3 凭证与基础信息
    5. 发布应用。
      1. 单击顶部的创建版本按钮。
      2. 按需配置应用版本号、默认能力、更新说明、申请理由等信息。
      3. 单击页面底部的保存按钮，创建版本。
      4. 单击页面右上角的确认发布或申请线上发布按钮，完成应用发布。

  2. 初始化Notebook OpenClaw。

    1. 登录ModelArts管理控制台，在左侧导航栏选择“开发空间 > Notebook”，进入“Notebook”页面。
    2. 在“状态”为“运行中”的Notebook实例的操作列，单击“接入环境”，在“接入方式”对话框，单击“JupyterLab 接入”右侧的“接入”。
    3. 在“AI Agent”区域，单击“OpenClaw”，打开OpenClaw。
    4. 在OpenClaw左侧导航栏，选择进入安装配置 OpenClaw > 即时通讯配置 > 配置飞书，请耐心等待飞书插件下载完成。
    5. 将上文获取飞书的App ID与App Secret依次填入，确认后选择重启Gateway。
      图4 飞书配置

  3. 发布飞书应用并验证。

    1. 登录飞书开放平台，配置事件回调。选择左侧菜单的事件与回调，在事件配置页签配置订阅方式，选择“使用长连接接收事件”。

      可以单击“验证”测试连接是否成功，验证成功后，单击“保存”。

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

常见问题

  • 报错提示“应用未建立长连接”。

    处理方案：请检查前面步骤中的机器人App ID和App Secret是否配置正确。如需修改请参考初始化Notebook OpenClaw。

  • 发送消息，提示“OpenClaw: access not configured.”

    处理方案：请将提示代码“openclaw pairing”在OpenClaw中执行即可，如下图所示：

    图8 执行示例

相关文档