Skills

Створення Skills

Skills навчають агента, як і коли використовувати інструменти. Кожен skill — це каталог, що містить файл SKILL.md із YAML frontmatter та markdown-інструкціями.

Про те, як skills завантажуються та пріоритизуються, див. Skills.

Створіть свій перший skill

Створіть каталог skill

Skills зберігаються у вашому робочому просторі. Створіть нову папку:

mkdir -p ~/.openclaw/workspace/skills/hello-world

Напишіть SKILL.md

Створіть SKILL.md у цьому каталозі. Frontmatter визначає метадані, а markdown-тіло містить інструкції для агента.

---
name: hello-world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".

Використовуйте hyphen-case з малими літерами, цифрами та дефісами для name skill. Узгоджуйте назву папки та name у frontmatter.

Додайте інструменти (необов’язково)

Ви можете визначити власні схеми інструментів у frontmatter або вказати агенту використовувати наявні системні інструменти (наприклад, exec чи browser). Skills також можуть постачатися всередині plugins поруч з інструментами, які вони документують.

Завантажте skill

Почніть нову сесію, щоб OpenClaw підхопив skill:

# From chat
/new

# Or restart the gateway
openclaw gateway restart

Перевірте, що skill завантажено:

openclaw skills list

Протестуйте його

Надішліть повідомлення, яке має активувати skill:

openclaw agent --message "give me a greeting"

Або просто поспілкуйтеся з агентом і попросіть привітання.

Довідник метаданих skill

YAML frontmatter підтримує такі поля:

Поле	Обов’язкове	Опис
`name`	Так	Унікальний ідентифікатор із малими літерами, цифрами та дефісами
`description`	Так	Однорядковий опис, який показується агенту
`metadata.openclaw.os`	Ні	Фільтр ОС (`["darwin"]`, `["linux"]` тощо)
`metadata.openclaw.requires.bins`	Ні	Обов’язкові виконувані файли в PATH
`metadata.openclaw.requires.config`	Ні	Обов’язкові ключі конфігурації

Найкращі практики

Будьте лаконічними — інструктуйте модель, що робити, а не як бути ШІ
Безпека передусім — якщо ваш skill використовує exec, переконайтеся, що prompts не допускають довільної ін’єкції команд із ненадійного вводу
Тестуйте локально — використовуйте openclaw agent --message "..." для тестування перед поширенням
Використовуйте ClawHub — переглядайте skills і долучайте їх на ClawHub

Де зберігаються skills

Розташування	Пріоритет	Область дії
`\<workspace\>/skills/`	Найвищий	Для окремого агента
`\<workspace\>/.agents/skills/`	Високий	Для агента робочого простору
`~/.agents/skills/`	Середній	Спільний профіль агента
`~/.openclaw/skills/`	Середній	Спільно (усі агенти)
Вбудовані (постачаються з OpenClaw)	Низький	Глобальна
`skills.load.extraDirs`	Найнижчий	Власні спільні папки

Пов’язане

Довідник Skills — правила завантаження, пріоритету та gating
Конфігурація Skills — схема конфігурації skills.*
ClawHub — публічний реєстр skills
Створення Plugins — plugins можуть постачати skills

# Створіть свій перший skill