Урок 5. Навыки (Skills)#

Зачем это нужно#

Инструменты (из предыдущего урока) — это возможности ассистента. А навыки (Skills) — это инструкции, как правильно использовать эти возможности для конкретных задач. Навык — это папка с файлом-инструкцией, которая учит ассистента делать что-то определённое: генерировать картинки, работать с календарём, писать код на определённом языке.

Думайте о навыках как о «курсах повышения квалификации» для вашего ассистента.

Как устроен навык#

Каждый навык — это папка, внутри которой есть файл SKILL.md. Этот файл содержит:

1. Заголовок (метаданные) — название, описание, требования
2. Инструкции — как именно выполнять задачу

Пример SKILL.md#

---
name: nano-banana-pro
description: Генерация и редактирование изображений через Gemini
---

# Генерация изображений

Когда пользователь просит создать или отредактировать изображение:

1. Используй Gemini API для генерации
2. Сохрани результат в рабочую папку
3. Покажи изображение пользователю

Откуда берутся навыки#

Навыки загружаются из трёх мест (в порядке приоритета):

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

ClawHub — магазин навыков#

ClawHub (clawhub.ai) — это публичный каталог навыков для OpenClaw. Там можно искать, скачивать и устанавливать готовые навыки.

Установка CLI-инструмента#

npm install -g clawhub

Основные команды#

# Поиск навыка
clawhub search "календарь"
clawhub search "image generation"

# Установка навыка
clawhub install <название-навыка>

# Обновление всех установленных навыков
clawhub update --all

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

# 1. Ищем навык для работы с изображениями
clawhub search "image"

# 2. Устанавливаем найденный навык
clawhub install nano-banana-pro

# 3. Начинаем новую сессию, чтобы навык подключился
# (в чате с ассистентом)
/new

Важно: после установки навыка нужно начать новую сессию (/new), чтобы ассистент «увидел» новый навык.

Настройка навыков#

Включение и отключение#

В файле openclaw.json:

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,                    // включить навык
        apiKey: "ваш-ключ",              // API-ключ (если нужен)
        env: {
          GEMINI_API_KEY: "ваш-ключ"     // переменная окружения
        }
      },
      "ненужный-навык": {
        enabled: false                    // отключить навык
      }
    }
  }
}

Требования навыков (гейтинг)#

Некоторые навыки работают только при выполнении определённых условий:

• bins — нужна определённая программа (например, python, node)
• env — нужна переменная окружения (обычно API-ключ)
• config — нужна определённая настройка в OpenClaw
• os — работает только на определённых системах (Mac, Linux, Windows)

OpenClaw автоматически проверяет эти условия и подключает только подходящие навыки.

Как создать свой навык#

Шаг 1: Создайте папку#

mkdir -p ~/.openclaw/workspace/skills/my-skill

Шаг 2: Создайте файл SKILL.md#

---
name: my-skill
description: Мой навык для создания отчётов
---

# Создание отчётов

Когда пользователь просит создать отчёт:

1. Спроси, за какой период нужен отчёт
2. Собери данные из файлов в папке `reports/`
3. Создай файл отчёта в формате Markdown
4. Сообщи пользователю, что отчёт готов

## Формат отчёта

- Заголовок с датой
- Основные показатели в таблице
- Краткие выводы

Шаг 3: Начните новую сессию#

/new

Ассистент увидит ваш навык и будет следовать инструкциям, когда задача подходит.

Добавление метаданных (опционально)#

Для более «продвинутых» навыков добавьте метаданные:

---
name: my-report-skill
description: Создание красивых отчётов из данных
metadata: {
  "openclaw": {
    "emoji": "📊",
    "requires": {
      "bins": ["python3"]
    }
  }
}
---

Публикация навыка на ClawHub#

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

clawhub sync --all

Эта команда опубликует ваши навыки на ClawHub, и другие пользователи смогут их установить.

Безопасность#

⚠️ Важно: навыки от незнакомых авторов — это как программы от незнакомых людей. Перед установкой:

• Прочитайте описание навыка
• Посмотрите файл SKILL.md (что именно навык делает)
• Используйте песочницу (sandbox) для запуска ненадёжных навыков

Итоги урока#

• Навыки — это инструкции, которые учат ассистента выполнять конкретные задачи
• Каждый навык — папка с файлом SKILL.md
• ClawHub (clawhub.ai) — каталог готовых навыков
• Навыки загружаются из рабочей папки, общей папки и встроенных
• Создать свой навык просто: папка + файл SKILL.md с инструкциями
• После установки/создания навыка нужна новая сессия (/new)
• Проверяйте навыки от незнакомых авторов перед использованием

Следующий урок: Автоматизация