openClaw接入飞书机器人
一、在飞书中创建聊天机器人
第一步,咱们得先进入飞书开放平台,地址在这里:https://open.feishu.cn。访问之后,你看到的后台界面应该类似下面这张图。
2. 创建应用
登录后,点击“创建应用”按钮,开始我们的配置之旅。这个步骤很直观,跟着引导走就行。
3. 获取应用凭证
应用创建成功后,关键的一步来了:找到并记下你的 App ID 和 App Secret。这就像是机器人的“身份证”和“钥匙”,后续配置全靠它俩。
接下来,找到“机器人”选项,并启用机器人能力。这个开关打开了,你的应用才具备对话的基础。
紧接着是权限配置环节。权限决定了机器人能做什么,所以需要仔细设置。
为了方便,这里提供一份完整的权限 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"]}}
导入配置后,页面会列出所有需要的权限。逐一确认,全部勾选上,然后点击“开通权限”。
最后一步,创建一个新版本并发布。只有发布后,之前的配置才会生效。
二、OpenClaw 安装飞书插件
现在,我们把视角切换到 OpenClaw 这边。打开命令行工具,输入以下命令来添加新的渠道插件:
openclaw channels add
命令执行后,会看到一个交互式列表。从中选择“飞书”选项。
根据后续提示,依次输入之前在飞书后台获取的 App ID 和 App Secret 等信息,完成绑定。
插件添加成功后,别忘了重启 OpenClaw 网关服务,让配置生效。使用这个命令:
openclaw gateway –force
三、回到飞书后台设置事件回调
配置还没完,我们需要回到飞书后台,让飞书知道该把消息发送到哪里。在应用后台找到“事件订阅”设置项。
点击“添加事件”,在弹出的列表中,找到并勾选“接收消息”这一项。这是机器人能响应用户聊天的核心事件。
为了让机器人能准确识别消息来自谁,通常还需要开通通讯录访问权限。勾选相关权限后,点击确认开通。
完成以上事件和权限配置后,切记:必须再次回到版本管理页面,创建一个新版本并发布。否则,刚做的回调设置是不会生效的。
四、在飞书中与 OpenClaw 对话
所有配置就绪,激动人心的测试时刻到了。在飞书里找到你的机器人,尝试发送第一条消息。
第一次对话很可能会遇到一个常见的“拦路虎”——权限报错。别慌,这通常是安全机制在起作用。仔细看机器人的回复,它一般会给出一个配对码。你只需要复制最后那行命令,例如:
openclaw pairing approve feishu D7K67DJD
回到 OpenClaw 所在的命令行,执行这条命令,即可将对应的飞书用户加入白名单。
白名单开通后,再次尝试聊天。这次,你应该能收到正常的回复了。
至此,整个集成流程已经成功跑通。
现在,你就可以在飞书的手机或电脑客户端上,像跟同事聊天一样,随时给 OpenClaw 下达指令,让它为你处理任务了。整个配置过程看似步骤不少,但只要顺序正确、信息填写无误,成功连接就是水到渠成的事。


















