若workbuddy技能包导入失败，可依次尝试五种方法：一、图形界面拖拽导入；二、命令行校验并安装；三、通过skillhub商店安装；四、启用openclaw兼容模式导入；五、修复权限与路径问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已获得他人分享的 WorkBuddy 技能包（.skill 文件），但无法正常导入或执行失败，则可能是由于文件路径错误、格式校验未通过或权限未授权所致。以下是多种可行的导入方法及对应排查步骤：
一、通过图形界面拖拽导入
该方式适用于所有用户，无需命令行操作，利用 WorkBuddy 内置的可视化技能管理器完成导入，支持即时校验与错误提示。
1、打开 WorkBuddy 主界面，点击右上角头像图标，进入「Claw 设置」。
2、在左侧菜单中选择「技能管理」，确保右侧显示「本地技能」标签页。
3、将他人分享的 .skill 文件直接拖入窗口空白区域，松手后自动触发校验流程。
4、若校验通过，页面显示绿色对勾并提示「导入成功」；若失败，弹出红色错误框，注明具体原因（如签名无效、版本不兼容）。
二、通过命令行工具导入
该方式适用于开发者或需批量导入场景，可输出详细调试日志，便于定位结构异常或元数据缺失问题。
1、确认终端已识别 workbuddy 命令：在终端输入 workbuddy --version，返回版本号即表示环境就绪。
2、执行校验命令：workbuddy skill validate /path/to/shared.skill，检查文件完整性与签名有效性。
3、执行导入命令：workbuddy skill install /path/to/shared.skill，默认安装至用户技能目录。
4、如需查看完整过程日志，追加 --debug 参数重新运行导入命令。
三、通过 SkillHub 商店手动安装
该方式适用于已上传至腾讯官方 SkillHub 的共享技能，可规避本地文件传输风险，并自动处理依赖项与模型适配。
1、在 WorkBuddy 主界面点击顶部导航栏中的「技能市场」按钮。
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
2、在搜索框中输入技能名称关键词，或粘贴他人提供的 SkillHub 分享链接（形如 https://skillhub.tencent.com/skill/xxx）。
3、点击目标技能卡片右下角的「安装」按钮，系统自动下载并校验。
4、安装完成后，该技能将出现在「已安装技能」列表中，状态栏显示 「就绪」。
四、通过 OpenClaw 兼容模式导入
该方式专为复用开源小龙虾（OpenClaw）生态技能设计，支持无修改迁移，但需确保技能包符合 MCP 协议规范。
1、在「Claw 设置」→「技能管理」中，点击右上角「更多」按钮，选择「启用 OpenClaw 兼容模式」。
2、重启 WorkBuddy 使兼容层生效。
3、使用方法一或方法二尝试导入该技能包，此时系统将调用 OpenClaw 校验器进行双重验证。
4、若提示「MCP 插件未加载」，需前往「扩展设置」中手动启用 MCP 协议支持模块。
五、权限与路径问题专项修复
该方式用于解决因系统级限制导致的导入静默失败，常见于 macOS 首次运行或 Windows 组策略锁定场景。
1、在 macOS 上，若拖拽无响应，先执行：sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app 清除隔离属性。
2、在 Windows 上，右键 .skill 文件 →「属性」→ 勾选「解除锁定」→ 点击「确定」。
3、确保 .skill 文件存放路径不含中文、空格或特殊符号，推荐使用 /Users/xxx/Skills/ 或 C:\Skills\ 这类纯净路径。
4、在 WorkBuddy「Claw 设置」→「安全中心」中，确认已开启 「允许安装未签名技能」 开关（仅限可信来源）。
