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

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

1

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

Skills зберігаються у папці skills/ вашого робочого простору. Створіть каталог для своєї нової навички:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Для організації можна групувати Skills у підпапках — назву навички все одно визначає frontmatter у SKILL.md, а не шлях до папки:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Напишіть SKILL.md

Створіть SKILL.md усередині каталогу. Frontmatter визначає метадані; тіло надає агенту інструкції.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Правила іменування:
- Використовуйте малі літери, цифри та дефіси для `name`.
- Узгоджуйте назву каталогу та `name` у frontmatter.
- `description` показується агенту та у виявленні slash-команд —
  тримайте його в один рядок і до 160 символів.

</Step>

<Step title="Перевірте, що навичку завантажено">
```bash
openclaw skills list
OpenClaw типово відстежує файли SKILL.md під коренями Skills. Якщо спостерігач вимкнений або ви продовжуєте наявну сесію, почніть нову, щоб агент отримав оновлений список:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

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

Надішліть повідомлення, яке має активувати навичку:
openclaw agent --message "give me a greeting"
Або відкрийте чат і зверніться до агента напряму. Використовуйте /skill hello-world, щоб явно викликати її за назвою.

​
Довідник SKILL.md

​
Обов’язкові поля

ПолеОпис
nameУнікальний slug із малих літер, цифр і дефісів
descriptionОднорядковий опис, який показується агенту та у виводі виявлення

​
Необов’язкові ключі frontmatter

ПолеТиповоОпис
user-invocabletrueПоказувати навичку як користувацьку slash-команду
disable-model-invocationfalseНе включати навичку до системного prompt агента (вона все ще запускається через /skill)
command-dispatch—Встановіть tool, щоб спрямувати slash-команду безпосередньо до інструмента, оминаючи модель
command-tool—Назва інструмента для виклику, коли встановлено command-dispatch: tool
command-arg-moderawДля dispatch до інструмента передає сирий рядок аргументів інструменту
homepage—URL, що показується як “Вебсайт” в інтерфейсі Skills macOS
Для полів gating (requires.bins, requires.env тощо) див. Skills — Gating.

​
Використання {baseDir}

Використовуйте {baseDir} у тілі навички, щоб посилатися на файли всередині каталогу навички без жорстко заданих шляхів: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
Додавання умовної активації

Обмежте навичку так, щоб вона завантажувалася лише тоді, коли доступні її залежності: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
КлючОпис
requires.binsУсі виконувані файли мають існувати в PATH
requires.anyBinsПринаймні один виконуваний файл має існувати в PATH
requires.envКожна змінна env має існувати в процесі або конфігурації
requires.configКожен шлях openclaw.json має бути truthy
osФільтр платформи: ["darwin"], ["linux"], ["win32"]
alwaysВстановіть true, щоб пропустити всі gates і завжди включати навичку
Повний довідник: Skills — Gating.
Прив’яжіть ключ API до запису навички в openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
Ключ вводиться в процес host лише для цього ходу агента. Він не потрапляє до sandbox — див. sandboxed env vars.

​
Запропонуйте через Skill Workshop

Для Skills, підготовлених агентом, або коли потрібен перегляд оператором перед тим, як навичка стане активною, використовуйте пропозиції Skill Workshop замість безпосереднього написання SKILL.md. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
Використовуйте --proposal-dir, коли пропозиція містить допоміжні файли: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
Каталог має містити PROPOSAL.md. Допоміжні файли можна розміщувати в assets/, examples/, references/, scripts/ або templates/. Після перегляду: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Див. Skill Workshop, щоб ознайомитися з повним життєвим циклом пропозиції.

​
Публікація в ClawHub

1

Переконайтеся, що ваш SKILL.md повний

Переконайтеся, що name, description і будь-які поля gating metadata.openclaw задані. Додайте URL homepage, якщо у вас є сторінка проєкту.
2

Встановіть навичку ClawHub

Навичка ClawHub документує поточну форму команди публікації та потрібні метадані:
openclaw skills install @openclaw/clawhub-publish
3

Опублікуйте

clawhub publish
Див. ClawHub — Публікація, щоб ознайомитися з повним процесом.

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

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

​
Пов’язане

Довідник Skills

Порядок завантаження, gating, allowlists і формат SKILL.md.

Skill Workshop

Черга пропозицій для Skills, підготовлених агентом.

Конфігурація Skills

Повна схема конфігурації skills.*.

ClawHub

Переглядайте та публікуйте Skills у публічному реєстрі.

Створення plugins

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