将OpenClaw连接到飞书,主要分为三步:在飞书开放平台创建和配置应用在OpenClaw中安装飞书插件并填入凭证,最后进行配对。整个过程不需要写代码,跟着步骤操作即可。

下面是完整的操作流程,你可以参考:

📝 第一步:在飞书开放平台创建应用

这是连接的基础,我们需要在飞书端创建一个“机器人”来接收和发送消息。

  1. 创建应用:登录飞书开放平台,点击「创建企业自建应用」,填写应用名称等信息后完成创建。
  2. 获取凭证:进入应用详情页,在「凭证与基础信息」页面,找到并复制 App IDApp Secret。这两个信息非常重要,请妥善保管,下一步会用到。
  3. 添加机器人能力:在「应用能力」中,为你的应用添加「机器人」能力,这是实现对话交互的核心。
  4. 配置事件订阅(关键):这一步是让飞书知道,当用户给机器人发消息时,应该通知你的OpenClaw。
    • 进入「事件与回调」页面,在「事件配置」页签,将「订阅方式」改为 「使用长连接接收事件」 并保存。
    • 点击「添加事件」,搜索并添加 im.message.receive_v1(接收消息) 事件。这是机器人能收到消息的关键。
  5. 配置权限:为了让机器人能正常收发消息、识别用户,需要给它开通必要的权限。
    • 进入「权限管理」页面,可以通过「批量导入/导出权限」功能,直接粘贴以下最精简的权限配置:
      {
        "scopes": {
          "tenant": [
            "im:message",
            "im:message.group_at_msg:readonly",
            "im:message.p2p_msg:readonly",
            "im:message:send_as_bot",
            "contact:user.employee_id:readonly"
          ]
        }
      }
      
    • 点击「确认开通」后,这些权限就会生效。
  6. 发布应用:所有配置完成后,别忘了在「版本管理与发布」页面创建一个版本并发布。发布后,配置才会最终生效,企业内的成员才能使用这个机器人。

⚙️ 第二步:在OpenClaw中安装和配置飞书插件

现在,我们回到OpenClaw这边,让它知道如何连接到刚才创建好的飞书应用。

  1. 安装飞书插件:打开你的终端,执行以下命令来安装官方的飞书插件:

    openclaw plugins install @m1heng-clawd/feishu
    
  2. 填写飞书凭证:插件安装后,需要将第一步获取的 App IDApp Secret 配置进去。可以通过命令行快速完成:

    # 请将命令中的 "你的飞书 app id" 和 "你的飞书 app secret" 替换为实际的值
    openclaw config set channels.feishu.appId "你的飞书 app id"
    openclaw config set channels.feishu.appSecret "你的飞书 app secret"
    openclaw config set channels.feishu.enabled true
    
  3. 重启网关服务:配置完成后,必须重启OpenClaw的网关服务,所有修改才能生效:

    openclaw gateway restart
    

🤝 第三步:完成配对,开始对话

最后一步,我们需要在OpenClaw和飞书机器人之间建立一对一的连接。

  1. 发起对话获取配对码:在飞书客户端(电脑端或手机端)找到你刚刚创建并发布的机器人,给它发送任意一条消息。它会自动回复一个 配对码(通常是一串数字)。
  2. 在OpenClaw中确认配对:复制飞书机器人回复的配对码,然后在OpenClaw的WebUI界面,或者直接在终端执行以下命令来完成配对:
    # 请将 "你的配对码" 替换为实际收到的数字
    openclaw pairing approve feishu 你的配对码
    
  3. 验证成功:当终端显示配对成功,你就可以在飞书里和你的AI助手自由对话了,也可以把它邀请到群聊中,让大家一起使用。
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐