电脑文件自动整理工具均需显式配置路径白名单:OpenClaw须编辑openclaw.json添加allowedPaths并设enableWrite为true;WorkBuddy通过GUI点击授权或设置中添加信任路径;hlink则靠hlink.config.mjs的include/exclude规则与pathsMapping实现内容级管控。

电脑文件自动整理工具(如OpenClaw、WorkBuddy或hlink)默认禁止访问任意路径,必须手动配置允许读写的目录列表,否则所有整理指令都会因权限拒绝而静默失败——这不是功能异常,而是强制安全机制。
OpenClaw白名单路径配置
OpenClaw采用绝对路径白名单制,桌面、下载等常用目录不在默认许可范围内,必须显式声明。
第一步:定位配置文件
Windows系统打开 【C:Users你的用户名.openclawopenclaw.json】;macOS/Linux系统打开 【~/.openclaw/openclaw.json】。
第二步:编辑tools → file区块
在"tools": {"file": {}}内部插入或修改以下字段:
"allowedPaths": ["C:/Users/你的用户名/Desktop", "C:/Users/你的用户名/Downloads", "D:/归档"]
注意:路径中使用正斜杠/或双反斜杠\,单反斜杠会导致JSON解析失败。
第三步:开启写入权限
确保同一层级存在"enableWrite": true,缺省值为false,不加这行等于白配。
第四步:保存并重载配置
保存文件后,在终端执行openclaw reload,无需重启Agent进程。
WorkBuddy桌面整理路径授权
WorkBuddy的路径白名单不通过JSON配置,而由图形界面触发隐式授权——只有你手动点击过某个文件夹,它才被记录为可信路径。
方法一:首次整理时授权
点击托盘图标→“打开主界面”→进入“桌面管理”→开启“自动整理桌面图标”→首次执行整理时,系统会弹出窗口要求确认访问桌面文件夹,点击【允许】即完成白名单登记。
方法二:预加载信任路径
在“设置→高级→文件访问权限”中,点击【添加信任路径】,浏览并选中C:Users你的用户名Desktop和C:Users你的用户名Downloads,勾选“允许读取与移动文件”。
【重要提醒】若桌面图标未归类,先检查右下角通知栏是否出现“访问被阻止”提示气泡——这是白名单未生效的直接信号。
hlink硬链接工具的黑白名单设置
hlink不依赖系统级路径授权,但通过include和exclude参数控制哪些文件能被整理,本质是内容级白名单。
编辑项目根目录下的hlink.config.mjs文件,在export default{}内配置:
include: [ '.pdf', '.docx', '.xlsx', '.jpg', '.png' ]
只处理这五类文件,其余全部跳过,连扫描都不做。
exclude: [ 'temp_', 'draft_', 'backup_' ]
文件名以这三个前缀开头的,哪怕后缀匹配include规则也强制排除。
pathsMapping: {
"C:/Users/你的用户名/Downloads": "D:/归档/下载整理",
"C:/Users/你的用户名/Desktop": "D:/归档/桌面快照"
}
每条映射都自动将源路径加入运行时白名单,无需额外声明。











