Навыки (Skills) OpenClaw: расширение возможностей агента

Навыки (Skills) — это модульная система расширений OpenClaw. Каждый навык учит агента пользоваться определённым инструментом: генерировать изображения, работать с Git, запускать поиск в интернете, создавать диаграммы и многое другое. Навыки — это простые папки с Markdown-файлом SKILL.md, что делает их легко создаваемыми и распространяемыми.

Откуда загружаются навыки

OpenClaw загружает навыки из трёх источников (в порядке приоритета):

1. Навыки рабочего пространства (<workspace>/skills) — наивысший приоритет
2. Управляемые/локальные (~/.openclaw/skills) — средний приоритет
3. Встроенные — поставляются с установкой OpenClaw

При конфликте имён побеждает навык с более высоким приоритетом. Дополнительные папки можно добавить через skills.load.extraDirs.

Формат SKILL.md

Каждый навык — это директория с файлом SKILL.md, содержащим YAML frontmatter и инструкции:

---
name: nano-banana-pro
description: Генерация и редактирование изображений через Gemini 3 Pro Image
metadata:
  {"openclaw": {"requires": {"bins": ["uv"], "env": ["GEMINI_API_KEY"]}, "primaryEnv": "GEMINI_API_KEY"}}
---

# Инструкции для агента
Используй {baseDir}/generate.py для создания изображений...

Фильтрация при загрузке (гейтинг)

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

• requires.bins — список бинарных файлов, которые должны быть в PATH
• requires.env — переменные окружения или ключи в конфиге
• requires.config — пути в openclaw.json, которые должны быть truthy
• os — список платформ (darwin, linux, win32)
• always: true — всегда включён

ClawHub — каталог навыков

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

clawhub install <skill-slug>    # установить навык
clawhub update --all             # обновить все
clawhub sync --all               # синхронизировать

Настройка навыков в конфигурации

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
      },
      sag: { enabled: false },
    },
  },
}

Ключ enabled: false отключает навык. Через env можно передать переменные окружения. Через apiKey — API-ключ для навыков с primaryEnv.

Навыки для мульти-агентных сценариев

В мульти-агентных настройках:

• Персональные навыки — в <workspace>/skills конкретного агента
• Общие навыки — в ~/.openclaw/skills, доступны всем агентам

Навыки из плагинов

Плагины могут поставлять свои навыки через openclaw.plugin.json. Навыки плагинов загружаются при включении плагина и участвуют в общей системе приоритетов.

Удалённые macOS-ноды

Если Gateway на Linux, но подключён macOS-нод с разрешённым system.run, OpenClaw может использовать macOS-специфичные навыки через этот нод. Подробнее — в статье о нодах.

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

OpenClaw отслеживает изменения в SKILL.md и автоматически обновляет список навыков:

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

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

• Считайте сторонние навыки недоверенным кодом — читайте перед включением
• Используйте sandboxing для рискованных инструментов
• API-ключи из skills.entries.*.env инжектируются в host-процесс — держите секреты вне промптов

О безопасности подробнее — в статье о безопасности OpenClaw. Обзор возможностей — в нашем обзоре.