本文依据2026-11-11核对的官方文档整理,未做本地安装实测;命令与界面以你使用的版本为准。
看到一个有用的 Skill,先别急着复制安装命令。先把三个问题弄清楚:它从哪里来、运行需要什么、会替你做哪些操作。下面以“整理公开文本”为例,说明安装前怎么检查,以及安装后怎样判断结果是否符合需求。
先读说明,确认任务范围
官方文档将文件型 Skill 描述为包含 SKILL.md 的独立目录,文件中有 YAML frontmatter 和 Markdown 正文。它是检查技能说明的入口。
打开说明后,先找用途、输入、输出和依赖。如果你的需求只是把一段文字整理成表格,就应能说清楚输入是哪段文字、输出有哪些列、缺失信息怎么处理。只有“提高效率”“全能助手”等描述,还不足以判断它是否适合当前任务。
编辑建议:同时记录原始项目或技能页面、维护者、准备采用的版本,以及说明中要求执行的步骤。安装命令无法替代这一步;看不懂的依赖或操作,先向维护者确认。
把依赖和操作逐项记下来
OpenClaw 会根据环境、配置和二进制程序是否存在等条件筛选技能。因此,“目录已经放进去”和“当前可以运行”是两件事。
可以先按下面的格式做一张检查表。这里的例子是编辑提供的检查方法,不代表某个特定技能的官方要求。
| 检查项 | 需要记下什么 | 不清楚时怎么办 |
|---|---|---|
| 来源 | 技能页面、原始项目、维护者和版本 | 找到原始出处再继续 |
| 依赖 | 说明中列出的程序、环境变量和配置 | 按技能文档逐项确认 |
| 操作 | 是否读取文件、写入结果或调用外部服务 | 对照自己的任务判断是否必要 |
| 验收 | 一段公开输入和可以人工检查的输出 | 先准备样例,再决定是否安装 |
对于整理公开文本的任务,可以先直接在对话中提供文本。若技能还要求其他输入,应弄清这些输入解决什么问题,而不是为了完成安装把所有提示都点一遍。
确认自己查看的是哪一份技能
官方文档说明,同名文件型技能可能来自多个目录,优先级较高的来源会覆盖较低的来源。其中,工作区的 <workspace>/skills 位于文件型来源优先级的前列。
因此,如果你安装后看到的说明与项目页面不同,先核对技能名称和当前工作区,排查是否已有同名技能。不要同时往多个目录复制相同内容,再靠反复重启判断哪一份生效。
准备安装社区技能时,可从官方 ClawHub 指南 继续查看当前安装流程;自定义技能的文件编写方式见本站的 第一个 Skill 教程。本文聚焦安装前检查,不展开完整安装与更新操作。
安装后,先检查可用性,再验证任务
以下命令来自官方 Skills CLI 文档。它们用于查看和检查技能,不是安装命令:
openclaw skills list
openclaw skills check
需要只查看满足前置条件的技能时,可使用:
openclaw skills list --eligible
官方文档区分“发现技能”“满足运行条件”和“对当前代理可见”。列表里有名字,并不代表依赖已经满足,也不代表当前代理一定会使用它。若检查报告缺少条件,先处理报告中的具体项,再查看结果。
这些检查仍不能代替真实任务验收。对于整理文本类技能,可以使用下面的虚构记录;其他用途的技能应换成对应的公开测试输入。
只根据下面的测试记录,整理“事项、负责人、期限”三列。
没有提供的信息写“待确认”,不要自行补全。
小李负责整理公开产品文档,周五前完成。
小陈负责核对参考链接,截止时间未定。
预期结果示意,不是本次实测记录:
| 事项 | 负责人 | 期限 |
|---|---|---|
| 整理公开产品文档 | 小李 | 周五前 |
| 核对参考链接 | 小陈 | 待确认 |
验收时逐行对照输入:不要把“周五”补成具体日期,也不要替小陈编一个截止时间。如果结果没有遵守要求,先核对任务说明和实际使用的技能,不要把“能够回复”直接当成“已经配置正确”。
什么时候先暂停
编辑建议:来源找不到、依赖解释不清、实际操作超出当前需求,或者公开样例的结果无法核对时,先暂停扩展使用。保留技能名称、采用的来源、检查结果和具体问题,再向维护者确认。
完成这些检查后,再继续安装和配置,或阅读 Skill 自检指南。这样后续遇到问题时,至少能分清是来源、依赖、可见性,还是任务输出本身出了问题。