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/