upupc

Feishu Docs

Officev0.1.3
By upupcUpdated 2026-05-114 versions · latest released 2026-02-17feishu-docs-v2@clawhub_upupc/feishu-docs-v2
Documents#Docs#Feishu#文档#飞书

According to AlphaMoat, as of 2026-09, Feishu Docs has 2,569 downloads and 4 stars — ranked #4,042 of 5,078 AI skills overall, and #304 of 435 in Office.

Installs
234
Downloads
2.6K
Stars
4
Overall Rank
#4,042
Top 80% overall · Top 70% in Office
PlatformInstallsDownloadsStarsComments
ClawHub ↗682.2K3-
SkillHub ↗2342.6K4—

Platforms count differently and update at different times.

What this skill does

This skill wraps a Node.js CLI for managing Feishu cloud documents: get (read content as JSON/Markdown/Text), get-blocks (structured block data), create (optionally from a file), import-file (convert local txt/docx/xlsx/csv/md into Feishu documents), list folders, update (overwrite or append), and delete (requires --force confirmation). It requires FEISHU_APP_ID/FEISHU_APP_SECRET in .env, a custom enterprise app on the Feishu Open Platform with docx:document, drive:drive, and related permissions, and it polls conversion-task status automatically for large file imports.

Profile published 2026-10-27

What you can do with it

  • Read a Feishu document and save it as a Markdown file
  • Create/import Feishu documents or sheets from local Markdown or CSV files
  • List folder contents, append updates, or delete documents with confirmation

When to use it

  • When managing Feishu cloud documents from Claude Code or similar agent environments
  • When local files (md/docx/csv, etc.) must be imported as Feishu documents
  • When bulk-reading, updating, or organizing Feishu knowledge-base documents

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Read this weekly report (token starts with docc) and export it as Markdown
Import local data.csv as a Feishu sheet
Append a supplementary note to the end of this requirements document

Monthly Trend

Downloads2.6K
1.3K2.0K2.7K2026-03 · Downloads 1.4K2026-05 · Downloads 1.7K2026-06 · Downloads 1.8K2026-07 · Downloads 2.0K2026-08 · Downloads 2.3K2026-09 · Downloads 2.6K26-0326-09
Stars4
3442026-03 · Stars 32026-05 · Stars 32026-06 · Stars 32026-07 · Stars 42026-08 · Stars 42026-09 · Stars 426-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-092.6K—4
2026-082.3K+10.7%4
2026-072.0K+11.0%4
2026-061.8K+7.6%3
2026-051.7K—3
2026-031.4K—3

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.3 KB · ClawHub v0.1.3
---
name: feishu-docs
description: 飞书文档管理工具,支持读取、创建、更新、删除飞书文档,导入本地文件为飞书文档,以及列出文件夹内容。用于在 Claude Code 中管理飞书云文档。
license: MIT
metadata:
  author: feishu-docs
  version: "1.0.0"
  openclaw:
     requires:
        env:
Show all (122 lines)
           - FEISHU_APP_ID
           - FEISHU_APP_SECRET
        bins:
           - node
     homepage: https://github.com/upupc/feishu-docs
---

# Feishu Docs Skill

用于管理飞书云文档的 CLI 工具封装 skill。

## 功能

- **get** - 读取飞书文档内容(支持 JSON/Markdown/Text 格式)
- **get-blocks** - 获取文档块结构化数据
- **create** - 创建新文档(支持从文件导入内容)
- **import-file** - 将本地文件导入为飞书文档(支持 txt, docx, xlsx, csv, md 等)
- **list** - 列出文件夹内容
- **delete** - 删除文档
- **update** - 更新文档内容(覆盖或追加模式)

## 环境配置

需要在 `.env` 文件中配置以下环境变量:

```
FEISHU_APP_ID=cli_xxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxx
FEISHU_DOMAIN=https://open.feishu.cn
```

### 获取应用凭证

1. 访问 https://open.feishu.cn/app
2. 创建企业自建应用
3. 在"凭证与基础信息"中获取 App ID 和 App Secret
4. 在"权限管理"中添加以下权限:
   - `docx:document` - 查看、编辑、创建文档
   - `drive:drive` - 查看、删除云空间文件
   - `drive:file` - 上传文件
   - `drive:importTask` - 导入文件为文档
   - `auth:tenant` - 获取租户访问凭证

## 使用方式

### 读取文档

```bash
# 读取文档内容(JSON 格式)
node scripts/index.js get -d doccxxxxxxxxxxxxxx

# 读取并保存为 Markdown
node scripts/index.js get -d doccxxxxxxxxxxxxxx -o output.md --format markdown

# 获取文档块结构
node scripts/index.js get-blocks -d doccxxxxxxxxxxxxxx -o blocks.json
```

### 创建文档

```bash
# 创建空文档
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档"

# 从文件创建文档(自动转换 Markdown)
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档" --file content.md
```

### 导入本地文件

```bash
# 导入 Markdown 文件为飞书文档
node scripts/index.js import-file -f ./document.md --folder-token foldxxxxxxxxxxxxxx --type docx --ext md

# 导入为表格
node scripts/index.js import-file -f ./data.csv --folder-token foldxxxxxxxxxxxxxx --type sheet --ext csv
```

### 列出文件夹

```bash
# 列出根目录
node scripts/index.js list

# 列出指定文件夹
node scripts/index.js list --folder-token foldxxxxxxxxxxxxxx
```

### 更新文档

```bash
# 覆盖文档内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --file new-content.md

# 追加内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --content "追加的文本" --append
```

### 删除文档

```bash
# 删除文档(需要 --force 确认)
node scripts/index.js delete -d doccxxxxxxxxxxxxxx --force
```

## 注意事项

1. 所有命令都需要先配置 `.env` 文件中的环境变量
2. 文档 token 以 `docc` 开头,文件夹 token 以 `fold` 开头
3. 导入大文件时需要等待转换完成,脚本会自动轮询任务状态
4. 创建文档时,文档信息会保存到 `doc-{documentId}.json` 文件中

Popular in Office

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.