图文并茂2分钟教会你用飞书聊天就可以控制大龙虾OpenClaw

0 阅读5分钟

图文并茂2分钟教会你用飞书聊天就可以控制大龙虾OpenClaw | Connect Clawdbot to Feishu Tutorial

@[TOC]( 图文并茂2分钟教会你用飞书聊天就可以控制大龙虾OpenClaw | Connect Clawdbot to Feishu Tutorial)

宝宝们又来看我啦~👋 今天要教大家一个超实用的技能——让大龙虾AI助手连接飞书!🚀


📚 官方文档 | Official Documentation


🌟 第一步:安装飞书插件 | Install Feishu Plugin

宝宝们,首先我们要给大龙虾安装飞书插件,让它学会和飞书对话~ 🎯

在OpenClaw界面中输入:

帮我安装Clawdbot plugins install @m1heng-clawd/feishu 这个插件

image image

🎉 插件安装成功!

image

哇哦~ 看到成功提示了吗?!✨

🌟 第二步:开始配置飞书 | Configure Feishu

image

🥰!下面是超简单的配置步骤,跟着我一步步来就好啦:

🚀 第一步:创建飞书自建应用 | Create Feishu Custom App

宝宝们,我们要在飞书开放平台创建一个专属应用,让大龙虾能够接入飞书~ 🎯

操作步骤

1️⃣ 进入飞书开放平台

2️⃣ 创建企业自建应用

  • 路径:创建应用 → 企业自建应用
  • 填写基础信息(名称、描述等),很简单哒~
  • 完成后进入应用详情页 image

🔑 第二步:获取 App ID 和 App Secret | Get App Credentials

这一步超级重要!我们要获取连接飞书的关键信息~ 🗝️

操作指南

  1. 进入应用后台 → 点击「凭证与基础信息」
  2. 复制关键信息:「App ID」和「App Secret」

⚠️ 重要提醒:这两个值一定要保存好哦!等会儿配置大龙虾的时候会用到~

image

🌟 第三步:启用机器人能力 | Enable Bot Capabilities

现在我们要给我们的应用添加机器人能力,让它能够收发消息~ 🤖

在【添加应用能力】>【机器人】页面

  1. 开启机器人能力 - 把这个开关打开!
  2. 配置机器人相关设置 - 按提示填写即可

image

🔧 第四步:配置应用权限 | Configure App Permissions

权限配置很关键哦!我们要让机器人有足够的权限来工作~

在【权限管理】页面

  1. 点击【批量导入】按钮
  2. 粘贴以下JSON配置 - 一键导入所有所需权限!

image

💡 小贴士:这个JSON包含了所有必要的权限,直接复制粘贴就行,不用一个个手动选择啦~

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "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",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

🎯 第五步:配置 OpenClaw | Configure OpenClaw

现在让我们把刚才获取的App ID和App Secret告诉大龙虾吧~ 🎪

在OpenClaw界面输入

帮我配置吧,这是我的飞书App ID:xxxx  以及App Secret:xxxx

💡 小贴士:把xxxx替换成你刚才复制的真实值哦!

image

🌟 第六步:设置事件回调 | Configure Event Callback

这一步很关键哦!我们要让飞书能够把消息传递给大龙虾~ 📡

⚠️ 重要提醒:在配置事件订阅前,请确保完成以下准备:

  • ✅ 已运行 openclaw channels add 添加Feishu渠道
  • ✅ 网关处于启动状态(用 openclaw gateway status 检查)

在【事件订阅】页面配置

1️⃣ 选择连接模式:使用长连接接收事件(WebSocket模式) 2️⃣ 添加订阅事件:im.message.receive_v1(接收消息)

⚠️ 注意:如果网关未启动或渠道未添加,长连接设置会保存失败哦~

image image

🎯 第七步:发布应用 | Publish Application

最后一步啦!我们要把应用发布出去,让大家都能使用~ 🚀

在【版本管理与发布】页面

1️⃣ 创建新版本 - 填写版本信息 2️⃣ 提交审核并发布 - 点击发布按钮 3️⃣ 等待审批 - 企业自建应用通常自动通过

image image


🔄 需要重启网关

如果配置过程中需要重启,输入:

openclaw gateway restart

image

小贴士:重启一下让配置生效,这个步骤很重要哦~

🎉 完成!测试一下吧 | Testing Time!

宝宝们,激动人心的时刻到啦!让我们测试一下成果~ ✨

测试步骤

1️⃣ 在飞书搜索你的机器人名称 → 发个消息试试 2️⃣ 如果一切正常,机器人会回复你哦🥳 3️⃣ 首次对话需要配对 → 让它自己配置就行,你发到框里就可以了

image image

💡 小贴士:第一次对话可能会稍微慢一点,别着急,耐心等待一下~


💖 Conclusion | 结语

  • That's all for today~ | 今天就写到这里啦~

  • Guys, ( ̄ω ̄( ̄ω ̄〃 ( ̄ω ̄〃)ゝ See you tomorrow~~ | 小伙伴们,( ̄ω ̄( ̄ω ̄〃 ( ̄ω ̄〃)ゝ我们明天再见啦~~

  • Everyone, be happy every day! 大家要天天开心哦

  • Welcome everyone to point out any mistakes in the article~ | 欢迎大家指出文章需要改正之处~

  • Learning has no end; win-win cooperation | 学无止境,合作共赢

  • Welcome all the passers-by, boys and girls, to offer better suggestions! ~~~ | 欢迎路过的小哥哥小姐姐们提出更好的意见哇~~

image