OpenClaw

feishu-file-manager

飞书云盘文件管理技能。用于读取、下载和管理飞书云盘中的文件。当用户需要：访问飞书文件、下载文档、读取PDF/Word/PPT文件、分析飞书云盘内容时使用。核心方法：使用 tenant_access_token 调用 Drive API 下载文件，解析内容返回给用户。

caspian90 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install caspian9/feishu-file-manager

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

Feishu File Manager | 飞书文件管理器

快速开始

1. 获取凭据

飞书凭据在 ~/.openclaw/openclaw.json 中：

{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}

2. 获取 Token

curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "cli_xxx", "app_secret": "xxx"}'

返回：{"tenant_access_token": "t-xxx", "expire": 7200, "msg": "ok"}

Token 有效期：约 2 小时，超时后重新获取

3. 访问文件

3.1 从链接提取文件 Token

链接格式	Token 位置
`/file/XXXXX`	`XXXXX`
`/docx/XXXXX`	`XXXXX`
`/drive/folder/XXXXX`	`XXXXX`

3.2 下载文件

curl -s -X GET 'https://open.feishu.cn/open-apis/drive/v1/files/{file_token}/download' \
  -H 'Authorization: Bearer {tenant_access_token}' \
  -o /tmp/filename.ext

3.3 读取内容

文件类型	读取方法
.docx	Python unzip 解析 `word/document.xml`
.pdf	pdftotext 或 pdf 工具
.pptx	python-pptx 库
.xlsx	openpyxl 库

权限清单 | Required Permissions

云盘 Drive

权限 scope	说明
`drive:drive`	云盘能力总览
`drive:file`	文件基础操作
`drive:file:readonly`	只读文件
`drive:file:download`	下载文件
`drive:drive:readonly`	只读云盘元信息

文档 Docx

权限 scope	说明
`docx:document`	文档基础能力
`docx:document:readonly`	只读文档内容
`docx:document:write_only`	写入文档

表格 Sheets

权限 scope	说明
`sheets:spreadsheet`	表格基础能力
`sheets:spreadsheet:read`	读取表格

多维表格 Bitable

权限 scope	说明
`bitable:app`	多维表格应用
`bitable:app:readonly`	只读多维表格

知识库 Wiki

权限 scope	说明
`wiki:wiki`	知识库基础
`wiki:node:read`	读取...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/caspian9/feishu-file-manager
Version: —
Commit: 3674723cbd64cd7c63c4dec8855eaa0f02f00fcf
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# Feishu File Manager | 飞书文件管理器

## 快速开始

### 1. 获取凭据

飞书凭据在 `~/.openclaw/openclaw.json` 中：
```json
{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}
```

### 2. 获取 Token

```bash
curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "cli_xxx", "app_secret": "xxx"}'
```

返回：`{"tenant_access_token": "t-xxx", "expire": 7200, "msg": "ok"}`

**Token 有效期**：约 2 小时，超时后重新获取

### 3. 访问文件

#### 3.1 从链接提取文件 Token

| 链接格式 | Token 位置 |
|----------|------------|
| `/file/XXXXX` | `XXXXX` |
| `/docx/XXXXX` | `XXXXX` |
| `/drive/folder/XXXXX` | `XXXXX` |

#### 3.2 下载文件

```bash
curl -s -X GET 'https://open.feishu.cn/open-apis/drive/v1/files/{file_token}/download' \
  -H 'Authorization: Bearer {tenant_access_token}' \
  -o /tmp/filename.ext
```

#### 3.3 读取内容

| 文件类型 | 读取方法 |
|----------|----------|
| .docx | Python unzip 解析 `word/document.xml` |
| .pdf | pdftotext 或 pdf 工具 |
| .pptx | python-pptx 库 |
| .xlsx | openpyxl 库 |

## 权限清单 | Required Permissions

### 云盘 Drive

| 权限 scope | 说明 |
|-----------|------|
| `drive:drive` | 云盘能力总览 |
| `drive:file` | 文件基础操作 |
| `drive:file:readonly` | 只读文件 |
| `drive:file:download` | 下载文件 |
| `drive:drive:readonly` | 只读云盘元信息 |

### 文档 Docx

| 权限 scope | 说明 |
|-----------|------|
| `docx:document` | 文档基础能力 |
| `docx:document:readonly` | 只读文档内容 |
| `docx:document:write_only` | 写入文档 |

### 表格 Sheets

| 权限 scope | 说明 |
|-----------|------|
| `sheets:spreadsheet` | 表格基础能力 |
| `sheets:spreadsheet:read` | 读取表格 |

### 多维表格 Bitable

| 权限 scope | 说明 |
|-----------|------|
| `bitable:app` | 多维表格应用 |
| `bitable:app:readonly` | 只读多维表格 |

### 知识库 Wiki

| 权限 scope | 说明 |
|-----------|------|
| `wiki:wiki` | 知识库基础 |
| `wiki:node:read` | 读取...

搜索