Создание Skills

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

Создание первого навыка

Создайте каталог навыка

Навыки хранятся в папке skills/ вашей рабочей области:

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

Для удобства организации навыки можно группировать по вложенным папкам — имя навыка по-прежнему задаётся полем SKILL.md во frontmatter, а не путём к папке:

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 "give me a greeting"

Или откройте чат и обратитесь к агенту напрямую. Используйте /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 Workshop

Для навыков, подготовленных агентом, или когда перед активацией навыка требуется проверка оператором, используйте предложения Skill Workshop, а не записывайте SKILL.md напрямую.

# Предложить совершенно новый навык
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Предложить обновление существующего навыка
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"

Используйте --proposal-dir, если предложение содержит вспомогательные файлы:

openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/

Каталог должен содержать PROPOSAL.md в своём корне. Вспомогательные файлы размещаются в assets/, examples/, references/, scripts/ или templates/. После проверки:

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

Полный жизненный цикл предложения описан в разделе Skill Workshop.

Публикация в 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.

Skill Workshop

Очередь предложений для навыков, подготовленных агентом.

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

Полная схема конфигурации skills.*.

ClawHub

Просмотр и публикация навыков в общедоступном реестре.

Создание плагинов

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

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Создание Skills

Создание первого навыка

Справочник по SKILL.md

Обязательные поля

Необязательные ключи frontmatter

Использование `{baseDir}`

Добавление условной активации

Создание предложения через Skill Workshop

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

Рекомендации

Связанные разделы

Справочник по Skills

Skill Workshop

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

ClawHub

Создание плагинов

​Создание первого навыка

​Справочник по SKILL.md

​Обязательные поля

​Необязательные ключи frontmatter

​Использование {baseDir}

​Добавление условной активации

​Создание предложения через Skill Workshop

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

​Рекомендации

​Связанные разделы

Справочник по Skills

Skill Workshop

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

ClawHub

Создание плагинов

Создание первого навыка

Справочник по SKILL.md

Обязательные поля

Необязательные ключи frontmatter

Использование `{baseDir}`

Добавление условной активации

Создание предложения через Skill Workshop

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

Рекомендации

Связанные разделы