Назад

06. OpenClaw Skills: подробное руководство по системе навыков

Skills — ядро расширяемых возможностей OpenClaw, сообщество уже внесло более 5700 пакетов навыков. В статье подробно рассматриваются концепция Skills, способы установки, использование ClawHub, классификация навыков, управление конфигурацией и выбор подходящих навыков для расширения возможностей ИИ-помощника.

Для OpenClaw v2026.2 | Статья предполагает, что вы завершили базовую установку и хотите расширить возможности ИИ-помощника.

TL;DR: Skills — это предупакованные расширения возможностей. Установка: openclaw skill install <name>, каталог: ~/.openclaw/workspace/skills/. В ClawHub доступно более 5700 навыков сообщества: помощники по коду, поиск и исследования, разработка и эксплуатация, веб-автоматизация и др. Каждый навык содержит SKILL.md (описание + триггеры + инструкции) и опциональную реализацию инструментов. Проверка безопасности выполняется через VirusTotal.

Что такое Skills?

Объяснение концепции

Skills — это предупакованные модули расширения возможностей, включающие:

Компонент Описание
SKILL.md Файл определения навыка: описание, триггеры, инструкции, примеры
Tools Вызываемые функции-инструменты (опционально)
Resources Связанные ресурсные файлы (опционально)
Package.json Объявление зависимостей (опционально)

Skills vs Tools

Характеристика Skills Tools
Источник Сообщество Встроенные/пользовательские
Установка Требуется установка Доступны по умолчанию
Сложность Могут быть сложными Обычно простые
Шаринг Да Обычно не шарится
Обновления Независимые Вместе с системой

Классификация навыков

Навыки на ClawHub организованы по категориям:

Категория Количество Примеры навыков
Помощники по коду 133+ coding-agent, debug-pro, tdd-guide
Поиск и исследования 253+ web-search, deepwiki, exa-search
Разработка и эксплуатация 212+ docker-essentials, git-workflows
Веб-автоматизация 139+ browser-control, puppeteer-skill
Инструменты продуктивности 135+ calendar-skill, task-manager
Анализ данных 46+ data-analyzer, budget-variance
Умный дом 56+ home-assistant, smart-home-io
PDF и документы 67+ pdf-reader, doc-summarizer
Изображения и видео 60+ image-gen, video-editor
Заметки и знания 100+ obsidian, notion-sync

Способы установки Skills

Способ 1: ClawHub CLI (рекомендуется)

# Поиск навыка
openclaw skill search gmail

# Установка навыка
openclaw skill install gmail

# Установка указанной версии
openclaw skill install [email protected]

# Установка из GitHub
openclaw skill install github:user/skill-repo

# Установка из локального пути
openclaw skill install ./my-skill

Способ 2: Ручная установка

# Клонирование репозитория навыка
git clone https://github.com/user/skill-repo.git

# Копирование в каталог навыков
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

Способ 3: Вставка ссылки GitHub

В чате можно отправить ссылку на GitHub навыка — Agent автоматически распознает и установит его:

Установи этот навык: https://github.com/user/skill-repo

Структура каталога навыков

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

Руководство по использованию ClawHub

Доступ к ClawHub

Перейдите на clawhub.com, чтобы просмотреть все доступные навыки.

Поиск навыков

# Поиск через CLI
openclaw skill search <ключевое_слово>

# Примеры
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

Подробности о навыке

Каждая страница навыка содержит:

Информация Описание
Название и описание Описание функциональности навыка
Автор Разработчик навыка
Версия Текущий номер версии
Загрузки Количество установок
Зависимости Требуемые навыки или пакеты
Превью SKILL.md Файл определения навыка
Проверка безопасности Результаты сканирования VirusTotal

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

ClawHub сотрудничает с VirusTotal для проверки безопасности каждого навыка:

# Просмотр статуса безопасности навыка
openclaw skill info gmail --security

# Пример вывода:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

Проверка перед установкой

# Проверка зависимостей навыка
openclaw skill check gmail

# Пример вывода:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

Конфигурация навыков

Расположение конфигурационного файла

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

Подробная структура SKILL.md

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

Конфигурационный файл навыка

Некоторым навыкам требуется дополнительная конфигурация:

# Настройка навыка
openclaw skill config gmail

# Или ручное редактирование конфигурации
vi ~/.openclaw/workspace/skills/gmail/config.json

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

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

Переменные окружения навыка

# Установка переменных окружения навыка
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# Или в файле .env
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

Управление навыками

Просмотр установленных навыков

# Список всех навыков
openclaw skill list

# Пример вывода:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

Включение/отключение навыков

# Отключить навык
openclaw skill disable home-assistant

# Включить навык
openclaw skill enable home-assistant

Обновление навыков

# Обновить один навык
openclaw skill update gmail

# Обновить все навыки
openclaw skill update --all

# Проверить доступные обновления
openclaw skill outdated

Удаление навыков

# Удалить навык
openclaw skill uninstall gmail

# Удалить с очисткой конфигурации
openclaw skill uninstall gmail --purge

Диагностика навыков

# Диагностика проблем навыка
openclaw skill diagnose gmail

# Пример вывода:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

Рекомендуемые навыки

Программирование и разработка

Название навыка Функция Команда установки
coding-agent Запуск Claude Code, Codex и др. openclaw skill install coding-agent
debug-pro Систематические методы отладки openclaw skill install debug-pro
tdd-guide Разработка через тестирование openclaw skill install tdd-guide
git-workflows Git-рабочие процессы openclaw skill install git-workflows
docker-essentials Основы Docker openclaw skill install docker-essentials

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

Название навыка Функция Команда установки
gmail Управление Gmail openclaw skill install gmail
calendar Управление календарём openclaw skill install calendar
task-manager Управление задачами openclaw skill install task-manager
notion-sync Синхронизация с Notion openclaw skill install notion-sync
obsidian Заметки Obsidian openclaw skill install obsidian

Поиск и исследования

Название навыка Функция Команда установки
web-search Веб-поиск openclaw skill install web-search
deepwiki Поиск в Wiki openclaw skill install deepwiki
exa-search ИИ-поиск openclaw skill install exa-search
research-paper Поиск статей openclaw skill install research-paper

Умный дом

Название навыка Функция Команда установки
home-assistant Управление Home Assistant openclaw skill install home-assistant
smart-home-io Устройства умного дома openclaw skill install smart-home-io
philips-hue Philips Hue openclaw skill install philips-hue

Основы разработки навыков

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

# Создание шаблона навыка
openclaw skill create my-skill

# Созданная структура каталогов
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

Шаблон SKILL.md

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

Добавление определений инструментов

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

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

# Проверка навыка
openclaw skill validate my-skill

# Публикация в ClawHub
openclaw skill publish my-skill

# Или отправка в GitHub
git add .
git commit -m "Initial skill release"
git push origin main

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

Рекомендации по безопасности

Рекомендация Описание
Проверка источника Устанавливайте только навыки из доверенных источников
Проверка прав Узнайте, какие права требуются навыку
Просмотр кода Проверьте SKILL.md и реализацию
Изолированное тестирование Сначала используйте новые навыки в тестовой среде
Регулярные обновления Поддерживайте навыки в актуальном состоянии

Права навыков

# Просмотр прав навыка
openclaw skill permissions gmail

# Пример вывода:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

Ограничение прав навыков

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

Разрешение конфликтов навыков

Типичные конфликты

Тип конфликта Описание Решение
Пересечение триггеров Несколько навыков реагируют на одно ключевое слово Уточните триггеры или отключите конфликтующий навык
Конфликт зависимостей Разные навыки требуют разные версии зависимостей Используйте изолированное окружение
Конфликт прав Навыки требуют одинаковые права Проверьте необходимость

Разрешение конфликтов

# Просмотр конфликтов навыков
openclaw skill conflicts

# Пример вывода:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# Установка приоритета навыков
openclaw skill priority gmail 10
openclaw skill priority outlook 5

Изолированное окружение

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

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

Устранение неполадок

Навык не работает

# Проверка статуса навыка
openclaw skill list --status

# Проверка загрузки навыка
openclaw skill load gmail --verbose

# Просмотр логов навыка
openclaw logs --filter skill:gmail

Ошибка аутентификации

# Повторная аутентификация
openclaw skill auth gmail --reauth

# Проверка статуса аутентификации
openclaw skill auth gmail --status

Проблемы с зависимостями

# Проверка зависимостей
openclaw skill deps gmail

# Установка зависимостей
openclaw skill deps gmail --install

# Обновление зависимостей
openclaw skill deps gmail --update

Ошибка загрузки навыка

# Проверка синтаксиса SKILL.md
openclaw skill validate gmail

# Пример вывода:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

Итоги

Система Skills — ядро расширяемых возможностей OpenClaw:

  • Богатая экосистема: более 5700 навыков сообщества для разных сценариев
  • Простая установка: установка одной командой
  • Гибкая конфигурация: поддержка кастомизации и переопределения
  • Безопасность и контроль: управление правами и проверка безопасности

Правильно выбирая и настраивая навыки, вы можете значительно расширить возможности ИИ-помощника.


Итоги статьи:

  • Понята концепция и структура Skills
  • Освоены различные способы установки и управления навыками
  • Изучено использование ClawHub для поиска и оценки навыков
  • Рассмотрены безопасность и управление правами навыков
  • Получены базовые знания по разработке навыков

История обновлений:

  • 2026-02-26: первая публикация, на основе OpenClaw v2026.2

Навигация по серии: