飞书备份工具（Feishu Backup）是一款专为飞书群聊文件管理设计的自动化备份解决方案。它能够自动将群聊中上传的文件下载并保存到本地指定目录 `~/.openclaw/doc/backup/`，确保重要文档、图片、视频等资料不会因平台限制或数据丢失而遗失。该工具通过调用 `feishu_backup.sh` 脚本实现核心功能，严格遵循仅执行下载命令、不创建或修改任何文件的规则，保证操作的安全性与可预测性。用户无需编写代码或配置复杂参数，只需通过自然语言指令即可触发备份任务，极大降低了使用门槛。 该工具的核心优势在于其智能匹配机制，能够精准解析用户的模糊需求并将其转化为具体的执行条件。例如，当用户说“备份最近上传的PDF”时，系统会自动识别时间范围（如过去5分钟）和文件类型（pdf），并调用相应的环境变量执行下载。支持的筛选维度包括：按上传时间（如最近几分钟）、文件名前缀（如以“report”开头）、关键字匹配（如名称中包含“contract”）以及文件类型限定（如仅下载图片或视频）。此外，还支持批量处理，可同时备份多个最新文件或满足特定条件的文件集合，提升效率的同时保持灵活性。 整个流程透明可控，脚本运行后会输出明确的日志信息——成功时显示 `SUCCESS: /path/to/file`，失败则如实报告错误状态，避免虚假成功提示。用户可通过简单的终端命令查看已备份文件列表，确认数据完整性。由于直接对接飞书官方API获取原始二进制文件，所下载的文件大小应与云端一致，若出现异常小文件（如几KB），则表明下载过程存在问题，工具会如实反馈这一情况。整体设计注重可靠性与真实性，适合需要长期归档团队沟通成果的技术人员或企业知识管理者使用。
核心功能特点
- 自动将飞书群聊文件下载至本地 `~/.openclaw/doc/backup/` 目录
- 支持按文件名前缀、关键词、文件类型进行智能筛选
- 可设定时间范围（如最近5分钟）和数量限制（如最多3个文件）
- 仅执行真实文件下载，不生成或篡改任何辅助文件
- 输出明确的成功/错误日志，确保操作结果可验证
- 兼容多种文件类型：PDF、图片、视频、文档等
适用场景
飞书备份工具特别适合需要长期保留团队沟通记录的企业用户或技术团队。在日常协作中，成员常会在群聊中共享合同草案、项目报告、会议纪要等重要文件，但这些内容往往分散且易被覆盖。使用该工具后，管理员可以定期或在关键节点手动触发备份，将所有相关文档集中存储于本地，形成可追溯的知识资产库。例如，在项目收尾阶段，只需一句‘备份最近一周的所有PDF’，即可快速归档全部交付物，避免遗漏。 对于远程办公或分布式团队而言，该工具提供了可靠的离线访问保障。即使网络中断或飞书服务临时故障，本地备份仍能确保核心资料可用。此外，结合自动化脚本调度，还可实现定时备份策略，比如每天凌晨自动拉取前一天新增文件，持续积累组织记忆。这种机制尤其适用于法务、财务、研发等部门，其中文件合规性和历史版本追溯至关重要。 另一个典型应用场景是个人知识管理。开发者、设计师等创意工作者常在飞书群中分享原型图、设计稿、代码片段等资源。通过设置 `NAME_PREFIX=design` 或 `FILE_TYPE=image`，用户能高效整理视觉素材；而 `MINUTES=10 FILE_TYPE=video` 则可在头脑风暴后立即保存演示录像。由于所有文件均以真实二进制形式保存，后续可直接用于复盘、培训或客户汇报，无需重新上传或转换格式，真正实现‘一键归档，随时调用’。