Как создать скилл для OpenClaw

Аудитория: разработчик / опытный пользователь OpenClaw
Время: ~1-2 часа на первый скилл

Что такое скилл

Модульный пакет, расширяющий возможности OpenClaw:

skill-name/
├── SKILL.md          ← обязательно (описание + инструкции)
├── scripts/          ← исполняемые скрипты (Python, Bash)
├── references/       ← справочные материалы (загружаются по необходимости)
└── assets/           ← шаблоны, файлы для вывода

Шаг 1 — Определить скилл

Ответить на вопросы:

Пример:

media-notes: скачивает видео → транскрибирует → сохраняет в Obsidian.
Срабатывает: "сохрани в notes", "разбери этот рил".
НЕ делает: PDF, текстовые статьи.

Шаг 2 — Инициализировать структуру

python3 /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/scripts/init_skill.py \
  my-skill \
  --path /opt/homebrew/lib/node_modules/openclaw/skills \
  --resources scripts,references

Результат: готовая папка с шаблоном SKILL.md.

Frontmatter — критически важен (это триггер)

---
name: my-skill
description: "Что делает скилл. Используй когда: конкретные фразы пользователя.
  НЕ для: что скилл не делает."
---

Правила description:

# Название

## Quick Start
[минимум для запуска — 3-5 строк]

## Workflow
1. Шаг один
2. Шаг два

## Ошибки
- Ошибка → решение

Шаг 4 — Написать скрипты

#!/usr/bin/env bash
set -euo pipefail
# ... логика

Правило: тестировать каждый скрипт до упаковки.

bash /opt/homebrew/lib/node_modules/openclaw/skills/my-skill/scripts/my-script.sh

Шаг 5 — Упаковать

python3 /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py \
  /opt/homebrew/lib/node_modules/openclaw/skills/my-skill \
  /tmp/dist

openclaw gateway restart

Шаг 6 — Проверить

ls /opt/homebrew/lib/node_modules/openclaw/skills/my-skill/
# Написать в OpenClaw фразу-триггер и проверить что скилл сработал

Частые ошибки

Ошибка Причина Решение
angle brackets < или > в description Заменить на текст
Скилл не срабатывает Слабый description Добавить конкретные фразы
Скрипт не запускается Нет chmod +x chmod +x scripts/*.sh
Пути не работают Относительные пути Использовать абсолютные

Чеклист перед релизом

Реальный пример

Скилл media-notes создан 2026-03-14:

Связанные заметки

Дисклеймер / Disclaimer: material is published for informational and research purposes. Полный отказ от ответственности / Full disclaimer.