飞书接入

更新时间:
复制为 MD 格式

通过飞书应用与机器人接入 JVS Claw,用户可在微信中与机器人对话,驱动 JVS Claw 执行任务。

方案概述

通过飞书应用与机器人,实现用户通过飞书与机器人对话,驱动JVS Claw完成相关任务。支持以下两种配置方式:

  • 快速授权:扫描二维码授权后绑定机器人。

  • 手动配置:手动创建并配置机器人,并填写应用信息实现安全对接。

操作步骤

  1. 前往JVS Claw 控制台,或登录JVS Claw客户端。

  2. 在左侧导航栏选择Clawbots

  3. 点击目标ClawbotMail图标。

  4. IM通道列表页面点击飞书卡片立即绑定

  5. 在配置飞书页面选择配置方式,支持以下配置方式:

    快速授权

    1. 使用飞书扫描二维码。

    2. 在弹出的确认信息页面授权应用登录。

    3. 应用登录后将自动创建机器人并完成配置。

    4. 等待页面提示配置成功后确认状态为已绑定

    手动配置

    参考配置飞书应用及机器人,并填入复制的AppID以及AppSecret

配置飞书应用及机器人

创建飞书应用

  1. 访问 飞书开放平台,点击右上角开发者后台

  2. 点击创建企业自建应用,填写必要信息。

  3. 在应用的凭证与基础信息页面,复制App ID(格式如cli_xxx)和App Secret。

配置应用权限

  1. 点击权限管理>开通权限,单击批量导入/导出权限按钮。

  2. 粘贴以下JSON 配置一键导入所需权限,单击下一步,确认新增权限按钮。

    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "docs:document.content:read",
          "event:ip_list",
          "im:chat",
          "im:chat.access_event.bot_p2p_chat:read",
          "im:chat.members:bot_access",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.group_msg",
          "im:message.p2p_msg:readonly",
          "im:message:readonly",
          "im:message:send_as_bot",
          "im:resource",
          "sheets:spreadsheet",
          "wiki:wiki:readonly"
        ],
        "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
      }
    }
  3. 在弹窗中确认权限无误后,单击申请开通按钮,完成操作。

配置事件并发布

  1. 应用能力 > 机器人页面开启机器人能力,并配置机器人名称。

  2. 事件与回调页面,点击事件配置>订阅方式,选择使用 长连接 接收事件并保存。

    重要

    在配置事件订阅前,请务必确保完成了第一步中飞书通道的配置。

  3. 点击添加事件,添加接收消息(im.message.receive_v1)。

  4. 前往版本管理与发布>创建版本,填写必要信息后点击保存