这篇是面向新手到进阶用户的 OpenClaw Skills 完整教程。你将一次性掌握：
- Skills 是什么
- 怎么安装（本地 / ClawHub / 插件）
- 怎么查找可用 Skills
- 怎么在 里配置
- 怎么在会话中正确使用
- 常见问题和排障方法
文档参考（官方）：
- https://docs.openclaw.ai/zh-CN/tools/skills
- https://docs.openclaw.ai/zh-CN/tools/creating-skills
- https://docs.openclaw.ai/zh-CN/tools/skills-config
- https://docs.openclaw.ai/zh-CN/tools/clawhub
- https://docs.openclaw.ai/zh-CN/tools/plugin
OpenClaw 的 Skill 本质上是一个目录，核心文件是 （YAML frontmatter + Markdown 指令）。
OpenClaw 会把可用 Skills 注入到智能体上下文，让模型知道：
- 这个 Skill 叫啥
- 能解决什么问题
- 需要什么工具/环境
简单理解：Skill = 给智能体的一份“可调用能力说明书”。
OpenClaw 默认会从这些位置加载 Skills：
- 内置 Skills（随 OpenClaw 发布）
- 托管/本地 Skills：
- 工作区 Skills：
同名冲突时，优先级是：
> > 内置 Skills
另外你还能在配置里加额外目录：
（优先级最低）
这条非常关键，后面你会用它做“共享 Skill 仓库”。
先装 CLI：
搜索：
安装：
更新全部：
默认会安装到当前目录下的 openclaw skills 教程 （也就是工作区技能目录）。安装后开启一个新会话，OpenClaw 就会加载。
如果你不在目标目录执行命令，可以指定：
先建目录：
写 ：
然后重启 Gateway 或开新会话。
插件可以自带 。安装插件后，若插件启用，对应 Skills 也会参与加载。
常见插件命令：
注意：插件和 Gateway 同进程，默认按“受信任代码”处理，只装你信任的来源。
最实用的方式是 ClawHub：
查看当前工作区已安装记录：
如果你想把自己本地 Skills 备份到云端：
所有 Skills 配置都在 节点下。
字段速记：
- ：只对白名单里的“内置 Skills”开放
- ：附加扫描目录（低优先级）
- ：是否监听技能文件变化自动刷新
- ：安装器优先 npm/pnpm/yarn/bun
- ：单 Skill 开关
- ：为该轮智能体运行注入环境变量
- ：和 联动的快捷密钥字段
- ：Skill 的自定义配置容器
默认键名就是 Skill 名称；如果 里定义了 ，以它为准。
OpenClaw 在每次智能体运行开始前注入 ，运行结束后恢复。它不是你系统 shell 的永久环境变量。
大多数情况下，你不需要手动“调用 API”，只要在用户请求中给出明确任务，模型会根据已加载 Skills 自动选择。
但要注意这几个 frontmatter 开关：
- ：是否暴露为用户可触发命令
- ：是否禁止模型自动调用
- ：斜杠命令直接分发到工具
- ：命令分发目标工具
- ：原始参数直传工具
如果你希望一个 Skill 走“命令即工具”，可这样定义。
你可以在 里声明依赖，让 Skill 仅在条件满足时加载。
常用门控字段：
- /
- （）
这对团队环境非常有用，能避免“装了但不可用”的假可用状态。
当智能体跑在 Docker 沙箱里时：
- 宿主机环境变量不会自动带入容器
- 主要作用于宿主机流程
- 需要在 （或 agent 级）单独配置
- 在宿主机会检查，真正执行时容器里也必须有对应二进制
结论：宿主机可用 != 沙箱可用。
按顺序检查：
- 安装目录是否在 或
- 是否有同名 Skill 被更高优先级目录覆盖
- 是否被设为
- 条件是否满足（bin/env/config）
- 是否开启新会话（会话会缓存 Skills 快照）
- 确认
- 确认 不是过大
- 保守做法：开新会话或重启 Gateway
- 看插件是否启用
- 检查
- 检查插件是否声明了 目录
- 修改插件配置后重启 Gateway
- 第三方 Skills 按“不受信任代码”看待，先读
- 对高风险操作启用沙箱隔离
- 不要把密钥写进提示词与日志
- 生产环境尽量固定版本，不要盲目
如果你只记 4 句话：
- 安装首选 ，查找用 。
- 优先级记住： 最高。
- 配置集中在 的 。
- 改完配置或 Skill，最好开新会话验证。
这样你就能把 OpenClaw Skills 稳定地用起来，并逐步构建自己的技能库。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/252994.html原文链接：https://javaforall.net
