飞书对接详细配置步骤

朋友们，如果你们也和我一样，费了老大劲把OpenClaw小龙虾装好，却卡在了让它跟飞书“牵手”这一步，那今天这篇可算来对了。说实话，我当初以为配置飞书对接就是个“填表”的活儿，结果愣是折腾了小半天，踩了几个不大不小的坑。今天我就把这套血泪换来的、保姆级的飞书对接配置步骤，掰开了揉碎了讲给你听，保证你跟着走一遍就能通。

第一步：别急着动手，先去飞书开放平台“领证”

想让你本地的AI助手和公司的飞书对话，你得先在飞书那边给它上个“户口”。这个户口，就是“企业自建应用”。

• 打开飞书开放平台，用你的管理员账号登录（个人账号不行哦，必须是能管理公司飞书团队的）。
• 在控制台里，找到“创建企业自建应用”。给应用起个名字，比如“我的AI小秘书”，描述随便写写就行。
• 创建成功后，你会进入应用详情页。这里有两串“密码”至关重要：App ID 和 App Secret。马上把它们复制下来，存到你的记事本里，App Secret只显示一次，丢了可就麻烦了！

权限配置：给它“能做什么”的许可

光有户口不行，还得告诉飞书，这个应用能干嘛。在左侧菜单找到“权限管理”，然后添加以下核心权限：

• contact:user.id:readonly（获取用户ID）
• im:message（接收与发送单聊、群聊消息）
• im:message.group_at_msg:readonly（接收群聊中@机器人的消息）
• 如果你需要它访问通讯录，还可以加上contact:user.base:readonly。

加完权限记得点击“批量申请”，版本号选最新的，然后提交。提交后，还需要回到“凭证与基础信息”页面，找到“申请发布”，等管理员审核通过（通常自己就是管理员，秒过）。

第二步：配置事件订阅与消息卡片（关键！）

这是最容易出错的一步！飞书怎么知道要把消息发给你本地的AI呢？靠的就是“事件订阅”。

• 在开放平台应用详情页，找到“事件订阅”。
• 在“请求地址URL”里，填入你本地OpenClaw服务的地址。默认是：http://localhost:3000/feishu/events。注意，飞书不支持纯本地localhost，所以你需要一个内网穿透工具！我用的是ngrok，在终端里运行 ngrok http 3000，它会给你一个临时的公网地址，比如 https://abcd.ngrok-free.app。把这个地址加上路径，填进去：https://abcd.ngrok-free.app/feishu/events。
• 点击“重新生成”Verification Token，也复制保存好。
• 点击“加密密钥”右边的“重置”，生成Encrypt Key，同样保存。
• 最后，在“订阅事件”里，添加“接收消息”下的“im.message.receive_v1”事件。保存所有配置。

消息卡片回调（可选但推荐）

如果你希望AI能回复交互式卡片消息，在“应用功能-消息卡片”里，同样配置一个请求地址，比如 https://abcd.ngrok-free.app/feishu/cards。Token和Key复用事件订阅的就行。

第三步：回到OpenClaw，注入灵魂

飞书那边“门牌号”和“钥匙”都给你了，现在要告诉家里的AI怎么用。

• 确保你的OpenClaw服务正在运行（openclaw start）。
• 打开OpenClaw的Web控制台（通常是 http://localhost:3000）。
• 在设置或技能管理里，找到“飞书”或“Feishu”的配置项。
• 把刚才保存的App ID, App Secret, Verification Token, Encrypt Key，一个一个对应地填进去。
• 在回调地址那里，确认填的是你配置事件订阅时用的那个带ngrok的完整地址。

最后一步：验收与“破冰”聊天

所有配置填好保存后，回到飞书开放平台“事件订阅”页面，你会看到一个“保存成功”的提示，并且下面会显示“URL验证状态”。如果显示“验证成功”，恭喜你，最难的一关已经过了！

现在，去你的飞书客户端，搜索你刚刚创建的那个应用“我的AI小秘书”，把它添加到聊天界面。然后，试着给它发一句“你好”。

当你的本地AI助手通过飞书回复你的时候，那种感觉，真的绝了——仿佛你亲手赋予了一个数字灵魂与真实世界对话的能力。原本冰冷的配置步骤，瞬间就有了温度。