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. # 1. 安装技能到当前工作区(默认路径:./skills)
  2. # 格式:clawhub install <技能唯一标识(slug)>
  3. clawhub install nano-banana-pro  # 示例:安装图片生成技能
  4. # 2. 更新所有已安装的技能(包括工作区/本地技能)
  5. clawhub update --all
  6. # 3. 同步本地技能变更(扫描+发布更新到 ClawHub)
  7. clawhub sync --all
复制代码
3. 验证生效

安装后重启 OpenClaw 会话,技能会自动加载(工作区技能优先级最高),可通过 2 种方式验证:
4. 或者使用交互界面配置
  1. openclaw configure
复制代码
如下图所示:

(, 下载次数: 0)


四、实操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": "




欢迎光临 AI创想 (https://llms-ai.com/) Powered by Discuz! X3.4