Скиллы OpenClaw: расширяем возможности агента

Скиллы --- это расширения, которые дают OpenClaw новые возможности: работа с API, автоматизация задач, интеграция с сервисами. В этом руководстве разберём, как использовать готовые скиллы и создавать свои.

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

По умолчанию OpenClaw умеет только общаться через мессенджер. Скиллы добавляют агенту «руки» --- возможность выполнять действия:

• Отправлять email и сообщения
• Работать с файлами и базами данных
• Вызывать внешние API
• Управлять умным домом
• Взаимодействовать с рабочими инструментами (Jira, Notion, календарь)

Скилл --- это папка с файлом SKILL.md, который описывает возможности скилла в формате Markdown. OpenClaw загружает скиллы из нескольких директорий (workspace, managed, bundled) и делает их доступными агенту.

Структура скилла

Каждый скилл --- это папка, содержащая файл SKILL.md. Этот файл описывает скилл в формате Markdown с YAML-заголовком (frontmatter):

---
name: weather
description: Получает прогноз погоды для указанного города
---

OpenClaw читает SKILL.md и на основе описания понимает, когда и как использовать скилл.

Расположение скиллов (по приоритету)

OpenClaw ищет скиллы в нескольких директориях. Если скилл с одинаковым именем найден в нескольких местах, приоритет определяется порядком:

1. Workspace-скиллы (наивысший приоритет): ~/.openclaw/workspace/skills/<skill>/SKILL.md
2. Managed-скиллы (установленные через clawhub): ~/.openclaw/skills/
3. Bundled-скиллы (встроенные): поставляются вместе с OpenClaw

Установка готовых скиллов

Из каталога Claw Hub

Каталог скиллов доступен на clawhub.com. Установка выполняется через CLI:

clawhub install weather
clawhub install todoist
clawhub install telegram-send

После установки скилл автоматически становится доступен агенту. Для обновления всех установленных скиллов:

clawhub update --all

Вручную

Создайте папку скилла в workspace-директории и добавьте файл SKILL.md:

~/.openclaw/workspace/skills/
└── my-skill/
    └── SKILL.md    <-- сюда

Популярные скиллы

Коммуникация

Скилл	Описание
telegram-send	Отправка сообщений в Telegram-чаты
email-send	Отправка email через SMTP
slack-post	Публикация в Slack-каналы

Продуктивность

Скилл	Описание
todoist	Управление задачами в Todoist
notion	Работа со страницами и базами Notion
google-calendar	Чтение и создание событий в календаре

Информация

Скилл	Описание
weather	Прогноз погоды
web-search	Поиск в интернете
web-fetch	Загрузка и парсинг веб-страниц

Разработка

Скилл	Описание
github	Работа с репозиториями, issues, PR
shell	Выполнение shell-команд
file-ops	Чтение и запись файлов

Создание своего скилла

Шаг 1. Создайте папку и файл SKILL.md

Создайте папку скилла в workspace-директории:

mkdir -p ~/.openclaw/workspace/skills/currency

Создайте файл ~/.openclaw/workspace/skills/currency/SKILL.md:

---
name: currency
description: Конвертирует валюту по текущему курсу
---

Шаг 2. Настройте скилл в openclaw.json

Если скилл использует API-ключи, добавьте конфигурацию в ~/.openclaw/openclaw.json:

{
  skills: {
    entries: {
      "currency": {
        enabled: true,
        apiKey: "YOUR_EXCHANGE_API_KEY",
        env: { EXCHANGE_API_KEY: "your_api_key_here" },
      },
    },
  },
}

Шаг 3. Проверьте скилл

Перезапустите gateway (остановите текущий процесс через Ctrl+C и запустите заново):

openclaw gateway --port 18789

Затем напишите агенту: «Сколько будет 100 долларов в рублях?»

Продвинутые возможности

Конфигурация скиллов в openclaw.json

Все настройки скиллов хранятся в файле ~/.openclaw/openclaw.json в формате JSON5. Пример полной конфигурации:

{
  skills: {
    entries: {
      "weather": {
        enabled: true,
        apiKey: "KEY_HERE",
        env: { OPENWEATHER_API_KEY: "xxx" },
      },
      "web-search": {
        enabled: true,
        apiKey: "tvly-xxx",
      },
    },
    load: {
      watch: true,
      extraDirs: [],
    },
  },
}

Параметры конфигурации

• entries --- настройки для каждого скилла (включение, API-ключи, переменные окружения)
• load.watch --- автоматическая перезагрузка при изменении файлов скиллов
• load.extraDirs --- дополнительные директории для поиска скиллов

Отключение скилла

Чтобы временно отключить скилл, не удаляя его, установите enabled: false:

{
  skills: {
    entries: {
      "shell": {
        enabled: false,
      },
    },
  },
}

Диагностика

Для проверки состояния системы и скиллов используйте:

openclaw doctor

Безопасность скиллов

Риски

Скиллы выполняют код на вашем компьютере. Вредоносный скилл может:

• Читать и удалять файлы
• Отправлять данные на внешние серверы
• Выполнять произвольные команды
• Получить доступ к вашим API-ключам

Правила безопасности

1. Устанавливайте только проверенные скиллы из официального реестра или известных источников

2. Изучайте скилл перед установкой --- просматривайте описание и отзывы на clawhub.com

3. Используйте sandbox-режим для недоверенных скиллов:

   // openclaw.json
   {
     skills: {
       entries: {
         "untrusted-skill": {
           enabled: true,
           sandbox: true,
         },
       },
     },
   }

4. Храните API-ключи в конфигурации через env, не в открытом виде

Признаки подозрительного скилла

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

Подробнее о безопасности читайте в статье Безопасность OpenClaw.

Отладка скиллов

Логирование

Вывод скиллов отображается в терминале, где запущен gateway. Следите за ним в реальном времени:

openclaw gateway --port 18789

Диагностика

Для проверки конфигурации и состояния скиллов:

openclaw doctor

Типичные проблемы

Скилл не найден:

• Проверьте, что папка скилла находится в одной из директорий: ~/.openclaw/workspace/skills/, ~/.openclaw/skills/
• Проверьте наличие и синтаксис файла SKILL.md
• Перезапустите gateway

Ошибка выполнения:

• Проверьте вывод терминала gateway
• Убедитесь, что API-ключи заданы в openclaw.json
• Проверьте сетевое подключение

Агент не использует скилл:

• Проверьте description в SKILL.md --- он должен ясно описывать назначение
• Переформулируйте запрос агенту
• Добавьте инструкцию в SOUL.md

Публикация скилла

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

1. Создайте репозиторий на GitHub
2. Добавьте README с описанием и примерами
3. Опубликуйте скилл в каталоге clawhub.com

Что дальше

• Настройка SOUL.md --- как настроить личность агента
• Безопасность OpenClaw --- защита данных при использовании скиллов
• Безопасная установка на VPS --- изоляция агента на сервере

Скиллы превращают OpenClaw из умного собеседника в полноценного автоматизатора задач. Начните с готовых скиллов, а когда освоитесь --- создавайте свои под конкретные потребности.