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 символів. </Step> <Step title="Переконайтеся, що навичку завантажено">```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?