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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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НайнижчийВласні спільні папки

Пов’язане