Навыки (skills) в OpenClaw: как создавать и управлять скиллами агента

· 7 мин чтения

Навыки (skills) в OpenClaw — это готовые инструкции, которые расширяют возможности агента без написания кода. Каждый навык — это markdown-файл с описанием того, как делать что-то конкретное: ревьюить код, управлять сервером, работать с API. В отличие от плагинов, навыки не требуют программирования — достаточно написать пошаговое руководство, и агент начнёт ему следовать.

Что такое навык (skill) в OpenClaw

Skill (навык) — это директория с файлом SKILL.md, который содержит инструкции для агента. OpenClaw загружает навыки в системный промпт, и агент следует им при выполнении задач. Навык не добавляет новый код в систему — он добавляет знание.

Структура навыка:

my-skill/
├── SKILL.md          # основной файл с инструкциями
├── scripts/          # опциональные скрипты
└── resources/        # опциональные ресурсы

Файл SKILL.md начинается с YAML-фронтматтера:

---
name: my-skill
description: "Краткое описание того, что делает навык"
version: 1.0.0
author: Your Name
license: MIT
metadata:
  tags: [tag1, tag2]
---

После фронтматтера идёт тело навыка — markdown с инструкциями, примерами и пошаговыми сценариями. Агент читает эти инструкции и следует им при выполнении соответствующих задач.

Чем навыки отличаются от плагинов

В OpenClaw есть два механизма расширения: навыки (skills) и плагины (plugins). Они решают разные задачи.

Навыки — это инструкции для агента. Markdown-файлы, которые говорят агенту, как делать что-то. Не требуют программирования, не добавляют новый функционал в систему. Примеры: «как проводить code review», «как настраивать VPN», «как работать с Jira».

Плагины — это npm-пакеты, которые добавляют в OpenClaw новый код: провайдеры моделей, каналы, инструменты, HTTP-эндпоинты. Плагин — это программный модуль, который регистрируется через Plugin SDK.

Характеристика Навыки (Skills) Плагины (Plugins)
Формат Markdown-файл SKILL.md npm-пакет с TypeScript
Что делает Инструкции для агента Новый код и функционал
Программирование Не нужно Обязательно
Установка openclaw skills install openclaw plugins install
Распространение ClawHub, git-репозитории ClawHub, npm
Примеры Руководства, чек-листы, API-рецепты Провайдеры, каналы, инструменты

В большинстве случаев начинать стоит с навыков. Они проще в создании, не требуют знания TypeScript и покрывают 80% сценариев расширения агента. Плагины нужны, только если вы хотите добавить genuinely новый функционал — например, канал для мессенджера, которого нет в OpenClaw из коробки.

Как установить готовый навык

OpenClaw имеет маркетплейс ClawHub с более чем 15 000 навыков. Установка одной командой:

openclaw skills install clawhub:my-skill

Посмотреть установленные навыки:

openclaw skills list

Обновить все навыки:

openclaw skills update

Также навыки можно установить из git-репозитория или скопировать директорию вручную в папку skills/ профиля агента.

Как создать свой навык: пошаговое руководство

Шаг 1. Определите задачу

Подумайте, какую повторяющуюся задачу вы хотите автоматизировать. Хорошие кандидаты:

  • Работа с конкретным API (отправка запросов, парсинг ответов)
  • Code review по определённым правилам
  • Деплой на конкретный сервер
  • Генерация отчётов в определённом формате
  • Работа с внутренними инструментами компании

    • Шаг 2. Создайте структуру

    mkdir -p my-skill
touch my-skill/SKILL.md

    Шаг 3. Напишите SKILL.md

    Фронтматтера (YAML между ---):

    ---
name: deploy-to-production
description: "Деплой проекта на production-сервер через SSH"
version: 1.0.0
author: Your Name
metadata:
  tags: [deploy, ssh, production]
---

    Тело — пошаговые инструкции. Пишите так, как если бы объясняли коллеге:

    # Деплой на production


    Подключение
    
ssh deploy@production.example.com


    Шаги деплоя
    

  • Перейти в директорию проекта: cd /var/www/app
    • 

  • Обновить код: git pull origin main
    • 

  • Установить зависимости: npm ci --production
    • 

  • Собрать проект: npm run build
    • 

  • Перезапустить сервис: pm2 restart app
    • 


    Проверка
    
curl -s https://production.example.com/health | jq .

    Шаг 4. Протестируйте

    Установите навык локально и проверьте, что агент корректно его использует:

    openclaw skills install ./my-skill

    Откройте сессию и попросите агента выполнить задачу, для которой предназначен навык. Агент должен загрузить инструкции из SKILL.md и следовать им.

    Шаг 5. Опубликуйте (опционально)

    Если навык полезен другим, опубликуйте в ClawHub:

    clawhub package publish your-org/my-skill

    Как навыки загружаются в агента

    OpenClaw использует механизм skill_view для эффективной загрузки навыков. Работает это в два уровня:

  • Нулевой уровень — агент видит только имя и описание каждого навыка (~3000 токенов на все навыки). Этого достаточно, чтобы понять, какой навык нужен для задачи.
  • Полный контекст — когда агент определяет, что навык нужен, он загружает полное содержимое SKILL.md через инструмент чтения. Это экономит токены: агент не загружает 15 000 навыков одновременно, а выбирает нужный по запросу.

    • Начиная с версии OpenClaw v2026.5.20, файлы навыков загружаются через инструмент чтения, а не через exec. Это улучшило безопасность: только настоящий исполняемый файл навыка автоматически разрешается.

    Практические примеры навыков

    Пример 1: Навык для работы с API

    ---
name: jira-api
description: "Создание и обновление задач в Jira через REST API"
---

    Тело навыка содержит: базовый URL, аутентификацию, примеры curl-запросов для создания задачи, обновления статуса, добавления комментариев. Агент, получив запрос «создай задачу в Jira», загружает навык и выполняет точные шаги.

    Пример 2: Навык для code review

    ---
name: code-review-checklist
description: "Чек-лист для ревью кода: безопасность, производительность, стиль"
---

    Тело содержит: критерии проверки (SQL-инъекции, XSS, N+1 запросы), формат отчёта, примеры хороших и плохих паттернов.

    Пример 3: Навык для мониторинга

    ---
name: server-health-check
description: "Проверка здоровья сервера: CPU, RAM, диск, сервисы"
---

    Тело содержит: команды для проверки (top, df -h, systemctl status), пороговые значения, формат отчёта.

    Управление навыками: CLI-команды

    Все команды для работы с навыками начинаются с openclaw skills:

    Команда Что делает
    openclaw skills list Показать все установленные навыки
    openclaw skills install Установить навык из ClawHub или пути
    openclaw skills update Обновить все навыки

    Диагностика навыков встроена в команду openclaw doctor — она проверяет статус навыков и плагинов и сообщает о проблемах.

    Навыки и мультиагентность

    В OpenClaw каждый агент имеет свою директорию skills/. Это значит, что разные агенты могут иметь разные наборы навыков. Агент для рабочего Slack может иметь навыки для Jira и GitHub, а агент для личного Telegram — навыки для управления умным домом.

    Для управления несколькими агентами используйте:

    openclaw agents list
openclaw agents add my-agent

    Каждый агент получает свою директорию с workspace, skills и конфигурацией.

    Навыки на платформе Neirohost

    Если вы используете [Neirohost](https://neirohost.ru) — платформу AI-ассистентов на базе OpenClaw — навыки работают точно так же. Neirohost предоставляет LXC-контейнер с Ubuntu и предустановленным OpenClaw, SSH-доступ есть. Вы можете управлять навыками через SSH, как на обычном VPS. Плагины и навыки работают на всех тарифах без ограничений.

    FAQ

    Сколько навыков может быть установлено одновременно?

    Технических ограничений нет. OpenClaw загружает навыки по требованию через skill_view, поэтому даже 1000 навыков не перегрузят системный промпт. На практике большинство пользователей имеют 10–30 навыков.

    Навыки заменяют system prompt?

    Нет. Навыки дополняют system prompt. Файлы SOUL.md и AGENTS.md определяют личность и общие правила агента, а навыки добавляют конкретные инструкции для特定ных задач. Навыки загружаются по мере необходимости, а SOUL.md и AGENTS.md — всегда.

    Можно ли использовать навыки без подключения к интернету?

    Да. Навыки — это локальные markdown-файлы. Они не требуют подключения к интернету для работы. Установка из ClawHub требует интернета один раз, после чего навык хранится локально.

    Как удалить навык?

    Удалите директорию навыка из папки skills/ профиля агента. После перезапуска сессии агент перестанет его использовать.

    Навыки работают с локальными моделями (Ollama)?

    Да. Навыки — это просто инструкции в формате markdown. Любая модель, которая понимает инструкции в системном промпте, будет следовать навыкам. Качество выполнения зависит от_capabilities модели.