← Back to Skills Marketplace
1317
Downloads
3
Stars
5
Active Installs
4
Versions
Install in OpenClaw
/install feishu-docs-v2
Description
飞书文档管理工具，支持读取、创建、更新、删除飞书文档，导入本地文件为飞书文档，以及列出文件夹内容。用于在 Claude Code 中管理飞书云文档。
README (SKILL.md)
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
获取应用凭证
- 访问 https://open.feishu.cn/app
- 创建企业自建应用
- 在"凭证与基础信息"中获取 App ID 和 App Secret
- 在"权限管理"中添加以下权限：
docx:document- 查看、编辑、创建文档drive:drive- 查看、删除云空间文件drive:file- 上传文件drive:importTask- 导入文件为文档auth:tenant- 获取租户访问凭证
使用方式
读取文档
# 读取文档内容（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
创建文档
# 创建空文档
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档"
# 从文件创建文档（自动转换 Markdown）
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档" --file content.md
导入本地文件
# 导入 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
列出文件夹
# 列出根目录
node scripts/index.js list
# 列出指定文件夹
node scripts/index.js list --folder-token foldxxxxxxxxxxxxxx
更新文档
# 覆盖文档内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --file new-content.md
# 追加内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --content "追加的文本" --append
删除文档
# 删除文档（需要 --force 确认）
node scripts/index.js delete -d doccxxxxxxxxxxxxxx --force
注意事项
- 所有命令都需要先配置
.env文件中的环境变量 - 文档 token 以
docc开头，文件夹 token 以fold开头 - 导入大文件时需要等待转换完成，脚本会自动轮询任务状态
- 创建文档时，文档信息会保存到
doc-{documentId}.json文件中
Usage Guidance
This skill appears to implement a legitimate Feishu Docs CLI and asks for the expected App ID and App Secret. Before installing: 1) Verify the package/source (SKILL.md references a GitHub repo but the registry metadata omitted a homepage) to avoid malicious forks; 2) Only grant the app the minimum necessary tenant permissions and use a dedicated, limited-scope Feishu self-built app (do not reuse highly privileged or personal credentials); 3) Be aware the tool can read any local file you pass to its commands and will upload it to Feishu — do not pass sensitive local files unless you intend them to be uploaded; 4) Review the included scripts/index.js yourself (or have an engineer do so) if you need higher assurance, since the skill will execute Node code locally when invoked.
Capability Analysis
Type: OpenClaw Skill
Name: feishu-docs-v2
Version: 0.1.3
The OpenClaw AgentSkills skill bundle for Feishu document management appears benign. Its functionality, including reading/writing local files for document content and metadata, and interacting with the Feishu API, is entirely consistent with its stated purpose. The skill correctly uses environment variables for API authentication, and there is no evidence of unauthorized data exfiltration, shell injection vulnerabilities, persistence mechanisms, or prompt injection attempts in the documentation. The required Feishu API permissions, while broad, are necessary for the comprehensive document management features offered.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, README, package.json, and scripts/index.js consistently implement a Feishu (飞书) document management CLI. Required env vars (FEISHU_APP_ID, FEISHU_APP_SECRET) and node binary are appropriate. Minor metadata inconsistency: registry metadata lists source/homepage as unknown/none while SKILL.md and README reference a GitHub URL (https://github.com/upupc/feishu-docs); confirm the package origin before use.
Instruction Scope
Runtime instructions and code stay within scope: they read local files the user specifies, upload files to Feishu, create/import/update/delete docs, and write local output files (e.g., doc-{id}.json). No instructions request unrelated system files, extra environment variables, or transmit data to unexpected external endpoints beyond the Feishu/Open API domain.
Install Mechanism
No install spec is provided (instruction-only install), and the code is Node.js-based with standard dependencies (@larksuiteoapi/node-sdk, commander, dotenv). There are no downloads from arbitrary URLs or extracted archives in the skill manifest. Node is required to run the included scripts.
Credentials
Only FEISHU_APP_ID and FEISHU_APP_SECRET (and optional FEISHU_DOMAIN) are required, which is proportional for a self-built Feishu app integration. The README and SKILL.md clearly list the high-scope permissions the app needs (docx:document, drive:drive, drive:file, drive:importTask, auth:tenant) — these are necessary for the declared features but grant broad access to documents and files, so limit usage to trusted apps/accounts.
Persistence & Privilege
The skill does not request permanent platform-wide presence (always is false) and does not modify other skills or global agent config. It reads/writes files only in the working directory as part of its CLI behavior and requires explicit invocation to run.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-docs-v2 - After installation, invoke the skill by name or use
/feishu-docs-v2 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Version 0.1.3
- No changes detected in the current release.
- All features, documentation, and configuration instructions remain the same as the previous version.
v0.1.2
feishu-docs-v2 0.1.2
- Initial release of the v2 skill version.
- Added README.md, package.json, and scripts/index.js.
v0.1.1
- Initial release of the 飞书文档管理工具 skill for Claude Code.
- 支持读取、创建、更新、删除飞书文档，及从本地文件导入为飞书文档。
- 提供列出文件夹内容和获取文档结构化数据的命令。
- 支持多种文档格式（如 Markdown、docx、xlsx、csv 等）的导入与读取。
- 详细的环境变量配置、权限申请和命令行用法说明。
v0.1.0
Initial release of Feishu Docs skill for document management.
- Provides CLI tools to read, create, update, and delete Feishu cloud documents.
- Supports importing local files (txt, docx, xlsx, csv, md) as Feishu documents.
- Allows listing folder contents and fetching document structure data.
- Requires configuration of Feishu App credentials via environment variables.
- Includes detailed usage instructions and permission setup guidance.
Metadata
Frequently Asked Questions
What is Feishu Docs?
飞书文档管理工具，支持读取、创建、更新、删除飞书文档，导入本地文件为飞书文档，以及列出文件夹内容。用于在 Claude Code 中管理飞书云文档。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1317 downloads so far.
How do I install Feishu Docs?
Run "/install feishu-docs-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Feishu Docs free?
Yes, Feishu Docs is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Feishu Docs support?
Feishu Docs is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Feishu Docs?
It is built and maintained by upupc (@upupc); the current version is v0.1.3.
More Skills