workbuddy导入openclaw技能包需满足三要素：格式合规（json须为.skill.json且含name等四字段，zip须含顶层manifest.json）、权限到位（macos/windows系统级隐私授权）、依赖就绪（如playwright、nodejs等需在依赖管理中一键安装），缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 导入 OpenClaw 技能包不是“装上就能用”，关键看技能包格式是否合规、权限是否到位、依赖是否就绪——三者缺一不可。
确认技能包是否符合 MCP 协议规范
OpenClaw 生态的技能包必须满足 MCP（Model-Controller-Protocol）协议才能被 WorkBuddy 正确识别。常见失败原因不是路径或网络问题，而是结构校验直接拒收。
- JSON 格式技能必须以
.skill.json为后缀，且根对象含name、description、triggers、steps四个字段； - ZIP 包必须包含
manifest.json（不能是skill.yaml或config.json），且不能解压后手动改名再压缩； - 若从 OpenClaw 社区 GitHub/Gitee 下载，需确认仓库已发布正式 release 版本，master 分支的未打包源码无法直导；
- 使用命令行校验：运行
workbuddy skill validate /path/to/skill.skill.json，返回OK才算过关。
拖拽导入比设置菜单更快，但只支持单文件 JSON
WorkBuddy 主窗口原生支持拖放，这是最快验证技能能否跑通的方式，适合调试阶段快速试错。
- 打开 WorkBuddy 主界面（非设置页），确保已登录且 Claw 运行时正常（可在「Claw 设置」→「运行时版本」中确认 ≥v2.3.0）；
- 将合法的
.skill.json文件直接拖入主窗口中央空白区，松手即触发校验； - 成功时显示绿色提示「导入成功:[技能名称] 已启用」，失败则弹红框，错误码如
ERR_SCHEMA_MISMATCH表示字段缺失，ERR_VERSION_UNSUPPORTED表示mcp_version值过低（当前要求 ≥"1.2"）； - 注意：拖拽不支持 ZIP 包或文件夹，也不支持多选，误拖 ZIP 会静默失败无提示。
导入 ZIP 技能包必须保留原始目录结构
ZIP 包本质是完整执行环境快照，WorkBuddy 解压后会按固定路径查找 manifest.json 和脚本，路径错一位就会变空壳。
- ZIP 内顶层必须直接包含
manifest.json，不能嵌套在src/或dist/子目录下； - Python 技能需含
main.py或指定的entry字段，JS 技能需含index.js，且manifest.json中runtime字段值要匹配（如"python3.11"）； - 导入时点击「Claw 设置」→「技能管理」→「+ 导入本地技能」，选择 ZIP 文件后，系统会显示所需权限（如
read:clipboard）和缺失依赖（如playwright）； - 若导入后调用无响应，大概率是 ZIP 内脚本路径与 manifest 声明不一致，建议用
unzip -l xxx.zip检查结构。
权限和依赖没开，技能就是个图标
很多用户导入成功却调用失败，问题不出在技能本身，而出在操作系统级开关没打开——尤其是 macOS 和 Windows 11 的隐私限制越来越严。
- 导入后务必去系统设置检查：macOS 需在「系统设置」→「隐私与安全性」→「辅助功能」「完全磁盘访问」「屏幕录制」中勾选 WorkBuddy；
- Windows 用户常卡在「剪贴板读取」权限，需进「设置」→「隐私和安全性」→「剪贴板」→「允许应用访问剪贴板」并开启 WorkBuddy；
- 依赖缺失不会阻断导入，但会导致运行时报
Command not found或ModuleNotFoundError，此时要进「Claw 设置」→「依赖管理」勾选对应项（如curl、nodejs、playwright）并点「一键安装」； - 空壳验证最简单：在聊天框输入该技能典型指令（如对
browser-automation输入“打开百度”），看是否真弹浏览器——光看状态栏“已启用”没用。
真正麻烦的从来不是导入动作本身，而是技能背后隐式的系统契约：它默认你已授权、已装好依赖、路径没乱码、签名没过期。漏掉任意一环，WorkBuddy 都不会报错，只会安静地返回“我不懂”。
