前置准备拥有企业飞书账号个人版无法创建自建机器人应用且你是企业管理员 / 有应用创建权限浏览器打开飞书开放平台官网https://open.feishu.cn本地 Java 项目默认端口8080SpringBoot 默认后续内网穿透映射 8080 端口工具ngrok内网穿透开发阶段必须飞书云端无法直接访问本地[localhost]第 1 步登录开发者后台创建企业自建应用飞书开放平台首页点击右上角登录用电脑飞书扫码登录进入右上角「开发者后台」首页点击创建企业自建应用填写应用信息自用随意填应用名称个人 AI 智能管家应用描述飞书驱动 Java 个人台账 AI 知识库机器人应用图标自选 / 跳过点击创建进入应用详情页第 2 步保存核心凭证 AppID AppSecretJava 对接必备左侧菜单凭证与基础信息App IDcli_xxxxxxx复制保存Java 配置文件必填App Secret点击「查看」复制务必妥善保管不要泄露记录「事件加密密钥」后续回调解密用可先复制第 3 步开通机器人基础能力必须左侧菜单添加应用能力在能力列表找到机器人点击「开通」开通后应用获得收发飞书消息的基础身份第 4 步开通消息核心权限收消息、发消息、读取文件左侧菜单权限管理 → API 权限搜索框依次输入下面权限逐个开通im:message读取用户消息基础权限im:message:send_as_bot机器人发送消息回复卡片 / 文本im:message.p2p_msg:readonly读取私聊消息im:resource下载飞书上传的文件日志、PDF、图片contact:contact:readonly获取发送消息的你的用户信息开通操作选中权限 → 点击「开通权限」→ 确认开通全部显示已开通第 5 步配置事件订阅飞书消息推送到你的 Java 服务订阅方式选将事件发送至开发者服务器请求地址填写https://公网ip:host/feishu/event/feishu/event 是 Java 写的回调接口路径保存飞书会自动发送 challenge 校验请求Java 接口需原样返回 challenge 才算校验成功第 6 步创建应用版本并发布权限、事件才会生效90% 人踩坑开通权限、添加事件后不发布 不生效左侧菜单应用发布 → 版本管理与发布右上角点击 创建版本版本号填1.0.0更新说明初始化机器人基础能力全部下拉默认勾选保存版本点击 申请发布企业管理员通过审核自己是管理员直接通过第 7 步把机器人添加到飞书私聊测试发布成功后左侧菜单「机器人」复制机器人对话链接电脑飞书浏览器打开链接发起私聊发送消息测试测试学习记录 Python 2小时此时 Java 服务启动后就能收到这条消息事件补充拓展配置后续开发用到文件上传能力上传日志 / 图片 / PDF 给 AI 处理事件与回调 → 添加事件im.resource.upload_v1文件上传事件同步开通 im:resource 权限飞书表单回调后续替代文字指令录入台账添加事件approval.instance.created_v1表单提交事件开通审批相关权限安全加密配置HTTP 回调模式必开事件与回调 → 加密策略复制加密密钥到 Java 配置用于解密飞书推送的加密消息