新版 WorkBuddy 支持导入哪些 OpenClaw 技能？导入失败怎么办？
新版 WorkBuddy 原生支持哪些 OpenClaw 技能？导入失败如何排查？
核心结论是：自 WorkBuddy v2.3.0 起，所有遵循 MCP 协议规范的 OpenClaw 技能均已获得原生支持。然而，实际导入失败往往与兼容性无关，问题通常出在签名验证、运行依赖缺失或系统权限配置这三个环节。
可直接导入的 OpenClaw 技能包格式
WorkBuddy 对技能包的识别有严格标准，仅接受以下三种结构规范的格式：
- 包含完整
manifest.json文件的 ZIP 压缩包。该清单文件必须明确定义name、description、mcp_version、actions等核心字段。 - 扩展名必须为
.skill.json的独立文件。请注意，.json或.skill均无法被识别，这是最常见的格式错误。 - 来自 SkillHub 官方仓库，且明确标记为「OpenClaw兼容」的技能。其官方链接格式通常为
https://skillhub.tencent.com/skill/xxx。
实际操作中，命名惯例和文件来源是两大陷阱。例如，沿用旧版命名的 browser-automation.skill 文件会被直接拒绝。同样，从 GitHub raw 地址直接下载的 JSON 文件，常因缺少 triggers 等关键字段而无法通过校验。
根据错误码精准定位导入失败原因
WorkBuddy 提供了明确的错误码机制，而非模糊的失败提示。每个错误码都指向一个具体的排查方向：
ERR_SIGNATURE_INVALID：通常表示技能包在传输中被篡改，或签名密钥与本地环境不匹配。解决方案是联系作者获取重签名的版本。若来源可信，可在设置中临时关闭「强制签名验证」（此操作存在安全风险）。ERR_DEPENDENCY_MISSING：提示缺少必要的运行时依赖，如playwright或特定版本的python3.11。请进入「Claw 设置」→「依赖管理」界面，勾选缺失项并执行一键安装。避免手动使用pip install，以防引发环境冲突。ERR_SCHEMA_MISMATCH：表明技能包声明的mcp_version（如"2.1"）与当前 WorkBuddy 运行时版本（如"2.2"）不兼容。请寻找适配当前运行时的技能包，或将 WorkBuddy 升级至最新版本。
若通过命令行导入，可附加 --debug 参数以获取更详细的堆栈信息，例如具体是哪个 Python 模块导入失败。
技能导入成功但无响应？检查触发链路
这是最隐蔽的问题：技能包导入成功，图标显示正常，但执行指令（如“生成周报”）时毫无反应。本质是技能触发链路在某一环节中断：
- 首先，核对技能定义文件中的
triggers数组。你的口头指令必须完全匹配数组内的关键词。例如，技能定义的是["写周报"]，而你说“生成周报”，则无法触发。 - macOS 用户特别注意：即便安装时已授权，仍需手动前往「系统设置」→「隐私与安全性」→「辅助功能」，确认并勾选 WorkBuddy 的权限。
- 使用企业域账号的 Windows 用户请注意：部分组策略会默认禁用剪贴板监听，这将导致所有依赖剪贴板操作的技能（如
clipboard-summary）静默失败，且无任何错误提示。
仅凭界面状态无法判断技能是否真正可用。最可靠的验证方法是在导入后，立即使用真实指令进行一次完整测试，避免导入一个无法交互的“空壳”技能。