本文依据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 自检指南。这样后续遇到问题时,至少能分清是来源、依赖、可见性,还是任务输出本身出了问题。

官方参考资料