Openclaw对接飞书

2026-05-06阅读 0热度 0

飞书 OpenClaw

飞书开放平台创建应用

一切从这里开始。首先，访问飞书开放平台的应用创建页面：

https://open.feishu.cn/app

按照页面指引，创建一个新的应用。这个过程很直观，给你的应用起个名字，比如“智能助手贾维斯”，然后进入应用管理界面。

添加机器人能力

创建好应用后，下一步是赋予它“灵魂”——为它添加机器人能力。在应用的功能菜单里找到“机器人”选项。

点击启用机器人。这里会看到一些基础设置，比如机器人头像和名称，你可以根据喜好进行自定义。

机器人权限管理

想让机器人在飞书里大展拳脚？关键是给它足够的“权限”。飞书的权限体系比较细致，手动添加会比较繁琐。这里推荐一个高效的方法：批量导入权限。

直接将下面这段完整的权限配置JSON复制到权限管理页面的批量导入框中。这些权限涵盖了消息收发、联系人/群组访问、文档处理、日历日程等核心能力，是保障机器人功能完整性的基础。

{"scopes": {"tenant": ["application:application:self_manage","cardkit:card:read","cardkit:card:write","contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","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"],"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.media:upload","docs:document:copy","docs:document:export","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","sheets:spreadsheet.meta:read","sheets:spreadsheet:create","sheets:spreadsheet:read","sheets:spreadsheet:write_only","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"]}}

Openclaw添加新代理

接下来，我们把飞书应用和Openclaw平台连接起来。如果是首次配置，系统通常已有一个默认的“main”代理，直接使用它配置飞书通道即可。只有当你想配置多个独立的AI代理（比如让不同的机器人处理不同事务）时，才需要新增代理。

假设我们要新增一个名为“jarvis”的代理，可以在终端执行以下命令：

# 创建代理
openclaw agents add jarvis --workspace ~/.openclaw/agents/jarvis/workspace

代理创建好后，需要编辑Openclaw的配置文件，将其绑定到飞书通道。使用编辑器打开配置文件：

vim ~/.openclaw/openclaw.json

在配置文件中找到 bindings 部分，参照已有的“main”代理格式，为“jarvis”添加一个类似的绑定项。

紧接着，在channels.feishu.accounts配置项下，为“jarvis”新增一套飞书账号配置。同样，可以参考“default”账号的格式。

这里的关键是填入从飞书开放平台获取的appId和appSecret，这是应用的身份凭证。

所有配置修改完毕后，保存并退出编辑器。最后一步，重启Openclaw的gateway服务，让新配置生效。

配置事件与回调

机器人要能“听见”和“回应”，离不开事件订阅。回到飞书开放平台，找到“事件订阅”设置。

连接方式：建议选择“长连接”，稳定性更佳。

添加事件：至少需要订阅以下三个与消息相关的事件，这是实现对话的基础： - im.message.receive_v1（接收消息） - im.message.reaction.created_v1（消息表情回复新增） - im.message.reaction.deleted_v1（消息表情回复删除）