workbuddy v2.3.0+原生支持三类openclaw技能：含完整manifest.json的zip包、扩展名为.skill.json的单文件、skillhub标有“openclaw兼容”标签的技能；导入失败主因是签名无效、依赖缺失或schema不匹配，需依错误码精准处置。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

新版 WorkBuddy（v2.3.0+）原生支持所有符合 MCP 协议规范的 OpenClaw 技能，但导入失败几乎从不因为“不兼容”，而是卡在签名、依赖或权限这三关。

哪些 OpenClaw 技能能直接导入？

不是所有 .skill 或 .zip 文件都能用，WorkBuddy 只认三类明确结构的包：

• manifest.json 存在且字段完整（含 name、description、mcp_version、actions）的 ZIP 包
• 扩展名为 .skill.json 的单文件（注意不是 .json 或 .skill）
• SkillHub 上标有「OpenClaw兼容」标签的技能（链接形如 https://skillhub.tencent.com/skill/xxx）

常见踩坑点：browser-automation.skill 这类老命名习惯的文件会直接被拒绝；从 GitHub raw 下载的未打包 JSON 也常缺 triggers 字段，导致校验失败。

导入失败时先看错误码，别急着重试

WorkBuddy 不会笼统报“导入失败”，它会在 UI 或命令行里给出具体错误码，每个都对应一个可操作路径：

Openclaw Guru - Documentation and Support expert

OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。

下载

• ERR_SIGNATURE_INVALID：技能包被篡改或签名密钥未同步——需联系作者重签，或临时关闭设置里的「强制签名验证」（仅限可信来源）
• ERR_DEPENDENCY_MISSING：提示缺 playwright 或 python3.11——进「Claw 设置」→「依赖管理」勾选并一键安装，别自己 pip install
• ERR_SCHEMA_MISMATCH：mcp_version 声明为 "2.1"，但当前运行时只支持 "2.2"——要么降级技能包，要么升级 WorkBuddy 到最新版（官网每天更新）

命令行导入时加 --debug 能看到更细的堆栈，比如某 Python 脚本 import 失败的具体模块名。

拖拽导入成功但技能不响应？调用链路断了

这是最隐蔽的问题：文件进了系统，图标也亮了，但输入“生成周报”完全没反应。本质是触发词没对上，或权限没真正生效：

• 检查技能定义里的 triggers 数组是否包含你实际说的关键词（例如写的是 ["写周报"]，你说的是 “生成周报”）
• macOS 用户特别注意：即使弹窗点了「允许」，也要去「系统设置」→「隐私与安全性」→「辅助功能」里手动勾选 WorkBuddy
• Windows 用户若用企业域账号登录，部分策略会禁用剪贴板监听——此时依赖剪贴板的技能（如 clipboard-summary）必然静默失败

空壳技能无法靠界面判断，必须用真实指令实测一次，否则你永远不知道那个绿色对勾背后是不是一具尸体。