Створення Skills

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

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

​

Створіть свою першу навичку

1. Створіть каталог навички

   Навички розміщуються у вашому робочому просторі. Створіть нову папку:

   mkdir -p ~/.openclaw/workspace/skills/hello-world
   
2. Напишіть 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 навички. Узгоджуйте назву папки та name у frontmatter.

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

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

4. Завантажте навичку

   Запустіть новий сеанс, щоб OpenClaw підхопив навичку:

   # From chat
   /new
   
   # Or restart the gateway
   openclaw gateway restart
   

   Перевірте, що навичку завантажено:

   openclaw skills list
   
5. Протестуйте її

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

   openclaw agent --message "give me a greeting"
   

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

​

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

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

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

​

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

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

​

Де розміщуються навички

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

​

Пов’язане

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