Створення Skills

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

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

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

Навички зберігаються в папці skills/ вашого робочого простору:

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

Для впорядкування навички можна групувати в підпапках — назва навички все одно визначається у frontmatter файлу SKILL.md, а не шляхом до папки:

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# назва навички все одно "hello-world", викликається як /hello-world

Створіть SKILL.md

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

---
name: hello-world
description: Проста навичка, що виводить привітання.
---

# Привіт, світе

Коли користувач просить привітання, скористайтеся інструментом `exec`, щоб виконати:

```bash
echo "Привіт від вашої власної навички!"

Правила найменування:
- Для `name` використовуйте малі літери, цифри та дефіси.
- Назва каталогу та значення `name` у frontmatter мають збігатися.
- `description` відображається агенту та під час пошуку команд із похилою рискою —
  зберігайте його в одному рядку завдовжки до 160 символів.

</Step>

<Step title="Переконайтеся, що навичку завантажено">
```bash
openclaw skills list

За замовчуванням OpenClaw стежить за файлами SKILL.md у кореневих каталогах навичок. Якщо відстеження вимкнено або ви продовжуєте наявний сеанс, почніть новий, щоб агент отримав оновлений список:

# У чаті — архівувати поточний сеанс і почати новий
/new

# Або перезапустити Gateway
openclaw gateway restart

Протестуйте навичку

openclaw agent --message "привітай мене"

Або відкрийте чат і зверніться безпосередньо до агента. Використовуйте /skill hello-world, щоб явно викликати навичку за назвою.

Довідка щодо SKILL.md

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

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

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

Поле	За замовчуванням	Опис
`user-invocable`	`true`	Надає навичку як користувацьку команду з похилою рискою
`disable-model-invocation`	`false`	Не додає навичку до системного запиту агента (її все одно можна запустити через `/skill`)
`command-dispatch`	—	Установіть `tool`, щоб спрямувати команду з похилою рискою безпосередньо до інструмента в обхід моделі
`command-tool`	—	Назва інструмента, який викликається, коли встановлено `command-dispatch: tool`
`command-arg-mode`	`raw`	Під час спрямування до інструмента передає йому необроблений рядок аргументів
`homepage`	—	URL-адреса, що відображається як “Website” в інтерфейсі Skills для macOS

Поля умов активації (requires.bins, requires.env тощо) описано в розділі Skills — Умови активації.

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

Посилайтеся на файли всередині каталогу навички без жорстко заданих шляхів — агент визначає {baseDir} відносно власного каталогу навички:

Запустіть допоміжний сценарій за шляхом `{baseDir}/scripts/run.sh`.

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

Налаштуйте умови, щоб навичка завантажувалася лише тоді, коли доступні її залежності:

---
name: gemini-search
description: Пошук за допомогою Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---

Параметри умов активації

Ключ	Опис
`requires.bins`	Усі виконувані файли мають бути доступні в `PATH`
`requires.anyBins`	Принаймні один виконуваний файл має бути доступний у `PATH`
`requires.env`	Кожна змінна середовища має існувати в процесі або конфігурації
`requires.config`	Кожен шлях `openclaw.json` повинен мати істинне значення
`os`	Фільтр платформи: `["darwin"]`, `["linux"]`, `["win32"]`
`always`	Установіть `true`, щоб пропустити всі умови й завжди додавати навичку

Повна довідка: Skills — Умови активації.

Середовище та ключі API

Прив’яжіть ключ API до запису навички в openclaw.json:

{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}

Ключ додається до головного процесу лише на час цього ходу агента. Він не потрапляє до пісочниці — див. змінні середовища в пісочниці.

Пропозиція через Майстерню навичок

Для навичок, створених агентом, або якщо перед введенням навички в експлуатацію потрібна перевірка оператором, використовуйте пропозиції Майстерні навичок, а не записуйте SKILL.md безпосередньо.

# Запропонувати цілком нову навичку
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Проста навичка, що виводить привітання." \
  --proposal ./PROPOSAL.md

# Запропонувати оновлення наявної навички
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Оновлена навичка привітання"

Використовуйте --proposal-dir, якщо пропозиція містить допоміжні файли:

openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Проста навичка, що виводить привітання." \
  --proposal-dir ./hello-world-proposal/

У корені каталогу має міститися файл PROPOSAL.md. Допоміжні файли розміщуються в assets/, examples/, references/, scripts/ або templates/. Після перевірки:

openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>

Повний життєвий цикл пропозиції описано в розділі Майстерня навичок.

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

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

Переконайтеся, що встановлено name, description та всі поля умов активації metadata.openclaw. Додайте URL-адресу homepage, якщо маєте сторінку проєкту.

Установіть автономний ClawHub CLI та ввійдіть

npm i -g clawhub
clawhub login

Опублікуйте

clawhub skill publish ./path/to/hello-world

Додайте --version <version> або --owner <owner>, щоб перевизначити визначену версію або опублікувати від імені конкретного власника. Повний процес, області власників та інші команди обслуговування (clawhub sync, clawhub skill rename, …) описано в розділах ClawHub — Публікація і ClawHub CLI.

Пов’язані матеріали

Довідка щодо Skills

Порядок завантаження, умови активації, списки дозволів і формат SKILL.md.

Майстерня навичок

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

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

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

ClawHub

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

Створення плагінів

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

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Створення Skills

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

Довідка щодо SKILL.md

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

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

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

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

Пропозиція через Майстерню навичок

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

Рекомендації

Пов’язані матеріали

Довідка щодо Skills

Майстерня навичок

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

ClawHub

Створення плагінів

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

​Довідка щодо SKILL.md

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

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

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

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

​Пропозиція через Майстерню навичок

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

​Рекомендації

​Пов’язані матеріали

Довідка щодо Skills

Майстерня навичок

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

ClawHub

Створення плагінів

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

Довідка щодо SKILL.md

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

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

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

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

Пропозиція через Майстерню навичок

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

Рекомендації

Пов’язані матеріали