28.2 常见问题与排错指南

🎬 本节视频教程自动下一节

使用 WorkBuddy 的过程中，你可能会遇到各种问题。这一节汇总了最常见的问题和解决方案，帮你快速排错。遇到问题时，先来这里查。

一、安装与启动问题#

Q1：安装后无法启动#

排查清单：

Windows：确认系统是 Windows 10/11 x64（不支持 ARM64）；以管理员身份运行；检查安全软件是否拦截
macOS：确认系统是 12.0 及以上；到"系统设置→隐私与安全性"放行；若提示"已损坏"，终端执行 xattr -cr /Applications/WorkBuddy.app

Q2：macOS 提示"无法验证开发者"或"身份不明"#

解决：这是 macOS 的 Gatekeeper 安全机制。前往 系统设置 → 隐私与安全性，滚动到下方，点击"仍要打开"。

Q3：登录页面打不开 / 登录失败#

排查：

将 Chrome 设为默认浏览器（登录验证依赖浏览器）
检查网络连接是否正常
确认在登录页选择了正确的登录方式（个人/企业）

二、权限问题#

Q4：WorkBuddy 无法点击、输入、截屏、读文件#

这是最常见的一类问题，根因是系统权限未授权或未生效。

症状	需检查的权限
无法点击/输入	辅助功能（Accessibility）
无法截屏/识屏	屏幕录制
无法读文件	完全磁盘访问 / 文件夹访问

最关键的一步（macOS）：授权后必须完全退出并重启 WorkBuddy，权限才生效。很多人卡在这里。

Q5：安全软件（火绒/360）拦截操作#

解决：将 WorkBuddy 加入安全软件的信任/白名单。自动化操作（模拟点击、键盘输入）特别容易被拦截。

三、任务执行问题#

Q6：任务执行失败或卡住#

排查：

简化指令：复杂任务先拆成小步（技巧2）
检查工作区：确认所需文件确实在工作区内
检查积分：复杂任务消耗大，确认积分余额充足
切换模型：某些模型对特定任务表现更好（参见第23章）

Q7：AI 生成的结果不符合预期#

解决：

不要直接放弃，用多轮调整（技巧3）：指出问题、补充限制、切换视角
提供参考样本（技巧6）：给一个满意的例子让它模仿
召唤专家（技巧5）：提升专业度
任务拆解（技巧2）：复杂任务分步做，每步确认方向

Q8：AI 修改了我的文件，改坏了#

预防：让 AI 改重要文件前，务必备份（技巧8）。或在指令里要求"另存为修订版，不覆盖原文件"。

补救：如果已被改坏，检查是否有备份；Windows 用户可查看 WorkBuddy 是否自动备份了原文件（沙箱机制支持）。

Q9：批量操作被反复要求确认#

原因：默认权限模式下，批量/高风险操作会触发确认。

解决：

这是正常的安全机制，建议逐个确认
仅在隔离/测试环境（Docker/VM/测试目录）才考虑用"完全放开"模式
把文件集中到工作区，可减少工作区外操作的确认

四、积分与费用问题#

Q10：积分消耗太快#

控制积分的建议：

任务拆解，避免一次性跑超复杂任务
先用便宜的图片生成打磨提示词，再花钱做视频
专家团消耗是单专家的 3-5 倍，按需使用
新用户附赠 5000 Credits，注意查看用量

Q11：自定义模型扣了我的积分吗？#

不会。自定义模型的费用由你向第三方（模型厂商）支付，WorkBuddy 不扣积分。WorkBuddy 仅作通信链路。

五、连接器与远程问题#

Q12：连接器授权失败#

排查：

QQ 邮箱：确认 App 版本 7.1.5 / 鸿蒙 0.2.9+；扫码后必须在浏览器弹窗点"打开"
腾讯文档/乐享：确认微信/手机号登录授权完成
撤销重试：到对应平台的应用授权管理里撤销，重新授权

Q13：Claw 远程控制不响应#

排查：

确认已开启远程控制
确认绑定的 IM 平台配置正确（企业微信/飞书/钉钉需配回调 URL 和凭据）
确认电脑端 WorkBuddy 在线运行
WebSocket 模式确认显示"已连接"

六、性能问题#

Q14：响应很慢#

可能原因：

网络问题：检查网络稳定性
模型选择：极致模式/复杂任务耗时更长，简单任务用快速模式
文件过大：超大文件处理慢，可分批

Q15：知识库初始化失败#

解决：检查网络连接后刷新页面（参见 chat.json 的 knowledgeBaseFailed 提示）。

通用排错思路#

遇到任何问题，按这个顺序排查：


bash
1. 看本节FAQ能否直接解决
2. 检查基础项：网络、权限、版本、积分
3. 简化复现：用最简单的指令测试功能是否正常
4. 查官方文档：https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/FAQ
5. 查错误码：https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Error-Code
6. 反馈：通过 WorkBuddy 的"帮助与反馈"提交问题

错误码参考#

官方提供完整的错误码说明。遇到具体错误码时，查阅： /docs/workbuddy/From-Beginner-to-Expert-Guide/Error-Code

常见错误码类别：网络类、权限类、积分类、模型类、文件类等。

小结#

排错的核心是系统化排查：先看 FAQ，再查基础项（网络/权限/版本/积分），然后简化复现，最后查官方文档和错误码。

记住：90% 的问题都能在本节或官方 FAQ 找到答案。遇到问题别慌，按思路一步步查。

WorkBuddy 入门到精通