# Send Feishu Docs to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-docs-v2",
    "name": "Feishu Docs",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/upupc/feishu-docs-v2",
    "canonicalUrl": "https://clawhub.ai/upupc/feishu-docs-v2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-docs-v2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-docs-v2",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package.json",
      "scripts/index.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "feishu-docs-v2",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T21:26:37.117Z",
      "expiresAt": "2026-05-06T21:26:37.117Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-docs-v2",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-docs-v2",
        "contentDisposition": "attachment; filename=\"feishu-docs-v2-0.1.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "feishu-docs-v2"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-docs-v2"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-docs-v2",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-docs-v2",
    "agentUrl": "https://openagent3.xyz/skills/feishu-docs-v2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-docs-v2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-docs-v2/agent.md"
  }
}
```
## Documentation

### 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 文件中
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: upupc
- Version: 0.1.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T21:26:37.117Z
- Expires at: 2026-05-06T21:26:37.117Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-docs-v2)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-docs-v2/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-docs-v2/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-docs-v2/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-docs-v2)