什么是 Visual File Sorter？

Visual File Sorter 是为 Openclaw Skills 设计的一项强大自动化功能，它模拟人类整理数字杂物的工作流程。这项技能不依赖于脆弱的文件元数据，而是使用“计算机使用 - 视觉”技术，实际打开文档、图像和收据以理解其实际内容。

通过模拟打开文件、读取内容并将其拖动到正确文件夹的过程，该技能提供了传统基于脚本的分类器无法比拟的组织准确性。对于希望拥有整洁的数字工作空间而又不愿手动整理数百个下载文件的用户来说，这是完美的解决方案。

下载入口:https://github.com/openclaw/skills/tree/main/skills/anotherj1/visual-file-sorter

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Visual File Sorter 应用场景

• 在长期项目结束后，自动清理杂乱的下载文件夹。
• 按日期和供应商对财务收据和发票进行分类，以备纳税季之用。
• 通过识别工作文档与个人媒体，整理混乱的桌面。
• 根据视觉内容而非通用文件名，对图像资产进行描述性重命名。

1. 代理扫描目标目录（下载或桌面），并过滤掉隐藏的系统文件和临时下载。
2. 它遍历文件队列，使用系统的默认应用程序打开每个文件以渲染内容。
3. 利用 Openclaw Skills 的计算机视觉能力，代理通过屏幕截图分析文本、日期和视觉上下文。
4. 代理根据提取的信息生成描述性的新文件名（例如：[日期]发票[公司]）。
5. 文件被关闭，然后根据其分类物理移动到 ~/Documents/Sorted/ 内的结构化子目录中。

Visual File Sorter 配置指南

要启用此技能，请确保您的代理具有必要的文件系统和 shell 权限。您可以使用自然语言命令触发该过程。

# 确保目标目录存在
mkdir -p ~/Documents/Sorted

只需告诉您的代理：“帮我整理下载文件夹”或“使用 Openclaw Skills 执行桌面清理”。

Visual File Sorter 数据架构与分类体系

该技能将文件组织到具有特定命名规范的标准目录结构中：

注意：该技能在重命名过程中严格保留原始文件扩展名。

name: visual-file-sorter description: 自动遍历下载文件夹或桌面，利用视觉模型“看”文件内容并重命名，最后归档到指定分类目录。 version: 1.0.0 author: Local_User permissions: filesystem: read: ["/Downloads", "/Desktop"] write: ["~/Documents/Sorted"] shell: allowed: true

视觉系文件分类大师 (Visual File Sorter)

?? 核心目标

你的任务是作为一个本地数字管家，自动清理用户杂乱的“下载 (Downloads)”或“桌面 (Desktop)”文件夹。你需要完全模拟人类“双击打开 -> 查阅内容 -> 总结命名 -> 拖拽归档”的物理工作流。

?? 触发条件

当用户发送类似以下指令时触发此工作流：

• “帮我整理一下下载文件夹”
• “归档桌面上的杂乱文件”
• “执行桌面清理”

?? 执行步骤

第一步：获取待处理队列

1. 使用终端工具列出目标文件夹（默认 ~/Downloads）中的所有文件。
2. 自动过滤并跳过系统隐藏文件（如 .DS_Store）和正在下载的临时文件（如 .crdownload, .part）。

第二步：模拟人类视觉阅读（核心循环）

针对队列中的每一个文件，严格执行以下动作：

1. 打开文件： 使用操作系统的默认程序或命令（如 Mac 的 open，Windows 的 start）打开该文件。
2. 视觉抓取： 等待 1-2 秒确保软件 UI 渲染完成。使用你的屏幕视觉能力 (Computer Use - Vision) 截取当前屏幕，阅读并理解文件内容。
3. 内容提炼： 在后台分析该文件是什么（如：餐饮发票、租房合同、搞笑表情包、技术 PDF）。提取关键元数据（如发票日期、公司名称、主要内容）。
4. 关闭窗口： 模拟按下关闭快捷键（如 Cmd+W 或 Alt+F4），退出预览界面。

第三步：智能重命名

基于上一步的视觉分析结果，按以下规则生成新的文件名，并使用 Shell 命令执行重命名：

• 财务报销类（发票/收据）： [YYYY-MM]_发票_[公司或摘要].[扩展名]
• 工作/正式文档： [YYYY-MM-DD]_[文档核心主题].[扩展名]
• 图片/多媒体素材： [画面内容描述].[扩展名]
• 异常处理：如果内容无法识别或受密码保护，保留原文件名，并在前缀加上 未分类_。

第四步：物理归档

检查目标归档目录 ~/Documents/Sorted/ 是否存在，如果不存在则自动创建。随后将重命名后的文件移动到以下对应的子文件夹中：

• .../Sorted/财务账单/
• .../Sorted/工作文档/
• .../Sorted/图片素材/
• .../Sorted/其他未分类/

?? 安全与操作红线

1. 禁止删除： 你仅拥有重命名和移动的权限。无论文件看起来多么像“垃圾文件”，绝对不允许执行 rm 或将其移入回收站。
2. 扩展名保护： 严禁修改文件的后缀名（扩展名），哪怕你认为它是一个伪装的文件，也只能修改 . 之前的文件名部分。
3. 隐私隔离： 视觉识别必须依赖本地或默认的视觉大模型通道，不得擅自编写脚本将截图或文本内容发送到未授权的第三方外部 API。