WorkBuddy初体验：安装到首次对话全记录

WorkBuddy并非“装上即用”的开箱体验，其流畅运行高度依赖三个易被忽视的硬性环境配置：C盘安装路径留有余量、系统预装夸克浏览器（且必须用其内核扫码登录）、首次登录后及时完成桌面/文档/下载文件夹的精准授权——任一缺失都会导致卡在登录页、对话无响应或无法读取本地文件；而真正验证功能是否跑通的关键，是用一条包含明确输入源、解析逻辑和可量化输出的指令（如提取test.txt中含“AI”或“Agent”的关键词）进行闭环测试，避开“你好”“写PPT”等无效试探，同时警惕授权弹窗的一次性特性与积分余额不足等隐藏门槛。

WorkBuddy 能不能装上就用？能，但有三个硬性前提必须当场确认：安装路径没占满 C 盘、夸克浏览器已预装、微信扫码后完成了文件夹授权——缺一不可，否则你卡在登录页或对话无响应，不是软件问题，是环境没配齐。

Windows 安装后打不开或点击登录没反应

这不是 WorkBuddy 崩溃，而是它依赖夸克浏览器内核渲染登录页。系统里没装夸克，点击 登录 按钮就会静默失败，界面毫无提示。

• 去夸克官网下载最新版安装，无需配置，装完重启 WorkBuddy 即可
• 别用 Edge 或 Chrome 内置扫码跳转——WorkBuddy 的登录页不兼容其他内核
• 如果已装夸克仍无反应，右键桌面 WorkBuddy 快捷方式 → “以管理员身份运行”再试一次

微信扫码登录成功但无法读取本地文件

登录只是第一步，文件夹授权 才是真正启用“干活能力”的开关。授权窗口只在首次登录后弹出一次，错过就得手动重置。

• 打开设置 → Claw 设置 → 文件访问权限 → 点击“重新请求授权”
• 务必勾选 桌面、文档、下载 这三个目录，基础办公任务（比如整理周报、处理 Excel）默认从这里找输入源
• 不要点“全部允许”——WorkBuddy 不支持全盘授权，强行选 C:\ 会触发沙箱拦截，后续任务直接报错 Permission denied in sandbox

第一次对话发什么指令最能验证功能是否跑通

别问“你好”，也别试“写个 PPT”，用这个三步最小闭环验证：定位输入源 → 触发解析 → 输出可验证结果。

• 提前在 文档 文件夹里放一个叫 test.txt 的文本文件，内容就写一行“今天开会要讨论 AI Agent 落地”
• 在主对话框输入：读取文档/test.txt 并提取所有带“AI”或“Agent”的关键词，按出现频次排序
• 如果返回结果是 ["AI", "Agent"] 且顺序正确，说明模型调用、文件读取、指令解析三环全通；如果卡在“正在思考…”超 90 秒，大概率是积分余额不足——去左下角紫色图标点 领100积分 再试

最容易被忽略的其实是授权时机：文件夹授权窗口弹出时，很多人习惯性点“取消”或切走干别的，等回头想处理文件才发现所有路径都是灰色不可选。这个弹窗不二次提醒，也没有入口手动唤起，只能删掉 %APPDATA%\WorkBuddy\config.json 后重启客户端强制重来。

到这里，我们也就讲完了《WorkBuddy初体验：安装到首次对话全记录》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！