WorkBuddy技能未执行、报错或返回空结果，主因是技能包异常、权限不足、模型调用失败、缓存损坏或环境异常；需依次检查启用状态与完整性、补全系统权限、切换模型重试、清除缓存、运行诊断工具修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy时触发某项技能，但任务未执行、报错中断或返回空结果，则可能是由于技能包加载异常、依赖缺失、权限不足或模型调用失败所致。以下是解决此问题的步骤：
一、检查技能包完整性与启用状态
WorkBuddy要求技能包必须完整解压且处于启用状态才能被调用。若技能文件损坏、路径异常或被手动禁用，将导致运行失败。
1、打开WorkBuddy主界面，点击左下角【Skills】图标进入技能管理页
2、查找目标技能名称，确认其右侧开关为开启状态（绿色）
3、点击该技能右侧的【详情】按钮，核对“版本号”与“最后更新时间”是否非空且非0
4、若显示“文件缺失”或“校验失败”，点击【重新下载】按钮强制拉取最新包
二、验证本地执行权限配置
部分技能需访问文件系统、剪贴板、屏幕内容或辅助功能权限，macOS与Windows系统默认限制此类操作，未授权将直接终止执行。
1、在WorkBuddy中点击右上角头像 → 【设置】→ 【安全与权限】
2、查看【文件与文件夹】条目，确认已勾选“允许访问下载文件夹”及对应工作目录
3、在系统层面补全授权：Windows用户需在“设置 > 隐私 > 后台应用”中开启WorkBuddy；macOS用户需进入“系统设置 > 隐私与安全性 > 辅助功能/自动化/完全磁盘访问”，将WorkBuddy加入白名单
4、重启WorkBuddy使权限变更生效
三、切换模型并重试调用
某些技能依赖大模型生成中间结果（如文案润色、代码补全），若当前选定模型不可用、响应超时或返回格式错误，会导致技能链路中断。
1、点击顶部导航栏【模型】按钮，展开当前激活模型列表
2、选择其他已预置模型（如从Hunyuan切换至DeepSeek或Kimi）
3、返回技能执行界面，点击【重试】或重新输入相同指令
4、若仍失败，在指令前添加前缀 --debug 触发详细日志输出，定位具体卡点
四、手动清除技能缓存与临时数据
长期运行后，技能产生的临时文件、上下文快照或缓存索引可能损坏，干扰后续执行流程。
1、关闭WorkBuddy客户端
2、定位本地缓存目录：Windows路径为 %APPDATA%\Tencent\WorkBuddy\Cache\skills；macOS路径为 ~/Library/Caches/com.tencent.workbuddy/Skills
3、删除该目录下所有子文件夹及.json/.bin结尾的文件（保留空文件夹结构）
4、重新启动WorkBuddy，等待约10秒待技能索引重建完成后再尝试运行
五、使用内置诊断工具自动修复
WorkBuddy集成openclaw doctor兼容诊断模块，可识别常见技能环境异常并一键修正。
1、确保WorkBuddy已联网且登录腾讯云账号
2、按下快捷键 Ctrl+Shift+D（Windows）或 Cmd+Shift+D（macOS）唤出诊断控制台
3、输入命令 doctor --fix skills 并回车
4、等待终端输出“✅ Skills environment OK”提示后，关闭控制台并重试技能
