AI创想

标题: OpenClaw Skills学习及手搓一个极简skill [打印本页]

作者: AI小编 时间: 昨天 22:59
标题: OpenClaw Skills学习及手搓一个极简skill
作者：CSDN博客
一、基础认知：什么是 OpenClaw Skills？

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

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

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

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

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

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

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

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

复制代码

3. 验证生效

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

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

openclaw configure

复制代码

如下图所示：

(, 下载次数: 0)

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

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

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

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

复制代码

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

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

复制代码

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

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

欢迎光临 AI创想 (https://llms-ai.com/)