workbuddy需手动授权文件夹才能访问word、excel、ppt等文件，首次启动弹窗是唯一合法授权入口；支持单路径添加、动态增删、前缀匹配批量授权及配置文件注入，禁用同步盘、符号链接和网络路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy无法读取你电脑上的Word合同、Excel报表或PPT演示稿，是因为它根本没被允许打开这些文件夹——所有路径都需你手动勾选并确认，AI连文件名都看不到，更不会偷偷扫描硬盘或默认访问“桌面”“文档”等目录。
首次启动时完成基础授权
这是唯一合法入口，错过将导致后续所有文件操作失败。
完成微信或腾讯账号扫码登录后，等待系统自动弹出“添加文件夹”窗口；该弹窗强制出现，不点击“确定”无法进入主界面。
点击“添加文件夹”按钮，在系统原生选择器中定位到你常用的工作路径，例如【D:项目资料】或【~/Desktop/本周待办】；注意不要选根目录（如D:或/），避免权限过大引发误操作风险。
可重复点击“添加文件夹”追加多个独立路径，每次仅支持单路径选取；比如再加一个【D:财务报表】，但不能一次选中“D:项目资料”和其子文件夹“D:项目资料合同终稿”合并提交。
全部选完后点击“确定”，授权立即生效，无需重启软件——此时AI才能看到这些目录下的文件列表。
通过设置面板动态增删授权目录
日常办公中常需临时开放新项目文件夹，或撤回已离职同事共享过的敏感目录。
点击右上角个人头像 → 选择“Claw设置” → 左侧导航栏点“文件夹授权”。
在已授权列表中，找到要移除的路径，点击右侧垃圾桶图标即可删除；删除后AI立刻失去对该路径的任何访问能力，包括缓存中的历史文件引用。
如需新增，点击页面上方“+ 添加文件夹”按钮，重新唤起系统选择器；【新增路径不会自动继承父目录权限】，哪怕你刚删了“D:项目A”，再加“D:项目A会议纪要”也得单独授权。
启用前缀匹配批量授权
适用于按项目代号、年份、部门缩写等规律组织的存储结构，比如D:Projects6_Q3、D:Projects6_Contract这类路径。
方法一：图形界面操作
点击左上角头像进入个人中心 → 选择「文件夹授权管理」→ 在窗口右下角点击「高级模式」开关启用通配符支持。
在路径输入框中键入前缀格式，例如：D:Projects6_（注意末尾保留反斜杠与下划线）。
点击「扫描匹配」，系统列出所有以该前缀开头的现存目录，如D:Projects6_Q1、D:Projects6_Contract、D:Projects6_Report。
勾选全部扫描结果，点击「确认授权」，所有匹配路径即时获得读写权限。
方法二：配置文件注入（适用于路径尚未创建或需预置策略）
关闭WorkBuddy客户端。
WorkBuddy 5.3.8于2026年7月30日发布，修复文件监听卡顿、监听句柄泄漏、历史任务无法恢复、登录状态同步异常、命令环境检测异常及内部消息展示等问题，桌面端运行更稳定。
打开配置目录：Windows为C:Users{用户名}AppDataRoamingWorkBuddyconfig older_access.json；macOS为~/Library/Application Support/WorkBuddy/config/folder_access.json。
用文本编辑器打开该JSON文件，在数组中新增一条前缀规则条目，格式为：{"prefix": "D:\Projects\2026_", "access": "r"}。
保存文件后重新启动WorkBuddy，系统将在启动时自动匹配实际存在的路径并完成授权。
修复授权失败的典型场景
第一步：确认首次授权弹窗是否被系统拦截
macOS用户：打开「系统设置 → 隐私与安全性 → 完整磁盘访问」，检查WorkBuddy.app是否已勾选；若未出现，说明应用尚未触发权限请求→此时需完全退出WorkBuddy（右键菜单栏图标→退出），再双击重开，等待弹窗自动浮现。
Windows用户：右键WorkBuddy快捷方式→选择“以管理员身份运行”，再登录。普通权限下首次弹窗常被UAC或杀毒软件吞掉，提权后才能唤起系统级文件夹选择器。
【授权弹窗是唯一合法入口，设置面板里的“添加文件夹”按钮仅用于追加，不能替代首次授权】。
第二步：检查路径是否被系统保护或指向无效位置
WorkBuddy只接受真实、可写、非符号链接、非网络挂载的本地路径。以下路径一律拒绝授权：
• 桌面快捷方式（.alias 或 .lnk）
• OneDrive/Google Drive/腾讯微云同步文件夹根目录（如C:UsersNameOneDrive）
• /usr/local/bin、/Library/Preferences 等SIP保护区（macOS）
• 映射网络驱动器（Z:、Y:等）
正确做法：把目标文件夹复制到本地非同步路径，例如D:Projects或~/DocumentsWorkBuddy-Data，再通过弹窗选取该物理路径。
若选中后弹窗直接关闭且无报错，大概率是路径含中文全角字符、空格过多或存在隐藏控制符——改用英文命名并删减空格后重试。
第三步：清除缓存并刷新权限
删除token目录下access_token.json与scope_cache.json文件。
进入Claw Settings → Integration Status，点击对应工具的Refresh Permissions完成同步。
