Система Skills

OpenClaw v2026.3.24 представил нативную систему Skills, которая даёт агентам детерминированные, переиспользуемые рабочие процессы. Skills хранятся как файлы SKILL.md в рабочем пространстве каждого агента и автоматически загружаются runtime'ом. Они дополняют SOUL.md: если SOUL.md определяет, кем агент является, skill определяет, как он выполняет конкретный процесс.

—

Как работают Skills

Каждый skill — это один файл SKILL.md с YAML frontmatter и markdown-телом:

---
name: my-skill
description: One-line summary of what this skill does and when to use it.
---

# Skill Name

## Instructions

Step-by-step process the agent follows when this skill is active.

Соглашение о путях:

agents/<agent>/skills/<skill-name>/SKILL.md

Skills также могут включать поддиректорию references/ для вспомогательных документов, которые агент должен читать при использовании skill:

agents/<agent>/skills/<skill-name>/
├── SKILL.md
└── references/
    ├── checklist.md
    └── examples.md

Загрузка: OpenClaw читает все файлы SKILL.md в директории skills/ агента при старте сессии. Агент воспринимает инструкции skill как высокоприоритетный контекст: skills переопределяют общее поведение, когда совпадают их условия срабатывания.

—

Маркетплейс ClawHub

ClawHub — это маркетплейс Skills для OpenClaw. Просматривайте навыки сообщества и официальные навыки, затем устанавливайте их прямо в workspace агента.

Установка в один клик: В Control UI выберите агента, просмотрите доступные Skills и нажмите «Install». OpenClaw скачает пакет Skill и автоматически поместит его по правильному пути.

Рецепты установки могут включать:

• Skills-предпосылки (устанавливаются как зависимости)
• Обязательные API-ключs (запрашиваются во время настройки)
• Значения конфигурации (запрашиваются во время настройки)

—

Control UI

Управляйте skills для каждого агента через OpenClaw Control UI.

Вкладки фильтра статуса:

| Вкладка | Значение |
|-----|---------|
| All | Каждый установленный skill |
| Ready | Полностью настроен и активен |
| Needs Setup | Установлен, но не хватает API-ключей или конфигурации |
| Disabled | Установлен, но выключен |

Каждая вкладка показывает бейдж с количеством. Клик по skill открывает окно деталей с:

• Описанием skill и версией
• Требованиями настройки (API-ключами, полями конфигурации)
• Переключателем включения/выключения
• Опцией удаления

Ввод API-ключ: Когда skill требует ключ внешнего сервиса, окно деталей предоставляет поле ввода. Ключи безопасно хранятся в хранилище агента — никогда не в файле SKILL.md или директории workspace.

—

Управление через CLI

Используйте CLI для скриптового или headless-управления skills.

openclaw skills list

Выводит список всех Skills по всем агентам со статусом (Ready / Needs Setup / Disabled).

openclaw skills info <skill-name>

Показывает подробную информацию о конкретном skill: description, version, prerequisites, required API-ключs, install path и current status.

Подсказки по настройке:

openclaw skills info research-intel

Вывод включает любую отсутствующую конфигурацию и точные шаги, чтобы перевести skill в Ready. Следуйте подсказкам, чтобы ввести API-ключs или задать required values.

—

Создание пользовательских Skills

Формат Frontmatter

---
name: lowercase-with-hyphens
description: One sentence. What the skill does and when to trigger it.
---

name должен совпадать с именем директории. description используется Control UI и CLI для отображения.

Обязательные разделы

Хорошо структурированный SKILL.md включает:

| Раздел | Назначение |
|---------|---------|
| Заголовок + введение | Что делает этот skill |
| Условия срабатывания | Когда агент должен активировать этот skill |
| Пошаговый процесс | Нумерованный рабочий процесс для выполнения |
| Формат вывода | Точная структура результатов |
| Правила эскалации | Когда остановиться и эскалировать |

Соглашение о references/

Переносите длинный контент из SKILL.md в references/:

skills/<skill-name>/
├── SKILL.md              # Concise instructions (under 200 lines ideal)
└── references/
    ├── examples.md       # Sample outputs
    ├── glossary.md       # Domain terms
    └── шаблоны.md      # Reusable formats

Ссылайтесь на них из SKILL.md относительными путями, например: См. ссылки/примеры.md для примеров вывода.

—

Использование шаблонов из этого репозитория

Директория шаблоны/skills/ включает семь готовых skills:

| Шаблон | Агент | Назначение |
|----------|-------|---------|
| `coding-handoff` | Coder, QA, DevOps | Handoff'ы веток/PR со статусами ACK/DONE/BLOCKED |
| `research-intel` | Researcher | Обзор рынка с оценкой уверенности |
| `leadgen-qualification` | Lead Gen | ICP-оценка и обогащение лидов |
| `content-repurpose` | Content | Варианты контента для разных платформ |
| `ops-triage` | Ops | Маршрутизация приоритетов inbox/calendar/task |
| `telegram-topic-настройке` | Orchestrator | Автоматическое создание Telegram topics и привязка агентов |
| `acpx-session` | Coder | Управление ACPX-сессиями для делегирования subagent для кодинга'ам |

Эти шаблоны появились раньше нативной системы Skills, но используют тот же YAML frontmatter и markdown-формат, поэтому полностью совместимы.

Чтобы использовать шаблон:

1. Скопируйте директорию skill в workspace вашего агента:

   cp -r шаблоны/skills/coding-handoff ~/.openclaw/workspace/agents/coder/skills/

1. При необходимости настройте frontmatter name и description.
2. Добавьте любой контент, специфичный для роли, в references/.
3. Перезапустите или перезагрузите агента — skill появится в Control UI и CLI.

Заметки о совместимости: Эти шаблоны следуют тому же соглашению о путях (agents/<agent>/skills/<skill-name>/SKILL.md) и схеме frontmatter, которых ожидает нативная система. Конвертация не нужна. Полный список и инструкции по использованию см. в шаблоны/skills/README.md.

—

Интеграция Skills в агентов

Skills упоминаются в SOUL.md, чтобы агент знал, когда их активировать.

В разделе Shared Context или How I Work файла SOUL.md добавьте:

## Skills

- **coding-handoff** — Use for all branch handoffs to QA and DevOps
- **research-intel** — Use for any market intelligence request

Когда agents используют skills, а когда — общие инструкции:

| Используйте Skill | Используйте SOUL.md |
|-------------|-------------|
| Повторяющийся многошаговый рабочий процесс | Разовое или ситуативное поведение |
| Требуется строгий формат вывода | Гибкий или разговорный вывод |
| Общее для нескольких агентов | Уникально для одного агента |
| Нужны собственные ссылки/примеры | Достаточно просто описать в тексте |
| Есть зависимости от внешних API | Чистые задачи на рассуждение |

Рекомендации по написанию эффективных файлов SOUL.md см. в agent-design-patterns.md.

—

Соображения безопасности

Управление API-ключ: Skills, которым нужны внешние ключи (например, доступ к CRM, аналитические API), хранят их в secure хранилище агента — никогда в SKILL.md или файлах workspace. Control UI и CLI обрабатывают ввод ключей, не раскрывая значения.

Проверка источника установки: OpenClaw проверяет метаданные установщиков Skill по строгим allowlist’ы регулярных выражений. URL проверяются по allowlist’ы протоколов (только HTTPS). Это предотвращает выполнение произвольного кода из недоверенных источников.

Последствия sandbox: Skills выполняются внутри существующего песочницы агента. Skill не может дать агенту новые возможности сверх разрешённых его конфигурацией. Проверяйте обязательные разрешения Skill перед установкой — команда openclaw skills info перечисляет все требования.

—

Устранение неполадок

| Проблема | Причина | Исправление |
|---------|-------|-----|
| Skill не загружается | SKILL.md не по ожидаемому пути | Проверьте, что путь — `agents/<agent>/skills/<name>/SKILL.md`, а `name` во frontmatter совпадает с именем директории |
| Skill показывает "Needs Setup" | Не хватает required API-ключ или config | Откройте skill в Control UI или выполните `openclaw skills info <name>`, чтобы увидеть, чего не хватает |
| Агент игнорирует инструкции skill | Skill не упомянут в SOUL.md | Добавьте skill в SOUL.md агента в раздел Skills или Shared Context |
| API-ключ недействителен после ввода | Ключ отозван или выбрано неправильное окружение | Повторно введите key через окно деталей в Control UI |
| Установка skill из ClawHub не удалась | Ошибка сети или валидации | Проверьте подключение; убедитесь, что skill от доверенного публикатора в ClawHub |
| Несколько skills конфликтуют | Пересекающиеся условия срабатывания | Уточните в SOUL.md, какой skill имеет приоритет, или разделите их по отдельным agents |

По настройке workspace и конфигурации agent см. INSTRUCTIONS.md.

Оригинал: https://github.com/raulvidis/openclaw-multi-agent-kit/blob/main/docs/skills-system.md

Сообщество энтузиастов - https://t.me/openclaw_lab