OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Створення Skills

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

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

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

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

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

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

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

  • Створіть SKILL.md

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

    markdown
    ---name: hello-worlddescription: Проста навичка, що виводить привітання.--- # Привіт, світе Коли користувач просить привітання, скористайтеся інструментом `exec`, щоб виконати: ```bashecho "Привіт від вашої власної навички!"
    Code
     Правила найменування:- Для `name` використовуйте малі літери, цифри та дефіси.- Назва каталогу та значення `name` у frontmatter мають збігатися.- `description` відображається агенту та під час пошуку команд із похилою рискою —  зберігайте його в одному рядку завдовжки до 160 символів.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSLQn9C10YDQtdC60L7QvdCw0LnRgtC10YHRjywg0YnQviDQvdCw0LLQuNGH0LrRgyDQt9Cw0LLQsNC90YLQsNC20LXQvdC-Ig ```bashopenclaw skills list

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

    bash
    # У чаті — архівувати поточний сеанс і почати новий/new # Або перезапустити Gatewayopenclaw gateway restart

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

    bash
    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} відносно власного каталогу навички:

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

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

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

    markdown
    ---name: gemini-searchdescription: Пошук за допомогою 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:

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

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

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

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

    bash
    # Запропонувати цілком нову навичку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, якщо пропозиція містить допоміжні файли:

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

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

    Після перевірки:

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

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

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

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

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

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

    bash
    npm i -g clawhubclawhub login

  • Опублікуйте

    bash
    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

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

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

    On this page