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

​
Создайте свой первый Skill

1

Создайте каталог Skill

Skills находятся в папке skills/ вашего рабочего пространства. Создайте каталог для нового Skill:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Для организации можно группировать Skills в подпапках — имя Skill всё равно задаётся frontmatter в SKILL.md, а не путём к папке:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Напишите SKILL.md

Создайте SKILL.md внутри каталога. Frontmatter определяет метаданные; тело содержит инструкции для агента.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Правила именования:
- Используйте строчные буквы, цифры и дефисы для `name`.
- Синхронизируйте имя каталога и `name` во frontmatter.
- `description` показывается агенту и в обнаружении slash-команд —
  оставляйте его в одну строку и короче 160 символов.

</Step>

<Step title="Проверьте, что Skill загружен">
```bash
openclaw skills list
По умолчанию OpenClaw отслеживает файлы SKILL.md в корнях Skills. Если наблюдатель отключён или вы продолжаете существующую сессию, запустите новую, чтобы агент получил обновлённый список:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

Протестируйте его

Отправьте сообщение, которое должно активировать Skill:
openclaw agent --message "give me a greeting"
Или откройте чат и спросите агента напрямую. Используйте /skill hello-world, чтобы вызвать его явно по имени.

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

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

ПолеОписание
nameУникальный slug из строчных букв, цифр и дефисов
descriptionОднострочное описание, показываемое агенту и в выводе обнаружения

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

ПолеПо умолчаниюОписание
user-invocabletrueПоказывает Skill как пользовательскую slash-команду
disable-model-invocationfalseИсключает Skill из системного prompt агента (он всё ещё запускается через /skill)
command-dispatch—Установите tool, чтобы направить slash-команду напрямую в инструмент, обходя модель
command-tool—Имя инструмента для вызова, когда задано command-dispatch: tool
command-arg-moderawДля диспетчеризации инструмента передаёт в инструмент необработанную строку аргументов
homepage—URL, показываемый как “Website” в macOS UI Skills
Поля ограничений (requires.bins, requires.env и т. д.) см. в Skills — Ограничения.

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

Используйте {baseDir} в теле Skill, чтобы ссылаться на файлы внутри каталога Skill без жёстко заданных путей: 
Run the helper script at `{baseDir}/scripts/run.sh`.

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

Ограничьте Skill так, чтобы он загружался только при доступности его зависимостей: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
КлючОписание
requires.binsВсе бинарные файлы должны существовать в PATH
requires.anyBinsХотя бы один бинарный файл должен существовать в PATH
requires.envКаждая переменная env должна существовать в процессе или конфигурации
requires.configКаждый путь openclaw.json должен иметь truthy-значение
osФильтр платформы: ["darwin"], ["linux"], ["win32"]
alwaysУстановите true, чтобы пропустить все ограничения и всегда включать Skill
Полный справочник: Skills — Ограничения.
Привяжите API-ключ к записи Skill в openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
Ключ внедряется в процесс хоста только на этот ход агента. Он не попадает в песочницу — см. переменные env в песочнице.

​
Предложение через Skill Workshop

Для Skills, подготовленных агентом, или когда перед запуском Skill в работу нужен операторский review, используйте предложения Skill Workshop вместо прямой записи SKILL.md. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
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/. После review: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Полный жизненный цикл предложения см. в Skill Workshop.

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

1

Убедитесь, что ваш SKILL.md заполнен полностью

Убедитесь, что заданы name, description и все поля ограничений metadata.openclaw. Добавьте URL homepage, если у вас есть страница проекта.
2

Установите Skill ClawHub

Skill ClawHub документирует текущую форму команды публикации и обязательные метаданные:
openclaw skills install @openclaw/clawhub-publish
3

Опубликуйте

clawhub publish
Полный процесс см. в ClawHub — Публикация.

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

  • Будьте лаконичны — инструктируйте модель, что делать, а не как быть ИИ.
  • Безопасность прежде всего — если ваш Skill использует exec, убедитесь, что prompt не позволяет произвольную инъекцию команд из недоверенного ввода.
  • Тестируйте локально — используйте openclaw agent --message "..." перед публикацией.
  • Используйте ClawHub — просматривайте Skills сообщества на clawhub.ai перед созданием с нуля.

​
См. также

Справочник Skills

Порядок загрузки, ограничения, allowlists и формат SKILL.md.

Skill Workshop

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

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

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

ClawHub

Просматривайте и публикуйте Skills в публичном registry.

Создание Plugins

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