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/tenantaccesstoken/internal \
-H Content-Type: application/json \
-d {appid: clixxx, app_secret: xxx}

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

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

3. 访问文件

3.1 从链接提取文件 Token

3.2 下载文件

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

3.3 读取内容

权限清单 | Required Permissions

云盘 Drive

文档 Docx

表格 Sheets

多维表格 Bitable

知识库 Wiki

验证方法 | Validation

验证 Token 有效性

bash
curl -s https://open.feishu.cn/open-apis/auth/v3/tenantaccesstoken/internal \
-H Content-Type: application/json \
-d {appid: clixxx, app_secret: xxx}

• - 返回 {msg: ok} = 有效
• 返回 {msg: invalid appid or appsecret} = 无效

验证文件访问权限

bash
curl -s https://open.feishu.cn/open-apis/drive/v1/files/{file_token} \
-H Authorization: Bearer {token}

• - 返回文件信息 = 有权限
• 返回 {code: 99, msg: file not found} = 无权限或文件不存在

验证文件夹访问

bash
curl -s https://open.feishu.cn/open-apis/drive/v1/files?parentnode={foldertoken} \
-H Authorization: Bearer {token}

• - 返回文件列表 = 有权限
• 返回空列表可能无权限或文件夹为空

错误处理 | Error Handling

文件读取示例

Python 读取 DOCX

python
from zipfile import ZipFile
import re

def read_docx(filepath):
with ZipFile(filepath) as z:
with z.open(word/document.xml) as f:
content = f.read().decode(utf-8)
text = re.sub(r<[^>]+>, , content)
return .join(text.split())

读取 PDF

bash
pdftotext file.pdf - | head -100

读取 PPTX

python
from pptx import Presentation

def read_pptx(filepath):
prs = Presentation(filepath)
text = []
for slide in prs.slides:
for shape in slide.shapes:
if hasattr(shape, text):
text.append(shape.text)
return \n.join(text)

工作流总结

1. 1. 获取/刷新 token → 调用 auth API
2. 提取文件 token → 从飞书链接解析
3. 下载文件 → 调用 drive API
4. 解析内容 → 根据文件类型选择解析方法
5. 返回结果 → 给用户

注意事项

• - Token 有时效性（约2小时），长时间操作需刷新
• 文件必须分享给机器人才能访问
• 即使文件夹可访问，未分享的文件仍会返回 404
• 大文件建议先检查文件大小：curl -I .../download 获取 Content-Length