skills是openclaw官方定义的核心能力单元，具备声明式配置、安全审计与权限管控；plugins则是非官方旧式扩展，无元数据、不参与安全流程且已被淘汰。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在配置 OpenClaw 时发现部分功能被称作 “Skills”，另一些则标为 “Plugins”，却难以分辨二者在系统中的角色与行为边界，则可能是由于官方术语演进与社区用法混杂所致。以下是厘清 OpenClaw 中 Skills 与 Plugins 本质差异的步骤：
一、概念起源与命名权属
OpenClaw 官方自 2026 年起统一采用 “Skill” 作为核心能力单元的标准术语，其定义已写入 v2026.3.x 系列文档规范：Skill 是一段封装了明确目标、输入输出、执行逻辑与工具调用规则的可复用能力单元，由智能体自主加载、调度与执行。而 “Plugin” 并非 OpenClaw 原生架构中的正式概念，它源于早期用户对第三方扩展模块的习惯性称呼，或受其他框架（如 VS Code、Obsidian）术语迁移影响。
1、查看当前运行环境的 clawhub.json 文件路径，确认是否位于 ~/.openclaw/skills/ 目录下；
2、执行命令 openclaw list --verbose，观察输出中所有条目是否均标注为 type: skill 而非 plugin；
3、检查任意技能目录内的元数据文件，确认是否存在 skill.yaml（必需），而非 plugin.json 或类似命名。
二、技术形态与载体结构
Skills 以 Markdown 文件为核心载体，辅以声明式 YAML 配置，构成“文档即能力”的轻量结构；该设计使技能具备可读性、可审计性与低门槛修改能力。Plugins 若存在，通常指未经 Skill 规范重构的旧式脚本包，缺乏元数据描述、依赖声明与安全沙箱约束，无法被 Skill-Vetter 安全审计模块识别。
1、打开一个典型 Skill 目录，确认包含 README.md（功能说明）、skill.yaml（元数据与依赖声明）、main.py 或 action.sh（执行体）；
2、对比一个疑似 Plugin 的目录，检查其是否仅有单一可执行文件且无 YAML 元数据，或依赖硬编码路径（如 /usr/local/bin/xxx）；
3、运行 openclaw audit --target=your_module_name，若返回 "No skill.yaml found"，则该模块未被识别为 Skill。
三、加载机制与执行权限
Skills 在启动时由 OpenClaw 内核按 YAML 中声明的依赖自动校验并加载，支持权限隔离、执行超时控制与结果校验闭环；而 Plugins 若强行注入，将绕过 ReAct 引擎的“思考-行动”调度链，直接以当前用户权限执行，存在高风险操作失控可能。
1、在 skill.yaml 中确认是否存在 permissions: 字段，其值应为明确列出的权限项（如 filesystem:read, network:post）；
2、启动 OpenClaw 时添加 --log-level debug 参数，观察日志中是否出现 "Loaded skill 'xxx' with permissions [...]"；
3、尝试手动执行疑似 Plugin 的脚本，检查其是否调用 openclaw-runtime 环境变量或依赖 clawlib 模块——缺失则表明其未接入 Skill 执行上下文。
四、安全治理与生命周期管理
Skills 受 Skill-Vetter 插件全程监管：安装前扫描恶意代码、运行时限制高风险 API、异常时自动隔离；而 Plugins 不参与此流程，一旦启用即获得与主进程等同的信任等级，国家互联网应急中心 3 月 10 日预警中提及的密钥泄露与误删事件，均与未经 Skill 规范封装的插件直接相关。
1、确认系统中已启用 Skill-Vetter，方法为检查 ~/.openclaw/config.yaml 中 security.audit_enabled: true；
2、执行 openclaw install https://clawhub.dev/skill/tavily-search 类命令，观察终端是否输出 "Vetting passed"；
3、将一个未经签名的 Shell 脚本放入 skills/ 目录后重启服务，确认 OpenClaw 是否报错并拒绝加载，错误信息应含 "signature validation failed"。
五、社区生态与分发标准
ClawHub 官方技能市场仅接受符合 v2026.3.x Skill 规范的提交，所有上架 Skill 均通过 Tavily Web Search 验证来源可信度，并嵌入数字签名；而 Plugins 多散落于 GitHub 非官方仓库或 Telegram 群组，缺乏版本锚定、更新通知与兼容性声明，OpenClaw 升级至 2026.3.22+ 后大量失效的“微信插件假活”问题，根源即在于其仍沿用旧 Plugin 架构，未适配新版 Skill 的权限模型与消息路由协议。
1、访问 https://clawhub.dev，筛选任意 Skill 页面，确认 URL 路径含 /skill/ 且页面底部显示 Signed by ClawHub CA v3；
2、在本地执行 openclaw find --keyword=wechat，比对返回结果中各条目的 source 字段是否全部指向 clawhub.dev 域名；
3、检查本地 ~/.openclaw/skills/ 下任一 Skill 的 .clawsig 文件是否存在且非空，缺失则表明该技能未通过官方签名认证。
