飞书 → Obsidian 同步接入
用飞书自建应用(个人版即可免费创建,无需企业认证):在飞书里直接给机器人发链接、文字、图片、文件,服务端自动整理入队,电脑上的 Obsidian 一点同步即落库。
链路:飞书给机器人发消息 → 事件回调 https://note.anwang.cn/api/feishu/callback(加密 AES-256-CBC)→ 服务端整理入队 → 机器人自动回复「已收到 #N」→ Obsidian 插件 pull 落库。
第一步:创建自建应用(约 5 分钟)
- 打开 飞书开放平台 · 开发者后台,用个人飞书账号登录,点「创建企业自建应用」,名字如「笔记同步」。
- 左侧「应用能力」→ 添加 机器人 能力。
- 左侧「权限管理」→ 开通:
im:message(获取与发送单聊、群组消息)和 im:message.p2p_msg:readonly(读取单聊消息)。图片/文件下载依赖这两项。
- 左侧「事件与回调」→ 订阅方式选「将事件发送至开发者服务器」,请求地址填
https://note.anwang.cn/api/feishu/callback(先别保存,看下一步)。
- 同页「加密策略」:Encrypt Key 与 Verification Token 生成后先发给管理员写入服务端(自测已验证该加密链路),再点保存——飞书会发 challenge 验证,服务端会正确应答。
- 「事件与回调」→ 添加事件 → 搜索并订阅
im.message.receive_v1(接收消息)。
- 「版本管理与发布」→ 创建版本并发布(个人自用无需审核,立即生效)。
第二步:需要发给管理员的四项凭据
| 凭据 | 在哪里拿 |
| App ID | 开发者后台 → 凭证与基础信息 → App ID(cli_ 开头) |
| App Secret | 同页 App Secret(用于获取访问凭证与回复消息) |
| Verification Token | 事件与回调 → 加密策略 页签 |
| Encrypt Key | 同页(建议配置;不配也可运行,但安全性降低) |
第三步:使用
- 飞书里搜索你的应用名(或从工作台进入),打开与机器人的单聊;
- 发链接 → 自动抓取正文转 Markdown;发文字 → 随手记;发图片 / 文件 / 语音 / 视频 → 原件转存入库;发富文本 → 按结构转 Markdown;
- 机器人自动回复「已收到并进入同步队列(#N)」;
- 电脑 Obsidian 点同步(或等自动同步),笔记出现在
Inbox/ 对应目录。
安全说明
- 凭据只存服务端密钥表(640 权限),不出现在任何源码与页面;
- 回调支持飞书官方加密策略(AES-256-CBC)与 Verification Token 双重校验,伪造请求直接拒绝;
- 事件按 event_id 去重,飞书重试不会产生重复笔记;
- 服务端出站请求仅访问 open.feishu.cn 域名。