首页 › 飞书接入

飞书 → Obsidian 同步接入

用飞书自建应用(个人版即可免费创建,无需企业认证):在飞书里直接给机器人发链接、文字、图片、文件,服务端自动整理入队,电脑上的 Obsidian 一点同步即落库。

链路:飞书给机器人发消息 → 事件回调 https://note.anwang.cn/api/feishu/callback(加密 AES-256-CBC)→ 服务端整理入队 → 机器人自动回复「已收到 #N」→ Obsidian 插件 pull 落库。

第一步:创建自建应用(约 5 分钟)

  1. 打开 飞书开放平台 · 开发者后台,用个人飞书账号登录,点「创建企业自建应用」,名字如「笔记同步」。
  2. 左侧「应用能力」→ 添加 机器人 能力。
  3. 左侧「权限管理」→ 开通:im:message(获取与发送单聊、群组消息)和 im:message.p2p_msg:readonly(读取单聊消息)。图片/文件下载依赖这两项。
  4. 左侧「事件与回调」→ 订阅方式选「将事件发送至开发者服务器」,请求地址填 https://note.anwang.cn/api/feishu/callback(先别保存,看下一步)。
  5. 同页「加密策略」:Encrypt Key 与 Verification Token 生成后先发给管理员写入服务端(自测已验证该加密链路),再点保存——飞书会发 challenge 验证,服务端会正确应答。
  6. 「事件与回调」→ 添加事件 → 搜索并订阅 im.message.receive_v1(接收消息)。
  7. 「版本管理与发布」→ 创建版本并发布(个人自用无需审核,立即生效)。

第二步:需要发给管理员的四项凭据

凭据在哪里拿
App ID开发者后台 → 凭证与基础信息 → App ID(cli_ 开头)
App Secret同页 App Secret(用于获取访问凭证与回复消息)
Verification Token事件与回调 → 加密策略 页签
Encrypt Key同页(建议配置;不配也可运行,但安全性降低)

第三步:使用

  1. 飞书里搜索你的应用名(或从工作台进入),打开与机器人的单聊;
  2. 发链接 → 自动抓取正文转 Markdown;发文字 → 随手记;发图片 / 文件 / 语音 / 视频 → 原件转存入库;发富文本 → 按结构转 Markdown;
  3. 机器人自动回复「已收到并进入同步队列(#N)」;
  4. 电脑 Obsidian 点同步(或等自动同步),笔记出现在 Inbox/ 对应目录。

安全说明