OpenClaw 配置飞书教程（小白版）
一、这篇教程是干什么的
二、先理解一件事：OpenClaw 和飞书是怎么连起来的
三、开始之前，你需要准备什么
1.
openclaw -vzsh: command not found: openclaw文档点击openclaw的部署教程（部署安装教程）
2.
3.
四、整体流程先看一遍
第二步：给应用开启机器人能力
第三步：开启事 件订阅，并选择长连接模式
第四步：获取 App ID 和 App Secret
第五步：把这两个参数写进 OpenClaw 配置文件
第六步：启动 OpenClaw，并在飞书里完成测试和配对
五、第一步：在飞书开放平台创建应用
六、第二步：开启机器人能力
七、第三步：开启事件订阅，并选择长连接
八、第四步：添加必要的事件和权限
九、第五步：获取 App ID 和 App Secret
十、第六步：配置 OpenClaw
1.
vim ~/.openclaw/openclaw.json2.
{
"channels": {
"feishu": {
"accounts": {
"main": {
"appId": "这里填写你的App ID",
"appSecret": "这里填写你的App Secret"
}
}
}
}
}3.
{
"channels": {
"feishu": {
"accounts": {
"main": {
"appId": "cli_xxxxx",
"appSecret": "abcdefg123456"
}
}
}
}
}十一、如果你之前装过第三方 Feishu 插件，要先处理一下
mv ~/.openclaw/extensions/feishu ~/.openclaw/extensions/feishu.bakopenclaw gateway十三、如何查看是否连接成功
openclaw gateway statusopenclaw logs --follow现在去飞书里找到你的应用机器人，给它发一条消息，比如：
你好OpenClaw: access not configured.
Your Feishu user id: ou_xxx
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve feishu ABCD1234十五、为什么会出现配对码
openclaw pairing approve feishu 配对码VC7Z93JTopenclaw pairing approve feishu VC7Z93JT十七、如果配对命令执行了还是不行
1.
openclaw pairing list2.
openclaw gateway status3.
openclaw logs --follow十八、群聊里怎么用
你好@机器人 你好十九、最常见的几个坑
坑 1
坑 2
坑 3
坑 4
坑 5
飞书页面提示“未检测到应用连接信息”
这通常说明 OpenClaw 还没成功连接飞书。做法是： 先把 OpenClaw 配好 启动 gateway 看日志确认连接成功 再回飞书后台操作
这通常说明 OpenClaw 还没成功连接飞书。
二十、写给第一次接触的人：你可以这样理解整件事
编辑 ~/.openclaw/openclaw.json
{
"channels": {
"feishu": {
"accounts": {
"main": {
"appId": "你的App ID",
"appSecret": "你的App Secret"
}
}
}
}
}openclaw gatewayopenclaw pairing approve feishu 配对码按照图片配置：
openclaw config 选择Feishu/Lark
选择No
这里要输入飞书app ID
添加应用
点击权 限这里，开通权限
选择消息里面，开通所有的内容
将一下内容复制粘贴进去
{
"scopes": {
"tenant": [
"base:app:copy",
"base:app:create",
"base:app:read",
"base:app:update",
"base:collaborator:create",
"base:collaborator:delete",
"base:collaborator:read",
"base:dashboard:copy",
"base:dashboard:read",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:form:read",
"base:form:update",
"base:record:create",
"base:record:delete",
"base:record:read",
"base:record:retrieve",
"base:record:update",
"base:role:create",
"base:role:delete",
"base:role:read",
"base:role:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"bitable:app",
"bitable:app:readonly",
"board:whiteboard:node:create",
"board:whiteboard:node:delete",
"board:whiteboard:node:read",
"board:whiteboard:node:update",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"contact:user.employee_number:read",
"contact:user.id:readonly",
"docs:doc",
"docs:doc:readonly",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.comment:write_only",
"docs:document.content:read",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document.subscription",
"docs:document.subscription:read",
"docs:document:copy",
"docs:document:export",
"docs:document:import",
"docs:event.document_deleted:read",
"docs:event.document_edited:read",
"docs:event.document_opened:read",
"docs:event:subscribe",
"docs:permission.member",
"docs:permission.member:auth",
"docs:permission.member:create",
"docs:permission.member:delete",
"docs:permission.member:readonly",
"docs:permission.member:retrieve",
"docs:permission.member:transfer",
"docs:permission.member:update",
"docs:permission.setting",
"docs:permission.setting:read",
"docs:permission.setting:readonly",
"docs:permission.setting:write_only",
"docx:document",
"docx:document.block:convert",
"docx:document:create",
"docx:document:readonly",
"drive:drive",
"drive:drive.metadata:readonly",
"drive:drive.search:readonly",
"drive:drive:readonly",
"drive:drive:version",
"drive:drive:version:readonly",
"drive:export:readonly",
"drive:file",
"drive:file.like:readonly",
"drive:file.meta.sec_label.read_only",
"drive:file:download",
"drive:file:readonly",
"drive:file:upload",
"drive:file:view_record:readonly",
"event:ip_list",
"im:app_feed_card:write",
"im:biz_entity_tag_relation:read",
"im:biz_entity_tag_relation:write",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.announcement:read",
"im:chat.announcement:write_only",
"im:chat.chat_pins:read",
"im:chat.chat_pins:write_only",
"im:chat.collab_plugins:read",
"im:chat.collab_plugins:write_only",
"im:chat.managers:write_only",
"im:chat.members:bot_access",
"im:chat.members:read",
"im:chat.members:write_only",
"im:chat.menu_tree:read",
"im:chat.menu_tree:write_only",
"im:chat.moderation:read",
"im:chat.tabs:read",
"im:chat.tabs:write_only",
"im:chat.top_notice:write_only",
"im:chat.widgets:read",
"im:chat.widgets:write_only",
"im:chat:create",
"im:chat:delete",
"im:chat:moderation:write_only",
"im:chat:operate_as_owner",
"im:chat:read",
"im:chat:readonly",
"im:chat:update",
"im:datasync.feed_card.time_sensitive:write",
"im:message",
"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.urgent",
"im:message.urgent.status:write",
"im:message.urgent:phone",
"im:message.urgent:sms",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_depts",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"im:tag:read",
"im:tag:write",
"im:url_preview.update",
"im:user_agent:read",
"sheets:spreadsheet",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet.meta:write_only",
"sheets:spreadsheet:create",
"sheets:spreadsheet:read",
"sheets:spreadsheet:readonly",
"sheets:spreadsheet:write_only",
"space:document.event:read",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"space:document:shortcut",
"space:folder:create",
"wiki:member:create",
"wiki:member:retrieve",
"wiki:member:update",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:node:update",
"wiki:setting:read",
"wiki:setting:write_only",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only",
"wiki:wiki",
"wiki:wiki:readonly"
]
}
}粘贴进去到命令里面
选择Open
选择完成
选择continue
然后我们在打开飞书平台，点击事件与回调，选择长连接，保存
点击添加事件，选择消息与群组
打开我们的飞书软件，打开应用按钮
二十二、结尾
只要你知道每一步是干什么的，这套流程其实并不复杂。
修改于 2026-03-24 03:56:22