Skills feishu-pdf-downloader

install

source · Clone the upstream repo

git clone https://github.com/wulaosiji/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/wulaosiji/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/feishu-pdf-downloader" ~/.claude/skills/wulaosiji-skills-feishu-pdf-downloader && rm -rf "$T"

manifest: feishu-pdf-downloader/SKILL.md

source content

Feishu PDF Downloader

Download files from Feishu (Lark) cloud drive using the Open API.

When to Use

需要从飞书云盘下载 PDF 或其他文件到本地时
已知文件 token 需要批量下载多个文件时
需要提取飞书存储的文档进行离线处理时
需要配合 PDF 处理工具进行后续文本提取或 OCR 时

Do NOT use this skill if

需要读取飞书文档内容而不下载文件 → 使用
```
feishu-doc
```
需要将文档转换为 Markdown → 使用
```
feishu-doc-converter
```
需要创建新文档 → 使用
```
feishu-doc-orchestrator
```

Typical Trigger Phrases

"帮我把飞书云盘的文件下载下来"
"Download this file from Feishu drive"
"提取飞书 PDF 到本地"
"根据 file_token 下载文档"

Workflow

Ask for inputs: 确认文件 token 和期望的本地保存路径
Verify credentials: 确保
```
~/.openclaw/.env
```
中包含有效的
```
FEISHU_APP_ID
```
和
```
FEISHU_APP_SECRET
```
Get token: 调用飞书认证 API 获取 tenant_access_token

Download file: 调用下载 API 获取文件二进制内容

python3 skills/feishu-pdf-downloader/scripts/download_feishu_pdf.py <file_token> [output_path]

Save locally: 将内容写入本地文件
Validate: 检查文件大小和完整性
Report result: 返回本地文件路径

Guardrails

确保应用具备
```
drive:file:read
```
权限
文件 token 必须有效且文件存在，否则下载会失败
下载的 PDF 如需 OCR 或表格提取，建议使用
```
pdfplumber
```
、
```
pdf2image
```
等工具

How to Get File Token

From Web URL

```
https://xxx.feishu.cn/file/<file_token>
```

https://xxx.feishu.cn/drive/folder/<folder_token>

From API

Use Feishu drive API to list files and get tokens.

Processing Downloaded PDFs

After downloading, use the

pdf

skill to:

Extract text:
```
pdftotext input.pdf output.txt
```
OCR scanned PDFs: Convert to images → pytesseract
Extract tables: Use pdfplumber

Troubleshooting

Issue	Solution
"FEISHU_APP_ID not set"	Check `~/.openclaw/.env` file format
"Failed to get token"	Verify app_id and app_secret are correct
"Download failed"	Check file_token is valid and file exists
Permission denied	Ensure app has drive:file:read permission

Related Skills

feishu-doc - 只读读取飞书文档内容
feishu-doc-converter - 将飞书文档转换为 Markdown

About

Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai