Перейти до основного вмісту

​
Створення Skills

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

​
Створіть свою першу Skill

1

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

Skills живуть у вашому робочому просторі. Створіть нову папку:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

Напишіть SKILL.md

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

# Hello World Skill

Коли користувач просить привітання, використайте інструмент `echo`, щоб сказати
"Hello from your custom skill!".
3

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

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

Завантажте Skill

Запустіть нову сесію, щоб OpenClaw підхопив Skill:
# Із чату
/new

# Або перезапустіть gateway
openclaw gateway restart
Перевірте, що Skill завантажилася:
openclaw skills list
5

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

Надішліть повідомлення, яке має активувати Skill:
openclaw agent --message "give me a greeting"
Або просто поспілкуйтеся з агентом і попросіть привітання.

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

YAML frontmatter підтримує такі поля:
FieldRequiredDescription
nameYesУнікальний ідентифікатор (snake_case)
descriptionYesОднорядковий опис, який показується агенту
metadata.openclaw.osNoФільтр ОС (["darwin"], ["linux"] тощо)
metadata.openclaw.requires.binsNoПотрібні бінарні файли в PATH
metadata.openclaw.requires.configNoПотрібні ключі конфігурації

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

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

​
Де знаходяться Skills

LocationPrecedenceScope
\<workspace\>/skills/НайвищийДля конкретного агента
\<workspace\>/.agents/skills/ВисокийДля агента workspace
~/.agents/skills/СереднійСпільний профіль агента
~/.openclaw/skills/СереднійСпільно (усі агенти)
Bundled (shipped with OpenClaw)НизькийГлобально
skills.load.extraDirsНайнижчийВласні спільні папки

​
Пов’язане