若QClaw无法加载项目，需依次检查项目路径有效性、project.json完整性、重置本地缓存、以管理员权限运行、禁用安全软件拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您启动QClaw后无法加载项目，界面停留在空白或提示“项目未找到”“加载失败”等状态，则可能是由于项目路径异常、配置文件损坏或权限缺失所致。以下是解决此问题的步骤：
一、检查项目路径是否有效
QClaw依赖用户指定的本地项目目录进行加载，若路径被删除、移动或包含非法字符，将导致加载中断。
1、打开QClaw主界面，点击右上角“设置”图标。
2、在设置面板中定位“项目根目录”字段，确认显示的路径是否真实存在。
3、若路径不存在，点击右侧“浏览”按钮，重新选择一个**非中文、无空格、无特殊符号**的文件夹作为新根目录。
4、重启QClaw，观察项目是否自动识别并加载。
二、验证project.json配置文件完整性
每个QClaw项目必须包含合法的project.json文件，该文件定义项目元信息；若缺失、格式错误或编码不为UTF-8，将触发加载拒绝。
1、进入当前项目所在文件夹，确认是否存在名为project.json的文件。
2、用文本编辑器（如VS Code）打开该文件，检查首尾是否为大括号{}，且内部JSON语法无误（可粘贴至jsonlint.com验证）。
3、若文件为空或报错，可基于官方模板重建：确保至少包含{"name":"MyProject","version":"1.0.0"}这一最小结构。
4、保存文件，确保编码为UTF-8无BOM格式，然后刷新QClaw项目列表。
三、重置QClaw本地缓存数据
QClaw会在本地存储项目索引缓存，缓存文件损坏可能导致项目列表无法渲染，但实际项目文件完好。
1、关闭QClaw应用程序，确保进程完全退出（可在任务管理器中检查qclaw.exe或QClaw Helper进程）。
2、按下Win+R键，输入%APPDATA%\QClaw（Windows）或~/Library/Application Support/QClaw（macOS），回车打开配置目录。
3、在该目录内找到并**重命名**文件夹cache为cache_backup。
4、重新启动QClaw，程序将自动生成全新缓存并重新扫描项目路径。
四、以管理员/特权模式运行QClaw
当项目位于系统保护目录（如Program Files、/usr/local）或网络挂载盘时，QClaw可能因权限不足而无法读取项目文件。
1、右键QClaw快捷方式或可执行文件，选择“以管理员身份运行”（Windows）或“显示简介→勾选‘始终以此方式打开’→右键应用→‘显示包内容’后终端执行sudo命令启动”（macOS）。
2、启动后进入“项目设置”，尝试手动添加一个位于桌面或文档目录下的测试项目。
3、若测试项目可正常加载，则确认原项目路径存在权限限制，需调整目标文件夹的读取权限或迁移至用户可写区域。
五、禁用第三方安全软件临时拦截
部分杀毒软件或防火墙会将QClaw的文件扫描行为误判为可疑操作，并主动阻断其对project.json或资源子目录的访问。
1、临时关闭Windows Defender实时保护，或在第三方安全软件中查找“应用控制”“行为防护”模块。
2、将QClaw主程序路径（如C:\Program Files\QClaw\qclaw.exe）添加至信任列表或白名单。
3、重启QClaw，再次尝试加载原项目，观察是否跳过加载卡顿或静默失败现象。
