核心功能与用法
File Manager 是 OpenClaw 平台的自动化文件管理技能,提供四大核心能力:
智能文件分类 (`organize`):按文件类型、日期层级(年/月/日)自动重组目录结构,适合整理下载文件夹、项目归档等场景。
批量重命名 (`batch_rename`):支持正则替换、序列号生成、前缀后缀添加,满足照片整理、文档标准化命名需求。
重复文件清理 (`deduplicate`):基于内容哈希(而非文件名)精准识别重复文件,支持扫描预览、删除或隔离移动,可选保留最旧/最新版本。
目录同步 (`sync`):单向镜像同步,支持排除模式(如排除 node_modules、.git、临时文件),适用于工作目录自动备份。
显著优点
- 零依赖轻量化:纯 Python 标准库实现,无需额外安装,Python 3.8+ 即可运行
- 安全优先设计:所有修改操作默认 dry-run 预览,需显式
--execute确认,避免误操作 - 符号链接防护:自动跳过符号链接,杜绝无限递归风险
- 冲突智能处理:目标文件存在时自动重命名或跳过,绝不覆盖
局限性与风险
- 功能未完全实现:按大小分类、双向同步等功能标记为"尚未实现"
- 无撤销机制:删除操作直接执行(虽需确认),无内置回收站或版本回退
- 跨平台兼容性:路径处理依赖 Python 标准库,极端复杂字符文件名可能行为不一致
- 性能边界:大目录(百万级文件)哈希计算可能较慢,无进度显示机制
适合人群
开发者、摄影师、资料管理员等需要批量处理本地文件的用户,尤其适合重视操作安全、偏好命令行工具的技术人群。
常规风险提示
文件操作本身具有不可逆性,尽管本技能设计了多重确认机制,用户仍需在执行前仔细检查 dry-run 输出,重要数据建议先行独立备份。