用飞书机器人把链接和在线文档同步到笔记

如果你平时在飞书里办公，经常会顺手把一条链接、一篇在线文档分享给同事或自己。现在你可以把这些内容直接发给「笔记同步助手」机器人，它会帮你整理成一篇干净的笔记，自动写进你日常使用的笔记仓库。

机器人就住在你的飞书里，你主动发什么，它才同步什么 —— 不发就不动，全程由你掌控。

它能做什么

把机器人加进飞书后，在和它的单聊里：

• 发网页链接 → 机器人会把链接交给 DeepSeek、豆包、千问 等 AI 处理，整理成一篇图文笔记，写进你的笔记仓库
• 发在线文档 / 电子表格链接（需先完成一次配置）→ 机器人会用你自己创建的飞书应用去读，整理成一篇笔记保存下来，标题沿用文档原标题
• 一条消息里可以一次发多个链接

最终都会落进你日常在用的那个笔记仓库（目前支持 Obsidian 与思源笔记，取决于你在「笔记同步助手」服务号里配置的目的地）。

整体流程（先看一眼）

阶段	做什么	大概耗时
1️⃣ 加机器人	飞书扫码把机器人加进来	1 分钟
2️⃣ 绑定	把服务号里的「客服代码」发给它	1 分钟
3️⃣ 发链接	到这里，网页链接就能同步了	立即可用
4️⃣ 建自己的飞书应用	在飞书开放平台建一个只读应用（本文重点）	约 5 分钟，只做一次
5️⃣ 填凭据并授权	在设置页粘贴 App ID / Secret，点一次授权（有多个飞书账号可以都授权上）	1 分钟
6️⃣ 发文档	到这里，在线文档 / 表格也能同步了	立即可用

只想同步网页链接的话，做完前三步就可以停下；第 4、5 步是「同步飞书里的在线文档」才需要的一次性配置。

第一步：在飞书里添加机器人

用飞书 App 扫描下面的二维码，或在飞书里打开下面的链接，即可把机器人添加到你的飞书：

添加链接（在飞书里点击打开）：

https://applink.feishu.cn/client/app_share/open?appId=cli_aaa096cb90761cdc

💡 这个链接需要在飞书客户端内打开才会跳到添加页；用普通浏览器打开会提示「请在飞书中打开」。手机上直接用飞书扫码最方便。

添加成功后，进入和机器人的单聊，它会先发一条引导消息，大致长这样：

👋 你好！我能帮你把内容同步到你的笔记（Obsidian / 思源笔记）。
1️⃣ 绑定：把微信公众号里获取的「客服代码」（o 开头的 28 位字符）直接发给我
2️⃣ 发链接：把任意网页链接发给我，自动同步到你的笔记
3️⃣ 同步飞书文档：绑定后到 https://my.bijitongbu.site/settings 的「飞书文档」页，
   按指引创建你自己的飞书应用并完成授权（配置一次，长期使用）

看到这条消息就说明机器人已经加好了。

第二步：获取并发送绑定密钥

机器人需要知道”内容要存进哪个笔记仓库”，所以第一次使用前要绑定一次。这个密钥（机器人里称作「客服代码」）从微信 「笔记同步助手」 服务号里取：

1. 微信打开 「笔记同步助手」 服务号
2. 点击底部菜单最右侧的「客服」，打开后点击 「客服代码」
3. 会返回你的客服代码（一串 o 开头、共 28 位的字符），整段复制下来

没关注服务号的话，先在微信里搜索”笔记同步助手”关注。

回到飞书，把刚才复制的密钥整段直接发给机器人（只发密钥本身，不要带其他文字）。绑定成功后机器人会回：

绑定成功！现在可以直接把链接发给我，处理完成后会同步到你的笔记。

如果还想让我帮你同步「飞书文档」（包括有权限保护的），请到
https://my.bijitongbu.site/settings 的「飞书文档」页，按指引创建你自己的飞书应用并完成授权。

⚠️ 看到这条回执 = 绑定成功。如果机器人提示”还没有绑定笔记账号”，多半是密钥没复制完整 —— 回服务号按上面的菜单重新取一次再发。

想换一个笔记账号？直接发新密钥过来即可，机器人会用新密钥覆盖旧绑定。

第三步：开始发链接（马上就能用）

绑定后就能用了。在单聊里把任意网页链接发给机器人，它会自动整理成笔记写进你的仓库，并当场回一条回执：

已接收 1 条链接，稍后会同步到你的笔记。同步完成后，微信服务号「笔记同步助手」会给你发通知。

• 回执 ≠ 已经写好：整理是在后台进行的，真正写完之后，微信服务号「笔记同步助手」会给你发一条通知，收到通知再去笔记里看即可
• 一条消息里可以同时发多个链接，会分别各整理成一篇笔记；单条消息最多处理 5 条链接，多的请分条发
• 计费规则与你平时把链接发给对应助手好友时完全一致，按你的账号额度 / 积分计算，详见 《积分用途说明》

---

第四步：创建属于你自己的飞书应用（同步在线文档必做，只做一次）

要让机器人读飞书里的在线文档，需要一个飞书应用做载体。这一步创建的，是属于你自己的应用：

• 🔐 凭据在你名下：App ID / Secret 是你自己在开放平台生成的，随时可以重置；我们不持有能读所有人文档的共享应用
• 👤 以你自己的身份读：授权之后，机器人以”你本人”的身份读你主动发来的文档，你看不到的文档它同样看不到
• ♻️ 一次配置，长期使用：配置完成后不用再管；不想用了在飞书里撤销授权，或在设置页点「清除配置」即可

动手前准备

• 用电脑浏览器操作（开放平台后台是 PC 界面），飞书账号用你日常那个即可
• 只需要只读权限，不需要开通机器人能力、事件订阅、Encrypt Key 这些
• 如果你的飞书属于公司组织且你不是管理员，权限开通和版本发布可能需要管理员审核（个人飞书 / 自己是管理员时免审、即时生效）

4.1 打开开放平台，进入开发者后台

浏览器打开：

https://open.feishu.cn/

用你的飞书账号登录后，点击右上角的 ①「开发者后台」：

4.2 创建一个「企业自建应用」

进入后台后，在「选择应用创建方式」里点 ①「创建企业自建应用」（不要选「使用模板创建」）：

弹出的表单里填两个必填项 —— ① 应用名称、② 应用描述，都填「笔记同步助手」就行（这个名字只有你自己在授权页看得到，随便起也可以）。应用图标保持默认即可：

填好后点右下角 ①「创建」：

4.3 开通 4 条权限（用 JSON 一键导入最快）

应用创建好后会进入应用详情页，点左侧菜单 ①「权限管理」：

在权限管理页点 ①「批量导入/导出权限」（旁边的「开通权限」是一条条搜索着勾，用批量导入更快、也不会漏勾）：

把下面这段 JSON 完整复制，粘贴进弹窗「导入」页的 JSON 输入框里（把框里原有内容全部替换掉）：

{
  "scopes": {
    "tenant": [
      "docx:document:readonly",
      "drive:drive:readonly",
      "wiki:wiki:readonly"
    ],
    "user": [
      "offline_access",
      "docx:document:readonly",
      "drive:drive:readonly",
      "wiki:wiki:readonly"
    ]
  }
}

这几条权限分别是干什么的：

权限码	飞书里的名字	为什么需要
docx:document:readonly	查看新版文档	读你发来的文档正文
wiki:wiki:readonly	查看知识库	读知识库（wiki）里的文档 / 表格节点
drive:drive:readonly	查看、评论和下载云空间中所有文件	文档里的图片、电子表格的内容，以及旧版文档的正文
offline_access	保持登录	让授权长期有效，免得过一阵就要重授权

tenant 是应用身份，user 是用户身份，两组都要开：用户身份负责”你能看的文档都能同步”，应用身份负责”没授权时也能读已把应用加为协作者的文档”。上面的 JSON 已经把两组都写好了，照抄即可。

🔴 授权只认「用户身份权限」那一栏：只在「应用身份权限」里勾上是不算数的 —— 授权当时不一定报错（应用创建者本人尤其不会被拦），但之后文档里的图片、电子表格、旧版文档全读不到，而且少了 offline_access 的话这次授权最快 2 小时就失效。用上面的 JSON 批量导入不会漏；手动一条条勾的话，两栏都要确认到。

粘贴好 ① JSON，点 ②「下一步，确认新增权限」：

确认页可以切 **①「应用身份权限」/「用户身份权限」**两个 tab 核对一下（应用身份 3 条、用户身份 4 条 —— 用户身份那边多一条 offline_access），然后点 ②「申请开通」：

开通完成后，列表里一共会出现 7 行：docx / drive / wiki 三条各占「用户身份」「应用身份」两行（6 行），再加上只有用户身份的 offline_access 一行。① 权限状态要全部是「已开通」才算成功 —— 最后那行 offline_access 往往要把列表往下滑才看得到，别漏看。确认无误后，点左侧 ②「安全设置」 进入下一步：

公司组织里如果显示「审核中」，说明要等管理员批；批完再继续后面的步骤。

⚠️ 如果你之前已经发布过版本（不是第一次配置，只是回来补权限）：补开的权限要回到「版本管理与发布」重新创建一个版本并发布，才对你以外的人生效。你自己是应用创建者，权限一开通就能用，感知不到这一步；漏了它，别人点授权时会被飞书拦下（处理办法见第五步末尾「有多个飞书账号？可以都授权上」那节的最后一条）。

4.4 添加重定向 URL（授权完成后跳回来的地址）

在「安全设置 → 重定向 URL」里，把下面这条地址填进输入框：

https://feishu-ingest.notebooksyncer.com/oauth/callback

① 粘贴地址 → 点 ②「添加」：

⚠️ 这条地址必须一字不差，末尾不要多空格、不要多斜杠，也不要写成 http://。写错的话第五步点「完成授权」会被飞书拦下来。

添加成功后，① 下方列表里会出现这条 URL。确认后点页面顶部的 ②「创建版本」：

4.5 创建版本并发布（不发布权限不生效）

进入「版本详情」页，① 应用版本号保持默认的 1.0.0，② 更新说明随便写一句（如”更新应用版本”）：

继续往下滑，确认 ① 可用范围里包含你自己（个人飞书默认就是你自己），然后点 ②「保存」：

弹出确认框后点 ①「确认发布」：

个人飞书 / 自己是管理员时免审核，提交后立即生效，页面上会看到 ①「已发布」。接着点左侧 ②「凭证与基础信息」：

4.6 复制 App ID 与 App Secret

在「应用凭证」区域，用两个复制按钮分别复制 ① App ID 和 ② App Secret：

• App ID 形如 cli_ 开头的一串字母数字
• App Secret 默认是打码的，点旁边的眼睛图标可以显示、点刷新图标可以重置
• 🔒 Secret 相当于这个应用的密码，不要发给任何人（本教程截图里的 App ID 也已打码）

建议把两串先粘到一个临时的地方，下一步要用。

---

第五步：把凭据填进设置页并完成授权

用浏览器打开设置页（用微信扫码登录）：

https://my.bijitongbu.site/settings

登录后：点顶部 ①「飞书文档」 tab → 把刚才复制的 ② App ID、③ App Secret 分别粘进去 → 点 ④「保存并校验」：

「保存并校验」会当场拿你的凭据去飞书验一次，通不过会直接报错（详见下面 Q3），所以看到 ① 绿色的「凭据校验通过并已保存」 就说明这两串是对的。此时页面上会多出一个 ②「完成授权」 按钮：

点「完成授权」，会新开一个窗口打开飞书的授权页。核对 ① 可授予的权限（共 4 项，全是只读），然后点 ②「授权」：

看到 ① 这句提示就代表授权成功了，可以关掉这个页面：

回到设置页点一次「刷新状态」，状态栏会变成 ✅ 应用已配置，授权已完成，下方还会列出已授权的飞书账号——到这里配置就全部结束了。

已保存的 App Secret 出于安全不会回显，设置页里 Secret 栏是空的属于正常现象，不用重填。

有多个飞书账号？可以都授权上（2026-08-21 起）

同一个人常常有不止一个飞书账号，两个账号能看到的文档也不一样。设置页的「已授权的飞书账号」列表最多可以放 5 个：

1. 点「添加飞书账号授权」（第一次授权后按钮就是这个名字）
2. 在打开的飞书授权页里切换到另一个账号登录，同意授权
3. 回设置页点「刷新状态」，列表里就会多出一行

读文档时会按列表从上到下逐个账号尝试：账号 1 读不到就自动换账号 2……全都读不到，再用你的应用（组织）身份兜底；还不行才回落公开链接方式。所以你不用关心”这篇文档该用哪个账号看”，直接发链接就行。

• 每一行都能单独「删除」，删掉后读文档不再尝试这个账号
• 某个账号显示**「已失效，请重新授权」（飞书那边撤销了授权，或长期没用过期了）：点「添加飞书账号授权」，用那个账号**再授权一次就会原地恢复，不会占掉新的一格
• 企业自建应用只能被本企业的成员授权。要用其他企业的账号读文档，需要在那个企业里另建一个应用（本设置页一次只保存一份应用凭据）
• 换成别人的账号（不是你本人的号）来授权时，飞书可能会把他拦下来，提示缺 offline_access、drive:drive:readonly 之类的权限（错误码 20027）。原因是权限对应用创建者本人是一开通就能用，对其他成员则要等版本发布之后才生效。按这两步处理：
  1. 回开放平台「权限管理」，照第 4.3 步核对 7 行权限是否都「已开通」（尤其容易漏的 offline_access）
  2. 到「版本管理与发布」重新创建一个版本并发布，发布时确认可用范围包含对方；公司组织要等管理员审核通过 发布好之后，让对方重新点一次「添加飞书账号授权」即可

第六步：把在线文档链接发给机器人

回到飞书，在和机器人的单聊里，把文档链接复制粘贴发给它（也可以把文档「分享 → 发送到会话」转发给机器人）。它会当场回：

已读取文档《XXXXXX》，正在同步到你的笔记。同步完成后，微信服务号「笔记同步助手」会给你发通知。

支持的类型：

类型	支持情况	说明
新版在线文档（docx）	✅	正文、标题层级、列表、代码块、表格、图片都会同步
电子表格（sheets）	✅	转成 Markdown 表格；一次最多导出前 3 个工作表 / 200 行 / 26 列，超出会在笔记末尾注明
旧版文档（docs）	✅	链接形如 .../docs/doccn… 的老文档；正文、标题层级、列表、表格、图片都会同步（2026-08-21 起支持，不用补开权限）
知识库（wiki）里的文档 / 表格	✅	直接发知识库链接即可，机器人会自动找到对应的文档
多维表格（base）	❌	暂不支持，机器人会明确提示

• 链接里带 ?sheet=xxxx 时（在飞书里点开某个工作表再复制链接），只导出你正在看的那个工作表
• 单条消息最多处理 3 篇文档，多的请分条发送
• 同样是后台处理，写完之后微信服务号会给你发通知

授权与安全

• 授权页请求的 4 项权限全部是只读，且只用于把你主动发来的文档整理成笔记；机器人不会主动去翻你的文档库
• 你看不到的文档，机器人同样读不到（它用的就是你本人的身份）
• 撤销授权：飞书「设置 → 应用授权管理」里撤销；或在设置页「飞书文档」tab 点「清除配置」（会同时删掉已保存的 App ID / Secret 与授权）
• 撤销其中一个账号：设置页「飞书文档」tab 的账号列表里点那一行的「删除」，其它账号不受影响
• 换一个应用：把新的 App ID + App Secret 一起填进去保存即可，旧的授权（含所有已授权账号）会自动作废
• 如果暂时不想授权：把你的应用添加为某篇文档 / 某个知识库的协作者，机器人也能以应用身份读到那些文档（范围仅限你添加过的）

常见问题

Q1. 添加机器人的链接点了没反应 / 提示在飞书中打开

那个链接必须在飞书客户端内打开。用手机飞书直接扫本文的二维码最稳；电脑端可以把链接复制到飞书的任意聊天框里，点击后会跳转添加页。

Q2. 把密钥发过去，机器人一直说”还没绑定”

多半是密钥没复制完整或带了多余字符。客服代码是一串 o 开头、共 28 位的字符，回「笔记同步助手」服务号按 底部菜单最右侧「客服」 → 客服代码 重新取一次，整段复制后再发，中间不要加空格或文字。

Q3. 设置页点「保存并校验」提示”飞书校验未通过”

报错里会带飞书返回的错误码，例如：

飞书校验未通过（10014：invalid app_id or app_secret），请核对 App ID / App Secret

按这个顺序排查：

1. App ID / Secret 复制错位——两串来自同一个应用的「凭证与基础信息」页，别把别的应用的混着填
2. 粘贴时带了空格或换行——用复制按钮复制，不要手打
3. Secret 被重置过——重置后旧 Secret 立即失效，回后台复制新的
4. 注意 App ID 是 cli_ 开头；填成别的（如 cli 后面少了下划线）会直接被格式校验拦下

Q4. 点「完成授权」没反应 / 新窗口被拦截了

授权页是新开窗口打开的，浏览器如果拦了弹窗，允许一次再点即可（Safari / 手机浏览器较常见）。弹窗被彻底禁用时，页面会退回到”在当前标签页跳转”，也能正常完成。

Q5. 授权页报错，或授权后回来还是没成功

九成是第 4.4 步的重定向 URL 没配对。回开放平台「安全设置 → 重定向 URL」核对，必须与下面这条完全一致（一个字符都不能差）：

https://feishu-ingest.notebooksyncer.com/oauth/callback

另外确认第 4.5 步版本已经发布（应用状态是「已发布 / 已启用」），未发布的应用授权会失败。

Q6. 机器人提示”还没有完成授权”或”没有这篇文档的访问权限”

• 提示还没完成授权：说明凭据保存了但授权那一步没做完，点机器人给出的授权链接、或回设置页点「完成授权」补上
• 提示没有访问权限：机器人用的是你本人的身份，说明它试过的每个飞书账号（提示里会列出来）都打不开那篇文档。先在飞书里确认你自己能打开它；如果是另一个飞书账号才能打开，到设置页「飞书文档」点「添加飞书账号授权」把那个账号也加上，再把链接重发一次
• 全部账号都读不到时，机器人会自动改用「公开链接」方式再试一次：文档开了”互联网上获得链接的人可阅读”就还能同步到笔记；没开的话拿到的只是登录页，仍需按上面的方法处理

Q7. 发过去提示”暂不支持的飞书链接类型”

目前支持新版文档（docx）、旧版文档（docs）、电子表格（sheets），以及知识库（wiki）里的这几类节点。多维表格（base）等暂不支持。

旧版文档（链接形如 .../docs/doccn…）从 2026-08-21 起已支持，不需要回去补开任何权限，直接把链接发给机器人即可。如果你在这之前收到过”暂不支持”的提示，现在重发一次就行。

Q8. 用了一段时间提示”授权已失效”

如果你在飞书里改了密码、撤销过授权，或重置了 App Secret，授权会失效。点机器人给出的新授权链接重新授权一次，再把文档链接发一遍即可；Secret 重置过的话，要先回设置页把新的 App ID + Secret 一起重新保存。

授权多个账号时，设置页的账号列表会把失效的那个标成**「已失效，请重新授权」，其它账号照常可用。用那个账号**重新授权一次即可原地恢复，不会多占一格。

Q9. 机器人会读我没发给它的东西吗？

不会。机器人只处理你在单聊里主动发给它的链接和文档；它不会主动去访问你的文档库，也读不到你本人无权查看的内容。第四步创建的应用只开了 3 项只读权限加 1 项「保持登录」，没有任何写入 / 删除能力。

Q10. 现在支持把内容同步到哪些笔记软件？

目前飞书机器人支持把内容同步到 Obsidian 与思源笔记这两个笔记软件。绑定时用哪个账号的密钥，内容就进哪个仓库。

Q11. 这一套配置需要每台设备都做一遍吗？

不需要。应用配置 + 授权都是跟你的账号绑定的，只做一次；换电脑、换手机、重装飞书都不用重来。

相关阅读

• Obsidian 安装与配置教程
• 思源笔记安装与配置教程
• 积分用途说明
• 在线文档剪藏教程