StevenLikeWatermelon

飛書文件API技能

辦公效率v1.1.1
作者:StevenLikeWatermelon更新於 2026-05-11共 3 個版本 · 最新版本釋出於 2026-02-09feishu-docs@clawhub_stevenlikewatermelon/feishu-docs
檔案處理流程自動化#Docs#Feishu#文档#权限#飞书

據 AlphaMoat 統計,截至 2026-10,飛書文件API技能 累計下載 28,277 次、獲 10 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 992 位,在「辦公效率」分類(909 個)中排名第 124 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
2.8萬
星標
10
全站下載量排名
#992
全站前 10% · 「辦公效率」前 14%
平台累計下載星標評論
ClawHub ↗50953-
SkillHub ↗2.8萬10—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

覆蓋文件建立、讀取、全量更新、追加與刪除,支援把 Markdown 或 HTML 交給服務端轉換後寫入,還包含塊操作、許可權成員與按資料夾檢索。需要 FEISHU_APP_ID 與 FEISHU_APP_SECRET,也可放進 .env 由 dotenv 載入;token 會快取複用,未授權與限流錯誤按次數重試。 刪除文件或全量取代共用文件前,先核對文件 ID;App Secret 優先存於受保護的環境設定,避免透過命令列引數暴露。

資料釋出於 2026-10-27

可以用來做什麼

  • 把本地 Markdown 報告轉成飛書文件並追加到指定目錄
  • 批次搜尋文件並整理許可權成員清單

什麼時候用

  • 團隊文件需要程式化建立或更新時
  • 要把 Markdown 內容同步進飛書 Docx 時

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

把這份週報轉成飛書文件放到專案資料夾裡
搜一下標題含預算的文件並列出協作者

月度資料趨勢

累計下載2.8萬
34461.7萬3萬2026-03 · 累計下載 52852026-05 · 累計下載 83912026-06 · 累計下載 90662026-07 · 累計下載 1萬2026-08 · 累計下載 1.2萬2026-09 · 累計下載 1.5萬2026-10 · 累計下載 2.8萬26-0326-0926-10
星標10
27112026-03 · 星標 32026-05 · 星標 82026-06 · 星標 102026-07 · 星標 102026-08 · 星標 102026-09 · 星標 102026-10 · 星標 1026-0326-0926-10

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份累計下載環比星標
2026-102.8萬—10
2026-091.5萬—10
2026-081.2萬+17.8%10
2026-071萬+13.5%10
2026-069066+8.0%10
2026-058391—8
2026-035285—3

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

6.8 KB · ClawHub v1.1.1
---
name: feishu-docs
description: 飞书文档(Docx)API技能。用于创建、读取、更新和删除飞书文档。支持Markdown/HTML内容转换、文档权限管理。
metadata: {"clawdbot":{"emoji":"📝","requires":{"env":["FEISHU_APP_ID","FEISHU_APP_SECRET"]},"primaryEnv":"FEISHU_APP_ID"}}
---

# 飞书文档(Docx)技能

操作飞书新版文档(Docx)的openClaw技能,基于飞书开放平台 API 实现文档全生命周期管理。
展開全部(共 169 行)
## 功能特性

| 功能 | 说明 |
|------|------|
| 文档 CRUD | 创建、获取、更新(全量替换)、删除文档 |
| 内容追加 | 向已有文档末尾追加 Markdown/HTML 内容 |
| 内容转换 | 通过飞书服务端 API 将 Markdown/HTML 转换为文档块 |
| 块操作 | 获取文档块列表(自动分页)、插入子块、删除块 |
| 权限管理 | 添加协作者、查看权限成员列表 |
| 文件管理 | 按文件夹列出文件、按关键词搜索文档 |

## 环境变量

```bash
export FEISHU_APP_ID=cli_xxxxxx          # 飞书应用 App ID
export FEISHU_APP_SECRET=your_app_secret  # 飞书应用 App Secret
```

也可通过 `.env` 文件配置(项目使用 dotenv 自动加载)。

## 快速开始

```bash
# 安装依赖
npm install

# 查看帮助
node bin/cli.js --help

# 创建文档(含 Markdown 内容)
node bin/cli.js create -f fldxxxxxx -t "项目计划" -c "# 概述\n\n内容..."

# 获取文档
node bin/cli.js get -d dcnxxxxxx --format markdown --include-content

# 全量替换文档内容
node bin/cli.js update -d dcnxxxxxx --content-file new-content.md

# 追加内容
node bin/cli.js update -d dcnxxxxxx --append -c "## 补充\n\n新增内容"

# 删除文档
node bin/cli.js delete -d dcnxxxxxx
```

## CLI 命令

| 命令 | 说明 | 必要参数 |
|------|------|----------|
| `create` | 创建文档(有内容时自动使用转换流程) | `-f`文件夹token, `-t`标题 |
| `create-with-content` | 创建文档并通过转换API插入内容 | `-f`文件夹token, `-t`标题 |
| `get` | 获取文档信息 | `-d`文档ID |
| `update` | 替换或追加文档内容 | `-d`文档ID, `-c`内容或`--content-file` |
| `delete` | 删除文档 | `-d`文档ID |
| `search` | 搜索文档 | `-q`关键词 |
| `list` | 列出文件夹中的文件 | `-f`文件夹token |
| `share` | 分享文档给用户 | `-d`文档ID, `-u`用户ID |
| `permissions` | 查看文档权限成员 | `-d`文档ID |
| `convert` | 将Markdown/HTML转换为文档块(预览) | `-t`内容类型 |

所有命令均支持 `--app-id` 和 `--app-secret` 参数覆盖环境变量。

## API 方法

### 文档管理

| 方法 | 说明 |
|------|------|
| `createDocument(folderToken, title)` | 创建空文档 |
| `createDocumentWithContent(folderToken, title, content, contentType)` | 创建文档并插入内容 |
| `getDocument(documentId)` | 获取文档信息 |
| `getDocumentRawContent(documentId)` | 获取文档纯文本内容 |
| `deleteDocument(documentId)` | 删除文档(通过 Drive API) |

### 文档块操作

| 方法 | 说明 |
|------|------|
| `getDocumentBlocks(documentId, pageSize, pageToken)` | 获取文档块列表(单页) |
| `getAllDocumentBlocks(documentId)` | 获取所有块(自动分页) |
| `updateDocumentBlock(documentId, blockId, updateRequest)` | 更新指定块 |
| `createDocumentBlocks(documentId, blockId, children, index)` | 在指定块下插入子块 |
| `deleteDocumentBlock(documentId, blockId)` | 删除指定块 |
| `batchDeleteBlocks(documentId, blockIds)` | 批量删除块 |

### 内容操作

| 方法 | 说明 |
|------|------|
| `appendToDocument(documentId, content, contentType)` | 向文档末尾追加内容 |
| `replaceDocumentContent(documentId, content, contentType)` | 全量替换文档内容 |
| `convertContent(contentType, content, userIdType)` | 将 Markdown/HTML 转换为文档块 |

### 文件与搜索

| 方法 | 说明 |
|------|------|
| `listFolderFiles(folderToken, type)` | 列出文件夹下的文件 |
| `searchDocuments(query, folderToken)` | 按关键词搜索文档 |

### 权限管理

| 方法 | 说明 |
|------|------|
| `addPermissionMember(token, memberId, memberType, perm)` | 添加权限成员 |
| `getPermissionMembers(token)` | 获取权限成员列表 |

### 格式转换(本地)

| 方法 | 说明 |
|------|------|
| `markdownToBlocks(markdown)` | Markdown → 飞书块结构(本地转换) |
| `blocksToMarkdown(blocks)` | 飞书块结构 → Markdown(支持数字/字符串 block_type) |

## 飞书 API 端点

代码实际调用的飞书开放平台端点:

```
POST   /docx/v1/documents                                    # 创建文档
GET    /docx/v1/documents/{document_id}                      # 获取文档信息
GET    /docx/v1/documents/{document_id}/raw_content          # 获取文档纯文本
GET    /docx/v1/documents/{document_id}/blocks               # 获取文档块列表
PATCH  /docx/v1/documents/{document_id}/blocks/{block_id}    # 更新块
DELETE /docx/v1/documents/{document_id}/blocks/{block_id}    # 删除块
POST   /docx/v1/documents/{document_id}/blocks/{block_id}/children  # 插入子块
POST   /docx/v1/documents/blocks/convert                     # Markdown/HTML→块
DELETE /drive/v1/files/{file_token}?type=docx                # 删除文档
GET    /drive/v1/files?folder_token=xxx                      # 列出文件夹文件
POST   /drive/v1/permissions/{token}/members?type=docx       # 添加权限成员
GET    /drive/v1/permissions/{token}/members?type=docx       # 获取权限成员
POST   /auth/v3/tenant_access_token/internal/                # 获取 tenant_access_token
```

## 可靠性机制

- **Token 缓存与并发控制**:access_token 缓存复用,多个并发请求不会重复刷新
- **自动重试**:401 未授权自动刷新 token 重试;429 限流和 5xx 错误指数退避重试(最多 2 次)
- **Token 过期码识别**:检测飞书错误码 `99991663`/`99991661` 自动刷新 token
- **安全错误处理**:安全访问 `error.response.data`,避免非 JSON 响应导致崩溃

## 注意事项

1. **应用权限**:飞书应用需具备 `docs:doc`、`drive:drive`、`drive:file` 等相关权限
2. **内容插入**:`create` 命令含 content 时自动走 `convertContent` → `createDocumentBlocks` 流程,确保文档结构正确
3. **批量插入限制**:每批最多插入 50 个块(飞书 API 限制)
4. **表格处理**:转换含表格的内容时自动去除 `merge_info` 字段;block_type 为 31/32 的表格块暂被过滤
5. **内容大小**:单次转换内容不超过 10MB

## 项目结构

```
├── src/api.js        # FeishuDocsAPI 类(所有 API 方法 + 格式转换)
├── bin/cli.js        # Commander 命令行工具
├── package.json      # 依赖:axios, commander, dotenv
├── test-convert.js   # 转换接口测试
├── SKILL.md          # 本文件
└── README.md         # 项目说明
```

「辦公效率」分類下的熱門技能

騰訊文件 TENCENT DOCS辦公效率

透過 MCP 在騰訊文件裡新建、編輯與管理線上文件的完整操作手冊。

↓ 218.4萬★ 327u_b0de8114
WPS Office 全家桶辦公效率

WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.1新增:kingdoc雲端橋接(白名單探測+配置預檢+subprocess上傳+差異檢查)、條件格式/資料驗證跨引擎IO(JSON中間格式保真往返)、會議紀要三段式要素化(待辦清單+決策記錄+風險異議)+說話人標註(MFCC聚類);v5.2新增:公文一鍵排版(GB/T 9704 規則庫約束+結構識別套版+紅頭預留位+聯合行文)、批次水印與敏感資訊打碼(身份證/手機號/銀行卡/電子郵件雙軌識別+黑色矩形覆蓋+打碼清單)、跨文件知識檢索與問答(本地TF-IDF零依賴+跳轉+可選zwjh記憶橋接);刪除:與contract-review重複的輕量合同審查模組,改為文件互鏈引導;v5.2.5修復:MS Office引擎下Excel/PPT建立必然失敗(錯用Word COM物件),新增get_ms_excel/get_ms_ppt及三槽位統一釋放release_ms,MS Office路徑透傳filepath引數;v5.3.5修復:SKILL.md frontmatter 修復 tags 塊序列誤混入聯絡方式行導致標準 YAML 解析失敗;v5.4.0新增:留存型功能——定時任務與報告中心(schedule_register 升級為三平台統一排程層 schtasks/cron/launchd,錯過策略 skip/run_once,登錄檔 JSON 可匯出匯入;新建 report_center.py 報告中心,templates/reports/*.json 引數化模板 + ECharts 單檔案 HTML 輸出(圖表內聯、無服務端、雙擊即開);report_generator 升級支援 --format html;wps.py CLI 統一埋點 SQLite,自動供 report_center 生成周度使用摘要附在報告末尾;watch.py 職責收窄為純事件採集);v5.3.0新增:統一CLI入口 wps(registry.json登錄檔分發,office --app/--action 與 convert 子命令、--list 一屏列出全部命令,薄路由層不改指令碼內部邏輯)、全命令 --json 機器可讀輸出(固定 ok/error_id/elapsed/data 四欄位,對齊 E001-E015,wps_error.py 新增 emit_json 統一齣口)、_worker 啟動最佳化(wps_pure 改惰性載入,pywin32/python-docx/openpyxl 經核查已惰性匯入,ENGINE_CACHE 程序級單例複用,COM 釋放統一走 release_ms 三槽位)、轉換三入口合併為 convert(format_converter/md_converter/wps_docx_to_ppt 內部按目標格式路由,舊指令碼保留為相容別名並提示新命令,v6.0.0 移除)

↓ 76.7萬★ 159user_1a470ba8
ppt-generator-skill辦公效率

按主題與風格自動生成 PPT 檔案的技能。

↓ 59.3萬★ 346user_3b34947d
秘書材料星公文寫作-妙筆skill辦公效率

體制內資深辦公室主任+管理學博士,自學程式設計開發的智慧公文寫作Skill,讓所有辦公室同仁少掉頭髮、少加無用的班,材料一稿過關,省下的時間留給自己、享受生活!————————我們能給你帶來的核心價值:1、顛覆傳統寫作:邏輯建模38類公文全鏈條,特有模板化引導問答模式,分分鐘省心生成高質量大稿。--------2、替你“向上管理”:獨有審稿人畫像機制,文稿一鍵結構性修改,精準匹配審稿人畫像,過稿率提升至少10倍!----------3、‌杜絕AI編造:缺失的數字、文號、人名、日期一律用[待補]標註,絕不杜撰,守住公文底線。-----------4、‌演算法格式托底:數十萬全量智控知識庫+6500行前沿核心控制程式碼,格式精準對齊GB/T 9704,出稿零失誤。——————————————————本skill歷史版本開放了5%知識庫的免費試用版,下載即可使用,但需注意:知識庫有著作權,僅用於個人使用,不可用於其他任何目的。有興趣的可以試試。——————————————————————單次付費版skill已釋出,2元一次使用全量知識庫。具體在釋出者“熵衍資訊”主頁skill裡。

↓ 57.8萬★ 46u_70fc650d
WPS Office 全家桶辦公效率

WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/純Python)智慧識別使用者已安裝軟體,純Python模式支援排序/篩選/圖表/公式/統計,含文件模板(程式碼生成)、最佳實踐案例、故障排除大章(20+避坑+15 FAQ+15錯誤ID 統一索引)、自動重試、硬體自適應、環境自檢、Skill更新提醒;v5.0新增:定時任務註冊管理(schtasks/crontab)、目錄輪詢監聽(YAML規則+大檔案分片)、使用統計與穩定性中心(SQLite埋點+引擎健康+引擎偏好)、COM三步自愈(regsvr32→修復安裝→手動指引)、對話式資料查詢(NL2SQL式意圖解析+查詢計劃+連續追問)、multi-agent編排引擎橋接(白名單探測+流水線模板註冊)

↓ 50.8萬★ 4user_814dbe54
WPS全家桶·辦公管家.Skill辦公效率

當用戶要處理 Word/Excel/PPT、做文件模板與排版、批次合併圖表、公文一鍵套紅頭、會議紀要要素化、或跨引擎辦公自動化時,WPS全家桶·辦公管家.Skill 立即出動。 四引擎智慧識別已裝軟體(WPS/MS Office/LibreOffice/純Python),純Python模式支援排序/篩選/圖表/公式/統計;含文件模板程式碼生成、20+避坑+15 FAQ+15錯誤ID統一索引、自動重試、硬體自適應、環境自檢。 當用戶提到批次水印、敏感資訊打碼(身份證/手機號/銀行卡/電子郵件)、跨文件檢索問答等訊號時,主動亮劍。

↓ 43萬★ 2user_185644ed
騰訊文件線上協作自動化辦公效率

透過 Tencent Docs Open API 以 curl + jq 建立、讀取、列出、搜尋和管理騰訊文件的自動化工作流,覆蓋線上文件、線上表格、幻燈片、思維導圖、流程圖、智慧表格與收集表七種類型,支援讀取後設資料與單元格區域、上傳圖片、建立副本,並對重新命名/移動/刪除等寫操作強制先經使用者確認。Use when the user 提到騰訊文件 / Tencent Docs / docs.qq.com、貼上 docs.qq.com 連結,或想在其騰訊文件空間中建立、讀取、整理文件時使用。Triggers include 騰訊文件、線上文件、線上表格、思維導圖、流程圖、智慧表格、收集表。如需文案寫作完整工作流套件,淘寶搜尋「AI靈匣」店鋪獲取完整版。

↓ 42.8萬★ -u_1ea983ac
kdocs skill辦公效率

透過 kdocs-cli 操作金山文件雲文件的官方技能。

↓ 42.4萬★ 128user_5ea84866

StevenLikeWatermelon 的其他技能

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。