技能包加载失败可按五步排查：一、重置OpenClaw协议连接；二、清除claw_cache缓存重建索引；三、重签名技能包并重授系统权限；四、切换至CN镜像技能源；五、以兼容模式启动WorkBuddy。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy过程中遇到技能包加载失败的情况，可能是由于本地缓存损坏、OpenClaw协议兼容性异常、权限未授权或技能市场连接中断所致。以下是多种可立即执行的异常处理办法：
一、检查并重置OpenClaw协议连接状态
该方法用于排除因协议握手失败导致的技能包无法识别问题，适用于首次启用或更新后技能列表为空的场景。
1、打开WorkBuddy主界面，点击右上角个人中心图标。
2、进入「Claw设置」→「协议诊断」，点击「运行连通性检测」。
3、若提示“MCP handshake failed”或“OpenClaw endpoint unreachable”，点击「强制重连」按钮。
4、等待5秒后，手动点击「刷新技能市场」，观察是否恢复加载。
二、清除技能缓存与本地技能索引
该方法针对技能图标显示为灰色、点击无响应或提示“技能未就绪”等现象，通过清除损坏的本地元数据重建索引。
1、关闭WorkBuddy主程序（确保进程完全退出，可在任务管理器/活动监视器中确认无WorkBuddy相关进程）。
2、定位本地缓存路径：
Windows系统：打开文件资源管理器，粘贴路径 %APPDATA%\Tencent\CodeBuddy\claw_cache；
macOS系统：打开访达，按 Cmd+Shift+G，输入 ~/Library/Application Support/Tencent/CodeBuddy/claw_cache。
3、删除整个 claw_cache 文件夹。
4、重新启动WorkBuddy，登录后系统将自动重建索引并重新拉取技能清单。
三、手动触发技能包重签名与权限重授权
该方法解决因系统安全策略变更（如macOS新版本Gatekeeper升级或Windows Defender拦截）导致技能包被拒绝加载的问题。
1、在WorkBuddy中进入「设置」→「安全与权限」→「技能执行策略」。
2、关闭「启用沙箱隔离模式」开关（临时禁用以排除沙箱拦截干扰）。
3、点击「重授本地文件与辅助功能权限」，按系统弹窗指引完成全部授权操作。
4、返回「Claw设置」，点击「重新签名已安装技能」，等待进度条完成（约8–12秒）。
5、重启WorkBuddy，验证技能包是否恢复正常调用。
四、切换备用技能源通道
该方法适用于官方技能市场长时间无响应、加载转圈或返回403/502错误时，可快速切换至社区镜像通道获取相同技能包。
1、进入「Claw设置」→「技能源管理」。
2、关闭「默认官方源」，启用「OpenClaw CN Mirror（上海节点）」。
3、点击「清空当前技能列表」，再点击「同步远程技能」。
4、等待列表刷新完成后，尝试安装任一基础技能（如“Excel自动合并”）进行验证。
5、验证成功后，可重新开启官方源并点击「全量覆盖同步」以保持版本一致性。
五、降级兼容模式启动WorkBuddy
该方法专用于v1.3.2及以上版本在部分老旧GPU驱动或低内存设备上出现技能初始化崩溃的情形，通过临时禁用多Agent并行能力保障基础技能加载。
1、关闭WorkBuddy。
2、Windows用户：按 Win+R 输入 cmd，执行：
start "" "C:\Program Files\WorkBuddy\WorkBuddy.exe" --compat-mode=claw-v1；
macOS用户：打开终端，执行：
open -n "/Applications/WorkBuddy.app" --args --compat-mode=claw-v1。
3、启动后不登录账号，直接进入「技能市场」，确认能否正常浏览与安装。
4、若可正常加载，说明为新版技能调度器兼容性问题，建议暂时使用该模式，待下个热修复补丁发布。
