给龙虾装第一个 Skill：从找、装到判断靠不靠谱

Skill 是什么，和 MCP 啥关系

官方 Skills 文档把 Skill 定义为教智能体何时、怎样使用工具的说明，通常放在 SKILL.md 中，目录里还可能有脚本等配套文件。MCP 是连接外部工具服务等资源的协议；Skill 可以指导使用 MCP 工具，也可以使用 OpenClaw 内置工具。比如 browser 是内置工具，不用先装同名 Skill；缺浏览器连接或权限时，装了 Skill 也补不上。

去哪找 Skill

找 Skill 有这几个入口：

• ClawHub：官方文档对它的定义是 OpenClaw skills 和 plugins 的公共注册表。在这里查作者、完整项目标识、版本、说明和安全审计状态。被收录或排在前面，不代表已经适合你的环境。
• 项目的代码托管仓库：阅读 SKILL.md、脚本、依赖与变更记录。
• 本站的 Skills 用途目录：按需求类型列方向，不列具体项目。

装之前怎么看 ClawHub 的安全审计状态

ClawHub 上每个 Skill 的页面在安装前就能看到最近一次安全扫描的状态。官方审计说明把结果分成六种：

这些状态由自动扫描给出。按 2026-10-02 的官方公告，ClawScan 会对每个 skill 或 plugin 分别运行腾讯的 A.I.G 和 NVIDIA 的 SkillSpector 两个扫描器，再由一个 AI 评审结合上传的文件给出最终结论。审计说明同时提醒：审计是很强的安全信号，但不保证某个版本没有风险。

命令行这一侧，官方 Skills CLI 写明：从 ClawHub 安装或更新社区 Skill 时会在下载前检查信任状态，被判恶意或被拦截的版本会被拒绝；结论是 Review 的，会打印审计概览和详情链接后继续安装。想在装之前自己查一次，用 openclaw skills verify，它读取的是 ClawHub 已保存的扫描结果，不会另起一次扫描。verify 默认输出一段 JSON；加 --card 输出排好版的 Skill Card。ClawHub 判定未通过时，命令以非零状态退出。

怎么装：以官方示例 @openclaw/demo 为例

下面是官方 Skills CLI 里从 ClawHub 安装的写法，条目用的是官方 ClawHub 文档自己举的示例 @openclaw/demo。装别的 Skill，把它换成 ClawHub 页面上的完整项目标识，格式是 @owner/<slug>。@openclaw/demo 是官方文档里的示例写法，搜不到就换成你在 ClawHub 上搜到的条目的完整标识。来源是 Git 仓库或本地目录的，写法见同一页 CLI 文档。

# 1. 搜索候选，读项目说明与配套文件
openclaw skills search "calendar"

# 2. 查 ClawHub 已保存的扫描结果
openclaw skills verify @openclaw/demo

# 3. 安装
openclaw skills install @openclaw/demo

# 4. 看清单和缺失依赖
openclaw skills list
openclaw skills check

默认安装目标是当前活动工作区的 skills/，具体是哪个工作区受 agent 和当前目录等条件影响。要装到共享的托管目录，在 install 后加 --global。list/check 查询的是所选 Gateway 的技能清单和就绪状态；隐式本地 Gateway 不可用时可能回退到本地清单，显式指定的远程连接失败时不会改用本地清单。

多 agent 环境可以指定目标，把 YOUR_AGENT_ID 换成你的 agent ID，安装与检查用同一个 agent：

openclaw skills install @openclaw/demo --agent YOUR_AGENT_ID
openclaw skills list --agent YOUR_AGENT_ID
openclaw skills check --agent YOUR_AGENT_ID

留着安装命令的输出，按项目文档补齐必要依赖与配置；遇到安装或权限拦截先查明原因，不用强制参数绕过，--force 和确认警告的参数也越不过安装策略的 block。技能是否加载还受禁用状态、允许列表、环境和会话刷新规则影响。问模型“你会哪些技能”不能确认安装成功，要看它实际调了哪些工具、产出了什么文件。

怎么判断一个 Skill 值不值得装

装之前看这几样：

• 版本：说明是否覆盖你的 OpenClaw 版本，已知问题是否影响任务。
• 它会动什么：说明或脚本会调用哪些工具、读写哪些路径、向哪里发送数据；文件写入、命令执行和凭证范围应能对应到任务。
• 作者和问题记录：看作者和项目文件，读可复现的问题记录；star 数、搜索排名和目录分类都不能替代审查。
• 依赖和输出：要哪些程序、服务和安装步骤，出错怎么处理、结果存成什么格式、什么情况下停。

Skill 列表不是独立的权限沙箱。按官方文档，限制哪些 Skill 可见，并不限制宿主 shell 的权限：没有加载某个 Skill，已开放的工具照样能执行相关操作。限制要落在工具允许/拒绝策略、执行审批、沙箱、挂载及凭证范围上，配法见沙箱、白名单和网关认证怎么配。

Skill Workshop 和 skills library 是什么，新手要不要管

从 ClawHub 装只是 Skill 的来源之一，另外两个入口在 2026 年 9 月的版本里有变动。

Skill Workshop 是 agent 自己攒技能的地方：agent 发现可复用的做法时先写成提案，提案在 apply 之前不算生效的技能。2026.9.3 这一版（更新记录）改了归属：原先 Workshop 技能跟着工作区走，现在每个 agent 有一个自己可写的 Workshop 集合，跨工作区保留。更新记录把它标为 Breaking，旧技能在启动时或运行 openclaw doctor --fix 时迁移，归属判断不了的留在原处等你处理。按官方 Skills 文档，它的目录是 <state-dir>/agents/<agentId>/agent/workshop-skills，加载优先级排在工作区 skills/ 和托管目录之后。提案用这几条命令看和处理：

openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>

skills library 是 2026.9.1 新增的个人技能库，命令是 openclaw skills library。它面向多人共用的 Gateway：每个人在工作区那一套之外留一份自己的技能，可以从 ZIP 包导入，也可以按身份分享给同一个 Gateway 上的其他人。

只在自己电脑上装第一个 Skill，这两样都可以先放着：Workshop 里没有提案就不用处理，个人技能库是给多人共用一个 Gateway 的情况准备的。

装完怎么检查：先看它是否就绪，再按用途跑一个小任务

先看刚装的那一条。openclaw skills list 里要能找到它；openclaw skills check 把结果分成三层：找到了没有、它声明的前置条件满足没有、当前 agent 看不看得见。它被列在 Missing requirements 下面时，按提示把缺的程序或配置补上，再查一遍。

清单没问题以后，打开它的 SKILL.md，看它写明是做什么用的，照这个用途给龙虾一条小任务，数据用不敏感的。清单只说明装没装上、就绪没有；任务做完，自己打开产出的文件，看它调了哪些工具、结果对不对。

装的是抓网页类 Skill 时这样试：浏览器工具已连接、依赖可用以后，选一个无需登录、允许访问的公开页面，让它把指定区域前五条标题和链接存成一个新的 CSV 文件，再逐条对照来源页面。动态页面可能有分页、懒加载或虚拟列表，等待或滚动不保证拿到全量。任务里写明页数、条数与等待时间，遇到验证码、限流或访问拒绝就停，让它说明抓到了哪些、缺了哪些。任务原文和逐条对照的办法见《用 OpenClaw 抓网页：内置 browser 工具怎么用，要不要另装 Skill》；换了 Skill、工具或配置，再试一遍。

常见问题

Skill 和 MCP 有什么区别？

Skill 是指导智能体何时、怎样使用工具的说明，通常以 SKILL.md 和配套文件提供。MCP 是连接外部工具服务等资源的协议。Skill 可以指导使用 MCP 或内置工具，但安装说明不会自动补齐工具、连接、依赖和权限。

装 Skill 会不会有安全风险？

有。说明和配套脚本可能引导工具读取文件、联网或执行命令。Skill 列表不是独立的权限沙箱，安装或隐藏 Skill 都不等于授予或撤销工具权限。看清来源与依赖，把限制落在工具策略、执行审批、沙箱、挂载和凭证上，再用无敏感数据的小任务试一遍。

装了一个 Skill 没生效怎么办？

先确认目标工作区、agent 和 Gateway 没选错，再看安装命令的输出、openclaw skills list 与 openclaw skills check 的结果，检查禁用状态、允许列表、依赖和配置。清单缺项除了路径错，也可能是连接或加载条件没满足。最后让它实际跑一个小任务，看工具调用和输出文件。

ClawHub 上标着 Warn 或 Malicious 的 Skill 还能装吗？

Malicious 不要装：审计说明对这一档写的就是不要安装，被判恶意或被拦截的社区版本也会被 openclaw skills install 拒绝。Warn 表示发现了影响较大的问题或警示信号，要格外小心；点进审计详情读具体发现，对照 SKILL.md 和配套脚本，看不懂或和任务对不上就换一个。