飞书
部署步骤
1. 登录 飞书开放平台
使用飞书账号登录。Lark（国际版）请使用 https://open.larksuite.com/app ，并在配置中设置 domain: "lark"。
2. 登录后，点击「创建企业自建应用」
基础信息按提示填写即可（名称、描述等），点击「创建」按钮，进入应用详情页。
3. 启用机器人能力
在 「添加应用能力」> 「机器人」 页面：
- 开启机器人能力
- 配置机器人相关设置
4. 配置应用权限
在「权限管理」>「批量导入」页面，粘贴以下 JSON 配置一键导入所需权限。
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}基础权限
| 权限范围 | 权限类型 | 功能描述 |
|---|---|---|
contact:user.base:readonly | User info | 获取基础用户信息 |
im:message | Messaging | 收发消息 |
im:message.p2p_msg:readonly | DM | 读取机器人的私信消息 |
im:message.group_at_msg:readonly | Group | 接收群内@机器人的消息 |
im:message:send_as_bot | Send | 以机器人身份发送消息 |
im:resource | Media | 上传/下载图片/文件 |
可选全功能权限
| 权限范围 | 权限类型 | 功能描述 |
|---|---|---|
im:message.group_msg | Group | 读取群内所有消息（敏感） |
im:message:readonly | Read | 获取消息历史记录 |
im:message:update | Edit | 编辑/更新已发送的消息 |
im:message:recall | Recall | 撤回已发送的消息 |
im:message.reactions:read | Reactions | 查看消息的互动反馈 |
确保消息、机器人、事件订阅等相关权限均已开启
5. 填写 App ID 和 App Secret 并应用配置
在飞书开放平台「凭证与基础信息」页面复制 App ID 与 App Secret，回到 302 AI Studio 客户端的设置页面 对应项中填写，然后点击 「更新配置」 按钮以应用新配置。
6. 设置事件回调（Callback）
在配置事件订阅前，请务必确保已完成以下步骤：
- 已打开 302 AI Studio 客户端
- 已在客户端中启用 Open Claw 功能
在「事件与回调」页面：
- 选择「使用长连接接收事件」（WebSocket 模式）
- 添加事件：
im.message.receive_v1（接收消息）
如果客户端未启动或 Open Claw 未启用，长连接设置将保存失败。
7. 发布应用
- 在「版本管理与发布」页面创建版本
- 提交审核并发布
- 等待管理员审批（企业自建应用通常自动通过）
8. 发送测试消息
在飞书中找到您创建的机器人，发送一条消息进行测试。
9. 配对授权
默认情况下，机器人会回复一个配对码和配对命令。
如果机器人要求运行配对命令（如 openclaw pairing approve feishu <配对码>），请复制该命令，然后回到 302 AI Studio 客户端，将命令发送给 Open Claw，让它执行配对操作。
配对成功后即可正常对话！
可选：绑定飞书会话与工作区
本节 不是 接入飞书的必要步骤。不填写飞书会话 ID、不绑定工作区，只要完成上文的应用、凭证、事件回调、发布与配对，同样可以 正常使用飞书机器人。
绑定与不绑定的区别
| 不绑定会话 ID | 绑定会话 ID（工作区） | |
|---|---|---|
| 能否使用飞书机器人 | 可以 | 可以 |
| 与工作区的关系 | 飞书侧对话按 Open Claw 默认策略处理，不会与您在客户端里选定的 工作区建立固定对应；桌面端与飞书侧上下文相互独立 | 将 指定飞书会话 与客户端中的 工作区绑定，飞书里的消息会落在该工作区内，与客户端在该工作区下的状态、任务与文件等保持一致，跨场景接续同一条工作线 |
| 典型适用场景 | 主要把飞书当作独立入口使用机器人，不需要与客户端当前工作区同步 | 在电脑前用客户端 深度处理某个工作区；不在电脑旁（外出、会议、移动端等）时用飞书在同一工作区继续跟进，避免上下文割裂 |
如何绑定（可选）
飞书群聊相关功能（例如在群内与机器人对话、绑定群会话与工作区等）需要先将 302 AI Studio 客户端升级到最新版本，否则可能无法正常使用或缺少对应入口。
在飞书中 新建一个群聊（或使用已有群），打开该群的 群设置，复制 会话 ID。在客户端 聊天界面 打开 vibe 设置 弹窗，将会话 ID 填入飞书相关项并保存，即可完成 飞书渠道与工作区 的绑定。
弹窗内 飞书会话 ID 的 保存 按钮，需在与 Open Claw 完成至少一次对话 之后才可点击；点击保存后会 重启网关，当前正在执行的任务会被中断，请确保对话结束或保存前已将所有任务提交。
更多信息
如需了解更详细的配置选项、高级功能和完整的配置参考，请查阅 OpenClaw 官方文档