2.5 连接第一个渠道：飞书（图文版）

概述

一、为什么要接入飞书

接入飞书后，你就可以在飞书里直接和 AI 对话，就像在微信里和朋友聊天一样自然。

接入了飞书 = 把 AI 变成你的飞书好友

二、整体流程

第一步：在飞书开放平台创建应用
    ↓
第二步：获取 App ID 和 App Secret
    ↓
第三步：添加机器人能力
    ↓
第四步：配置权限
    ↓
第五步：配置事件订阅（让 AI 能收到消息）
    ↓
第六步：在 OpenClaw 中配置飞书渠道
    ↓
第七步：验证连接成功

三、Step 1：在飞书开放平台创建应用

3.1 访问飞书开放平台

打开浏览器，访问：

https://open.feishu.cn/app

登录你的飞书账号（建议用公司管理员账号）。

3.2 创建应用

1. 点击右上角"创建企业自建应用" 2. 填写应用信息： - 应用名称：AI助手（或你喜欢的名字） - 应用描述：智能运营助手 - 应用图标：可以上传一个图标，也可以跳过 3. 点击"创建"

四、Step 2：获取 App ID 和 App Secret

4.1 进入应用详情

创建成功后，自动跳转到应用详情页。

4.2 获取凭证

在左侧菜单找到"凭证与基础信息"，点击。

你会看到：

App ID：cli_xxxxxxxxxx
App Secret：点击查看

复制这两个值，备用。

⚠️ 注意：App Secret 点击"查看"后才会显示，记得复制保存。

五、Step 3：添加机器人能力

5.1 找到添加入口

在左侧菜单找到"添加应用能力"，点击。

5.2 添加机器人

找到"机器人"卡片，点击"添加"。

机器人能力添加成功后会显示"已添加"。

六、Step 4：配置权限

6.1 进入权限管理

在左侧菜单找到"权限管理"，点击。

6.2 开通必要权限

飞书机器人需要以下权限才能正常工作：

6.3 开通方式

每个权限旁边有"开通"按钮，点击即可。

七、Step 5：配置事件订阅（关键！）

7.1 为什么需要这个

事件订阅 = 让飞书把消息转发给 OpenClaw

没有配置这个，OpenClaw 收不到飞书的消息，AI 就不会响应。

7.2 配置入口

在左侧菜单找到"事件订阅"，点击。

7.3 选择接收事件的方式

选择 "使用长连接接收事件"（推荐，最简单）

● 使用长连接接收事件（推荐）
○ 将事件发送到开发者服务器

7.4 添加事件

点击"添加事件"，搜索并添加以下事件：

7.5 配置权限范围

回到权限管理，设置"权限范围"：

• 选择"全部员工"或指定部门/人员
• 建议先测试时选择"部分员工"

八、Step 6：在 OpenClaw 中配置飞书渠道

8.1 运行配置命令

在终端（Ubuntu 或 macOS）运行：

openclaw configure

8.2 选择配置飞书

请选择要配置的项目：
1. AI 模型
2. 飞书渠道
3. 钉钉渠道
4. 企业微信渠道
5. 完成配置
请输入 [1-5]：

输入 2。

8.3 输入 App ID 和 App Secret

飞书配置：
App ID：cli_xxxxxxxxxx
App Secret：________________

粘贴之前复制的 App ID 和 App Secret。

8.4 设置白名单

飞书私聊权限：
1. 白名单模式（推荐，只有指定用户能发消息）
2. 开放模式（任何人都能发消息）
请选择 [1-2]：

建议选 1（白名单模式），更安全。

选白名单后，会要求输入允许发消息的用户 ID：

允许的飞书用户 Open ID（多个用逗号分隔）：

输入你的飞书 Open ID（以 ou_ 开头）。

8.5 保存配置

配置完成后，会提示：

✅ 飞书渠道配置成功！

九、Step 7：验证连接成功

9.1 发布应用（重要！）

回到飞书开放平台，点击右侧"版本管理与发布"。

1. 点击"创建版本" 2. 填写版本信息（随便填） 3. 点击"保存" 4. 点击"申请发布"（如果是企业内部应用，管理员直接审批即可）

9.2 在飞书里找到机器人

1. 打开飞书 App 2. 在搜索框搜索机器人名称 3. 点击进入和机器人的对话

9.3 发送测试消息

你好，测试一下

9.4 验证成功的标志

• ✅ 机器人回复了你的消息
• ✅ 回复是实时的（几秒内）
• ✅ 回复内容符合你的问题

十、常见问题