Урок 2: Навыки и инструменты

Чему вы научитесь

• Понимать систему навыков (skills) OpenClaw
• Устанавливать навыки из ClawHub — реестра сообщества
• Разбираться в структуре SKILL.md
• Настраивать права и песочницы для безопасного выполнения
• Создавать собственные навыки

Что такое навыки

Навыки (skills) — это расширения, которые обучают агента использовать конкретные инструменты, API и сценарии. Каждый навык — это папка с файлом SKILL.md, содержащим инструкции для агента.

Когда Gateway запускается, он загружает все активные навыки и включает их инструкции в системный промпт агента. Таким образом агент «знает», как работать с Gmail, GitHub, Spotify, браузером и сотнями других инструментов.

Три типа навыков

Приоритет загрузки: workspace > managed > bundled. Если навык с одинаковым именем есть в workspace и в managed, используется версия из workspace.

Встроенные навыки

OpenClaw поставляется с набором базовых навыков, которые доступны из коробки:

Эти навыки работают без дополнительной настройки. Проверьте:

openclaw skills list

Installed skills:
  [bundled] file        - File operations
  [bundled] exec        - Shell command execution
  [bundled] browser     - Web browsing
  [bundled] search      - Internet search
  [bundled] memory      - Long-term memory

ClawHub — реестр сообщества

ClawHub — это официальный реестр навыков OpenClaw с 700+ расширениями. Устанавливайте навыки одной командой.

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

clawhub search "gmail"

Results for "gmail":
  openclaw/gmail           [*] 12.4k  Email management (read, send, label)
  openclaw/gmail-digest    [*] 3.2k   Daily email digest
  community/gmail-filters  [*] 890    Advanced Gmail filter rules

Получение информации

clawhub info openclaw/gmail

openclaw/gmail v2.1.0
  Email management for OpenClaw
  Downloads: 145,000+
  Requires: Gmail API credentials (OAuth2)
  Bins: none
  Env: GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET

Установка

clawhub install openclaw/gmail

Навык устанавливается в ~/.openclaw/skills/openclaw--gmail/.

Обновление

# Обновить конкретный навык
clawhub update openclaw/gmail

# Обновить все
clawhub update --all

Структура SKILL.md

Каждый навык — это папка с файлом SKILL.md. Вот структура типичного навыка:

~/.openclaw/skills/openclaw--gmail/
├── SKILL.md         # Инструкции для агента
├── oauth-setup.sh   # Скрипт настройки (опционально)
└── templates/       # Шаблоны (опционально)
    └── digest.md

Содержимое SKILL.md

---
name: gmail
description: Gmail email management
version: 2.1.0
requires:
  env:
    - GMAIL_CLIENT_ID
    - GMAIL_CLIENT_SECRET
    - GMAIL_REFRESH_TOKEN
  bins: []
---

# Gmail Skill

You have access to the user's Gmail account.

## Available Actions

### Read emails
Use the gmail CLI to list and read emails:
- `gmail list --unread` - show unread messages
- `gmail read <id>` - read specific message
- `gmail search "query"` - search emails

### Send emails
- `gmail send --to "email" --subject "subject" --body "text"`
- `gmail reply <id> --body "text"`

### Manage labels
- `gmail label <id> --add "label"`
- `gmail archive <id>`

## Rules
- Always confirm before sending emails
- Show email preview before sending
- Never auto-archive without user approval
- Summarize long threads instead of showing full text

Ключевые элементы

Frontmatter (YAML): метаданные навыка — имя, версия, зависимости.

Секция requires: указывает, какие переменные окружения и бинарные файлы нужны. OpenClaw проверяет наличие зависимостей при загрузке.

Инструкции: markdown-текст, который включается в системный промпт агента. Агент читает эти инструкции и понимает, какие команды выполнять.

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

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

Управляйте доступом навыков через конфигурацию:

Горячая перезагрузка

При разработке навыков включите автоматическую перезагрузку:

{
  "skills": {
    "load": {
      "watch": true,
      "watchDebounceMs": 250
    }
  }
}

Теперь при изменении SKILL.md агент автоматически получит обновлённые инструкции.

Песочницы (Sandbox)

Навыки могут выполнять произвольные команды на вашей машине. Для безопасности используйте песочницы на базе Docker.

Включение

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",     // Песочница для всех, кроме main агента
        "docker": {
          "image": "openclaw/sandbox:latest",
          "setupCommand": "apt-get update && apt-get install -y python3"
        }
      }
    }
  }
}

Режимы песочницы

Когда использовать

• Семейный бот — обязательно all, чтобы ребёнок случайно не выполнил опасную команду
• Рабочий бот — non-main для баланса безопасности и удобства
• Личный бот — off, если вы доверяете настройкам и используете только проверенные навыки

Важно о безопасности

API-ключи передаются в процесс хоста, а не в песочницу. Это значит, что агент имеет доступ к вашим ключам вне зависимости от песочницы. Устанавливайте навыки только из проверенных источников.

Навыки для конкретных агентов

Навыки можно изолировать по агентам. Workspace-навыки видит только тот агент, в чьём workspace они находятся:

~/.openclaw/workspace/
├── default/
│   └── skills/
│       └── personal-notes/     # Только для default агента
│           └── SKILL.md
├── work/
│   └── skills/
│       └── jira-integration/   # Только для work агента
│           └── SKILL.md

Общие навыки (managed) в ~/.openclaw/skills/ доступны всем агентам, если не ограничены конфигурацией.

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

Создадим простой навык для управления заметками.

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

mkdir -p ~/.openclaw/workspace/default/skills/notes

Шаг 2. Создайте SKILL.md

cat > ~/.openclaw/workspace/default/skills/notes/SKILL.md << 'EOF'
---
name: notes
description: Personal notes management
version: 1.0.0
requires:
  env: []
  bins: []
---

# Notes Skill

Manage user's personal notes in ~/notes/ directory.

## Actions

### Create note
Create a new markdown file in ~/notes/:
```bash
mkdir -p ~/notes && cat > ~/notes/YYYY-MM-DD-title.md << 'CONTENT'
# Title
Content here
CONTENT

List notes

ls -la ~/notes/*.md | tail -20

Search notes

grep -rl "query" ~/notes/

Rules

• Use date prefix for filenames: YYYY-MM-DD-title.md
• Always use markdown format
• Show confirmation after creating/editing
• Never delete notes without explicit confirmation EOF

### Шаг 3. Проверьте

```bash
openclaw skills list

Навык notes должен появиться в списке workspace-навыков. Попробуйте в чате:

Вы: Создай заметку "Идеи для проекта" с тремя пунктами

Агент прочитает инструкции из SKILL.md и создаст файл в ~/notes/.

Популярные навыки сообщества

Полный каталог: clawhub.openclaw.ai

Аудит навыков перед установкой

Перед установкой стороннего навыка проверьте его:

1. Прочитайте SKILL.md. Убедитесь, что инструкции не содержат подозрительных команд.

2. Проверьте зависимости. Раздел requires покажет, какие API-ключи и бинарники нужны.

3. Красные флаги:

   • Команды с sudo или rm -rf
   • Обфусцированный/закодированный код
   • Запрос облачных credential (AWS, GCP)
   • Сетевые запросы на неизвестные домены

4. Отключите подозрительное:

{
  "skills": {
    "entries": {
      "suspicious-skill": {
        "enabled": false
      }
    }
  }
}

Попробуйте сами

1. Установите навык из ClawHub. Выберите один из популярных навыков и установите:

   clawhub install openclaw/github

2. Создайте свой навык. Следуя инструкции выше, создайте workspace-навык для любой задачи (заметки, TODO-лист, логирование).

3. Проверьте изоляцию. Создайте навык в workspace одного агента и убедитесь, что другой агент его не видит.

4. Изучите каталог. Выполните clawhub search "productivity" и изучите доступные навыки для повышения продуктивности.

Ключевые выводы

• Навыки — расширения, обучающие агента работать с конкретными инструментами
• Три типа: bundled (встроенные), managed (из ClawHub), workspace (свои)
• ClawHub — реестр сообщества с 700+ навыками, установка одной командой
• SKILL.md — файл с инструкциями и метаданными, который включается в системный промпт
• Песочницы (Docker) изолируют выполнение команд для безопасности
• Workspace-навыки изолированы по агентам — каждый видит только свои
• Всегда проверяйте сторонние навыки перед установкой

Следующий урок

Урок 3: Автоматизация — настроим cron-задачи, вебхуки и Gmail-интеграцию для полной автоматизации.