OpenClaw接入飞书教程

一. 背景

OpenClaw 接入 飞书 后,可在团队沟通中直接调用AI能力,实现代码生成、问题解答与文档处理自动化;结合消息流触发任务,提升协作效率,减少上下文切换,适用于研发支持、自动答疑与流程智能化。

二. 龙虾接入飞书

1. 前置准备

  • 完成OpenClaw的安装
  • 拥有飞书个人账号

2. 创建飞书应用

2.1 登录飞书开放平台

访问 飞书开放平台,使用飞书账号登录。

2.2 创建企业自建应用

点击"创建企业自建应用",填写名称(如"测试教程")和描述,点击"创建"。

2.3 获取应用凭证

进入"凭证与基础信息",复制 App ID(格式 cli_xxx)和 App Secret,妥善保存。

2.4 启用机器人能力

进入"添加应用能力" → "机器人",点击"添加"。

2.5 配置权限

进入"权限管理",点击"批量导入",粘贴下方 JSON:

python 复制代码
{
  "scopes": {
    "tenant": [
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "docx:document:readonly",
      "event:ip_list",
      "im:chat",
      "im:chat.members:bot_access",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "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",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "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",
      "board:whiteboard:node:create",
      "board:whiteboard:node: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",
      "calendar:calendar:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id: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",
      "offline_access",
      "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"
    ]
  }
}
2.6 发布应用

进入"版本管理与发布",点击"创建版本",填写版本号后提交发布申请。管理员审批通过即生效(你本人是管理员可直接通过)。

3. 在OpenClaw中添加飞书渠道

回到终端,运行:

bash 复制代码
openclaw channels add

选择"Feishu",输入 App ID 和 App Secret,其余保持默认。添加后重启网关:

bash 复制代码
openclaw gateway restart
openclaw gateway status

确认输出中 feishu 渠道状态为 connected。

4. 配置事件订阅

回到飞书开放平台,进入"事件与回调" → "事件配置":

  • 选择"使用长连接接收事件"
  • 添加事件:im.message.receive_v1

5. 配对与首次对话

为什么要配对?

防止陌生人滥用你的机器人------每次对话都消耗你的 API 额度。新用户第一次发消息时会收到配对码,只有你批准后才能正常对话。配对码 1 小时过期。

在飞书中找到你的机器人,发送"你好"。机器人会回复一个 8 位配对码:

在终端批准:

bash 复制代码
openclaw pairing approve feishu <配对码>

配对成功后,飞书里的龙虾就能回你了。

祝贺你,你的龙虾已经成功接入飞书了。

参考:

https://datawhalechina.github.io/hello-claw/cn/adopt/chapter2/

https://datawhalechina.github.io/hello-claw/cn/adopt/chapter3/

相关推荐
前进的李工5 天前
Agent 学习笔记 15:Agent 怎样响应事件与中途打断?
人工智能·笔记·agent·openclaw·工具设计·gpt-6 astra·原生异步
w3296362717 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
宝哥聊编程18 天前
主流 Agent 平台对比:Coze、Dify、飞书、扣子、OpenClaw 落地实操手册
前端·人工智能·飞书
guoran_shini20 天前
Agent系统服务化封装和IM接入
飞书
xzlAwin22 天前
Win10 安装OpenClaw 龙虾
ai·openclaw·龙虾
mudtools23 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
人工智能·ai·.net·飞书·agent
极致了23 天前
飞书插件、RPA、API三条路的真实分界线
飞书·rpa
玩泥巴的24 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
ai·.net·飞书·agent
玩泥巴的25 天前
一份声明,多份产物:飞书 SDK 的 AI 工具面是怎么生成的
ai·.net·飞书·agent