飞书云空间用久了,都会遇到同一个问题:
文件越堆越多,目录越来越乱,找东西靠搜索,权限靠手动加,每次有新人入职或项目启动,光整理文件就要花半天。
这篇文章教你用 OpenClaw 的 lark-drive 技能,把云空间的文件管理全部自动化------批量上传、自动归类、权限管理,一条指令搞定。

一、lark-drive 能做什么
lark-drive 是 OpenClaw 操作飞书云空间的核心技能,覆盖文件的完整生命周期。
| 操作类型 | 能做什么 |
|---|---|
| 文件上传 | 把本地文件上传到指定文件夹 |
| 文件下载 | 把云空间文件下载到本地 |
| 文件管理 | 复制、移动、删除、重命名 |
| 目录管理 | 创建文件夹、查询目录结构 |
| 权限管理 | 添加/移除协作者、设置访问权限 |
| 元数据查询 | 批量获取文件信息(类型、大小、修改时间) |
边界条件:lark-drive 操作的是飞书云空间(Drive),不是本地文件系统。上传前文件需要在本地存在;下载后文件保存到本地指定路径。
二、核心操作:文件上传与目录管理
上传文件到指定文件夹
# 上传单个文件
lark-cli drive files upload \
--params '{"parent_type":"explorer","parent_node":"your_folder_token"}' \
--file "/path/to/your/file.pdf" \
--as user
# 查询文件夹 token(先找到目标文件夹)
lark-cli drive explorer list \
--params '{"folder_token":"your_folder_token","page_size":50}' \
--as user
文件夹 token 从飞书云空间 URL 里取:https://xxx.feishu.cn/drive/folder/fldcnXXXXXX,其中 fldcnXXXXXX 就是 folder_token。
创建文件夹
# 在指定位置新建文件夹
lark-cli drive files create_folder \
--params '{"name":"2026-04 项目资料","folder_token":"parent_folder_token"}' \
--as user
复制和移动文件
# 复制文件到另一个文件夹
lark-cli drive files copy \
--params '{"file_token":"your_file_token","type":"file","name":"副本名称","folder_token":"target_folder_token"}' \
--as user
# 移动文件(先复制,再删除原文件)
lark-cli drive files move \
--params '{"file_token":"your_file_token","type":"file","folder_token":"target_folder_token"}' \
--as user
三、权限管理:精确控制谁能看、谁能改
添加协作者
# 给指定用户添加文件权限
lark-cli drive permission.members create \
--params '{
"token":"your_file_token",
"type":"file",
"member_type":"userid",
"member_id":"user_open_id",
"perm":"view"
}' \
--as user
# perm 可选值:
# view - 只读
# edit - 可编辑
# full_access - 完全控制
查询当前权限列表
# 查看文件的所有协作者
lark-cli drive permission.members list \
--params '{"token":"your_file_token","type":"file"}' \
--as user
移除协作者
lark-cli drive permission.members delete \
--params '{
"token":"your_file_token",
"type":"file",
"member_type":"userid",
"member_id":"user_open_id"
}' \
--as user
四、批量查询文件元数据
当你需要整理大量文件时,先批量获取文件信息,再决定怎么处理:
# 批量查询多个文件的元数据
lark-cli drive metas batch_query \
--params '{
"request_docs":[
{"doc_token":"token1","doc_type":"file"},
{"doc_token":"token2","doc_type":"docx"}
]
}' \
--as user
返回内容包含:文件名、类型、大小、创建时间、最后修改时间、所有者。这些信息是自动归类的基础。
五、实战场景:让 OpenClaw 直接帮你跑
场景一:项目启动时自动建目录
在飞书对话框发送:
帮我在云空间的「项目文件」文件夹下,新建一个「2026-04 品牌升级项目」目录,
里面创建以下子文件夹:01-需求文档、02-设计稿、03-会议纪要、04-交付物。
OpenClaw 会自动调用 drive files create_folder 逐级创建目录结构。
场景二:批量上传本地文件
把我桌面上「品牌升级」文件夹里的所有 PDF 文件,
上传到飞书云空间的「2026-04 品牌升级项目/01-需求文档」目录下。
场景三:新人入职权限批量配置
新同事小李(open_id: ou_xxxxx)加入了设计团队,
帮我把「设计资产库」文件夹的编辑权限加给他,
同时把「财务报表」文件夹的权限设为只读。
场景四:定期清理过期文件(配合 HEARTBEAT)
在 HEARTBEAT.md 里加一条定时任务:
## 每月1日 09:00 执行
- 查询「临时文件」文件夹下超过30天未修改的文件
- 列出清单发到飞书消息,等待确认后移动到「归档」文件夹
六、进阶:文件搜索与自动归类
lark-drive 配合 lark-doc 的搜索能力,可以实现更智能的文件管理:
# 搜索云空间中的文件
lark-cli docs +search \
--query "品牌升级" \
--count 20 \
--as user
搜索结果返回文件 token 和类型,再用 drive files move 批量归类。
典型工作流:
-
用
docs +search按关键词找到散落的文件 -
用
drive metas batch_query获取文件详情 -
让 AI 判断每个文件应该归入哪个目录
-
用
drive files move批量移动
我的体感 & 行动
以前我的飞书云空间是"能用就行"的状态------文件随手扔,目录靠感觉,权限靠记忆。
用 lark-drive 接管之后,最大的变化是**文件管理从"被动响应"变成了"主动维护"**。项目启动时自动建目录,新人入职时自动配权限,月底自动清理临时文件------这些事情以前都是"知道该做但总是忘",现在直接交给 OpenClaw 定时跑。
我接下来打算做的事:把公司所有项目的目录模板固化下来,让 OpenClaw 在每次新建项目时自动套用,同时把权限配置也模板化,按角色批量授权。
行动清单
| 动作 | 验证标准 |
|---|---|
用 drive explorer list 查询一个文件夹的内容,确认能拿到文件列表 |
成功返回文件列表和 token |
用 drive files upload 上传一个测试文件 |
文件出现在飞书云空间指定位置 |
用 drive permission.members create 给一个文件添加协作者 |
对方收到权限通知 |
| 在 HEARTBEAT.md 配置一个月度文件整理任务 | 下月1日自动执行并有输出 |
下篇预告
第17篇:飞书全家桶联动实战:多技能协同编排,搭建你的AI办公工作流
单个技能能做的事有限,真正的威力在于多技能协同。下篇教你把 lark-vc、lark-doc、lark-drive、lark-im 串联起来,搭建一套完整的飞书 AI 办公工作流------从会议到文档到归档到通知,一气呵成。
获取更多 AI 咨询、一人公司、创业读书笔记、 Openclaw 、 Claude Code 实战干货,欢迎关注我
关键词:OpenClaw实操 飞书云空间 lark-drive 文件管理自动化 权限管理 飞书AI助手 工作流自动化
相关阅读:OpenClaw实操指南15|AI自动整理会议纪要:从飞书妙记到云文档,一键归档
OpenClaw实操指南14|飞书日历&任务自动化:AI帮你管日程、拆任务、发提醒