OpenClaw Skills学习及手搓一个极简skill

作者：CSDN博客
一、基础认知：什么是 OpenClaw Skills？

Skills 是 OpenClaw 中教代理“使用工具”的核心载体，本质是一个包含 SKILL.md 文件的目录——SKILL.md 用 YAML 前置元数据定义技能属性（名称、调用方式等），用正文告诉代理如何执行该技能。

核心作用：让代理具备调用特定工具/完成特定任务的能力（如读取文件、生成图片）；
兼容规范：遵循 AgentSkills + Pi 规范，确保解析器能正确识别。

二、核心规则：Skills 的存储位置与优先级

Skills 的加载位置决定了“哪个版本的技能生效”，是使用/开发技能的基础，优先级从高到低如下：

优先级	位置类型	路径	适用场景
最高	工作区技能	<workspace>/skills	仅当前代理/工作区使用（推荐自定义技能放这里）
中	本地/托管技能	~/.openclaw/skills	本机所有代理共享
低	内置技能	随安装包自带（npm/OpenClaw.app）	基础默认技能
最低	自定义额外目录	skills.load.extraDirs（配置文件）	多代理共享的通用技能包
关键：若同名技能出现在多个位置，高优先级会覆盖低优先级（如工作区的 file-reader 会替换内置的同名技能）。

三、实操1：快速使用现成技能（ClawHub 一键获取）

ClawHub 是 OpenClaw 官方技能注册表，可一键安装/更新第三方技能，无需手动编写，步骤如下：
1. 前置条件

确保已安装 OpenClaw 且终端可执行 clawhub 命令。
2. 核心操作（终端执行）

1. # 1. 安装技能到当前工作区（默认路径：./skills）
2. # 格式：clawhub install <技能唯一标识（slug）>
3. clawhub install nano-banana-pro  # 示例：安装图片生成技能
5. # 2. 更新所有已安装的技能（包括工作区/本地技能）
6. clawhub update --all
8. # 3. 同步本地技能变更（扫描+发布更新到 ClawHub）
9. clawhub sync --all

复制代码

3. 验证生效

安装后重启 OpenClaw 会话，技能会自动加载（工作区技能优先级最高），可通过 2 种方式验证：

用户手动调用：输入 /<技能名>（如 /nano-banana-pro）；
模型自动调用：向代理提问“帮我用 Gemini 3 Pro 生成一张图片”，模型会触发该技能。

4. 或者使用交互界面配置

1. openclaw configure

复制代码

如下图所示：

四、实操2：编写自定义技能（手搓一个极简skill）

若现成技能不满足需求，可自定义编写，以「文件内容查看器」为例，完整步骤如下：
步骤1：创建技能目录结构

每个技能对应独立目录（建议小写+短横线命名），放到 <workspace>/skills 下（最高优先级）：

1. # 目录结构（示例）
2. <workspace>/skills/          # 工作区技能根目录
3. └── file-content-reader/     # 自定义技能目录（与技能名一致）
4.     └── SKILL.md             # 核心文件，必须存在

复制代码

如果skills目录不存在，则手动创建，例如：

1. mkdir-p /home/tht/.openclaw/workspace/skills

复制代码

步骤2：编写 SKILL.md（核心）

SKILL.md 包含「必填 YAML 前置元数据」和「代理执行指令」，以下是可直接复用的示例：
[code]---
name: file-reader
description: 读取文件内容，支持命令格式和自然语言
metadata:
  { "openclaw": { "emoji": "