名称： larksuite-wiki
描述： 管理与导出 Lark Suite（飞书）Wiki/知识库文档。支持读取、搜索、同步子文档，并增量导出到本地 Markdown 文件。
主页： https://open.larksuite.com
标签： [lark, wiki, knowledge-base, export, sync, markdown]
元数据：
{
"openclaw":
{
"emoji": "📚",
"requires": { "env": ["LARK_APP_ID", "LARK_APP_SECRET"] },
"primaryEnv": "LARK_APP_ID",
},
}

Lark Suite Wiki

管理与导出 Lark Suite（飞书）Wiki/知识库文档，支持递归同步与增量更新。

前提条件

1. 在 https://open.larksuite.com/console 创建 Lark/飞书应用
2. 启用以下权限：
   - docs:doc:read
   - drive:drive:read
   - wiki:wiki:read
3. 发布应用并授权其访问你的 Wiki
4. 设置环境变量（或编辑脚本默认值）：
   bash export LARK_APP_ID="cli_xxxxxxxx" export LARK_APP_SECRET="xxxxxxxx"

命令

列出 Wiki 空间

larksuite-wiki spaces

读取文档（含子文档链接）

larksuite-wiki read <doc_id_or_url>

导出单个文档

larksuite-wiki export <doc_id_or_url> --output ./docs/

显示文档树状结构

larksuite-wiki tree <doc_id_or_url>

同步整个 Wiki（递归导出）

# 首次同步 - 导出所有文档
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/

# 增量同步 - 仅导出已更改的文档
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/

# 强制重新导出全部内容
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/ --force

功能特性

1. ✅ 批量导出

一键导出整个知识库。

2. ✅ 递归子文档导出

自动追踪并导出所有链接的子文档。

3. ✅ 保持目录结构

创建与 Wiki 结构匹配的嵌套文件夹：

lark-wiki/
├── 01_首页/
│   ├── 01_首页.md
│   └── 01_日常复盘/
│       ├── 01_日常复盘.md
│       └── ...
├── 02_云聪金融分析/
│   └── ...

4. ✅ 增量同步

追踪文档修订版本，仅导出已更改的文档：
- 将同步状态保存至 .lark-sync-state.json
- 比较修订版本 ID
- 跳过未更改的文档

快速开始

导出整个 Wiki

# 从 URL 中获取 Wiki 根文档 ID
# https://xxx.larksuite.com/wiki/TDCZweBJ2iMFO4kI1LAlSE62gnd

# 同步全部内容
python3 larksuite-wiki.py sync TDCZweBJ2iMFO4kI1LAlSE62gnd --output ./my-wiki/

每日增量同步

# 每日运行 - 仅导出已更改的文档
python3 larksuite-wiki.py sync TDCZweBJ2iMFO4kI1LAlSE62gnd --output ./my-wiki/

输出结构

每个文档拥有独立的文件夹：
- 主 .md 文件
- 子文档对应的子文件夹
- 带编号前缀以保持顺序（01_、02_ 等）

API 参考

• Lark 开放平台：https://open.larksuite.com/
• Wiki API：https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/wiki-v1/space/overview
• Docx API：https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/docx-v1/document/overview

注意事项

• 文档必须明确与应用共享
• 部分区块类型可能无法完美转换为 Markdown
• 包含大量子文档的大型 Wiki 可能需要较长时间同步
• 同步状态本地保存，用于增量更新