乐于分享
好东西不私藏

把手教你把Openclaw接入飞书(Feishu),我踩过的坑都在这里了

把手教你把Openclaw接入飞书(Feishu),我踩过的坑都在这里了
用OpenClaw把大模型接进企业微信和飞书,安利给技术小白的完整攻略

引言

最近把OpenClaw接入了飞书,整个过程比想象中顺利,但中间确实踩了几个坑。

今天把完整流程整理出来,给想用AI辅助办公的朋克们做个参考。

为什么是飞书?

飞书相比微信,有几个天然优势:

-开放接口:企业自建应用可以获取到完整的机器人能力

-消息可靠:不像微信那样动不动就封杀网页版接口

-多端同步:手机电脑都能收到消息

-权限清晰:企业管理员可以统一管理应用权限

如果你用的是企业微信,流程几乎一模一样,OpenClaw也支持。

第一步:创建飞书应用

打开 [飞书开放平台](https://open.feishu.cn/app),点击「创建企业自建应用」。

创建完成后,在「凭证与基础信息」页面复制两个东西:

-App ID(格式类似:`cli_xxx`

-App Secret

⚠️ App Secret 一定要保密,不要直接发给别人。

第二步:配置应用权限

这是最容易出错的一步。

在「权限管理」页面,需要添加以下核心权限:

   {                                                                                                                                                                                                                "scopes": {                                                                                                                                                                                                      "tenant": [                                                                                                                                                                                                      "im:message",                                                                                                                                                                                                  "im:message:send_as_bot",                                                                                                                                                                                      "im:message:readonly",                                                                                                                                                                                         "im:message.p2p_msg:readonly",                                                                                                                                                                                 "im:message.group_at_msg:readonly",                                                                                                                                                                           "im:chat.members:bot_access",                                                                                                                                                                                  "im:resource",                                                                                                                                                                                                 "contact:user.employee_id:readonly"                                                                                                                                                                         ],                                                                                                                                                                                                             "user": [                                                                                                                                                                                                        "im:chat.access_event.bot_p2p_chat:read"                                                                                                                                                                     ]                                                                                                                                                                                                            }                                                                                                                                                                                                            }  

注意:如果权限添加失败,机器人是无法正常收发消息的。

第三步:开启机器人能力

在「应用能力」→「机器人」中:

1. 开启机器人能力

2. 设置机器人的名字

第四步:配置事件订阅

这是另一个容易踩坑的地方。

在「事件订阅」页面:

1. 选择「使用长连接接收事件」(WebSocket模式)

2. 添加事件:`im.message.receive_v1`

⚠️ 一定要先启动OpenClaw网关,再保存事件订阅,否则会保存失败。

第五步:发布应用

在「版本管理与发布」中:

1. 创建应用版本

2. 提交审核并发布

如果是企业内部自建应用,通常可以直接发布,不需要外部审核。

-----------------------------------------------

接下来一部分主要是OpenClaw端配置

第六步:配置OpenClaw

方法A:向导(推荐)                                                                 
openclaw channels add 
方法B:手动配置
 编辑 ~/.openclaw/openclaw.json:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  {                                                                                                                                                                                                                "channels": {                                                                                                                                                                                                    "feishu": {                                                                                                                                                                                                      "enabled"true,                                                                                                                                                                                               "dmPolicy""pairing",                                                                                                                                                                                         "accounts": {                                                                                                                                                                                                    "main": {                                                                                                                                                                                                        "appId""cli_你的AppID",                                                                                                                                                                                      "appSecret""你的AppSecret",                                                                                                                                                                                  "name""AI助手"                                                                                                                                                                                             }                                                                                                                                                                                                            }                                                                                                                                                                                                            }                                                                                                                                                                                                            }                                                                                                                                                                                                            } 
方法C:既然都安装了OpenClaw,就让AI助手帮你完成,直接对话发送你的需求:

配置飞书 app id:cli_xxxx App secret:tIcxxxxx

配置已写入 ✅

现在重启网关使配置生效: 

                                                                                            现在工作完成了吗?
NO,你现在在飞书进行测试会有下面的提示:
现在你需要执行下面的命令:
 openclaw pairing approve feishu <配对码>   

配对成功后,就可以在飞书里直接和大模型对话了。

 如果你在配置的过程中,碰到任何问题,欢迎留言讨论~