📱 飞书接入保姆级教程

访问飞书开发者平台

打开浏览器，访问 https://open.feishu.cn/app，登录你的飞书账号。

创建应用

点击「创建企业自建应用」，填写应用基础信息：

• 应用名称：如「OpenClaw 助手」
• 选择一个应用图标
• 点击「创建」按钮，进入应用管理页面

添加机器人能力

在应用管理页左侧导航栏，找到并点击「添加应用能力」，在弹出的列表中选择「机器人」，点击「添加」。

获取应用凭证

在左侧导航栏找到「凭证与基础信息」栏目，点击进入。在页面中找到 App ID 和 App Secret 两个参数，分别点击右侧「复制」按钮，保存到记事本或备忘录中。

事件配置

在飞书应用管理页，左侧导航栏找到「事件与回调」栏目，点击进入。

在「事件配置」中，订阅方式选择「使用长连接接收事件」，点击「保存」。

添加事件订阅

点击页面中的「添加事件」，在弹出的事件列表中：

• 选择「消息与群组」分类
• 勾选「接收消息」(im.message.receive_v1)
• 点击「确定」，完成事件订阅

权限配置（批量导入）

在左侧导航栏找到「权限管理」栏目，点击进入。点击页面中的「批量导入权限」按钮。

复制以下 JSON 代码，粘贴到导入窗口的输入框中，点击「导入」按钮：

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:department.base:readonly",
      "contact:department.organize:readonly",
      "contact:user.base:readonly",
      "contact:user.department:readonly",
      "contact:user.email:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.id:readonly",
      "contact:user.phone:readonly",
      "im:chat",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": []
  }
}

页面显示「导入成功」，且权限列表中出现上述导入的权限，即为配置完成。

发布应用

在左侧导航栏找到「版本管理与发布」栏目，点击进入。点击右上角的「新建版本」。

填写版本号与描述后，点击「保存」并「发布」。

打开管理页面

打开 OpenClaw 管理页面（默认地址：http://127.0.0.1:18789）

配置飞书渠道

在管理页面：

1. 点击左侧菜单「Channels」
2. 找到「Feishu」渠道，点击配置
3. 填入之前保存的 App ID 和 App Secret
4. 点击「Save」保存

等待连接

保存后，系统会自动连接飞书服务器。稍等几秒，查看状态是否显示「Connected」。

测试对话

1. 打开手机或电脑端飞书APP，登录与飞书开发者平台相同的账号
2. 在飞书首页，找到「工作台」入口，点击进入
3. 在工作台列表中找到已发布的应用（如「OpenClaw 助手」），点击进入
4. 系统将自动启动私聊窗口，发送任意消息（如「你好」）

如果收到 AI 的回复，恭喜！飞书接入成功！ 🎉