Навыки Clawdbot

Расширьте ИИ-ассистента Clawdbot с помощью навыков. Узнайте, как создавать, устанавливать и управлять навыками для вашего персонального ИИ-ассистента.

Обзор навыков Clawdbot

Clawdbot использует папки навыков, совместимые с AgentSkills, чтобы научить агента использовать инструменты. Каждый навык — это каталог, содержащий SKILL.md с YAML-метаданными и инструкциями.

Clawdbot загружает встроенные навыки плюс опциональные локальные переопределения и фильтрует их во время загрузки на основе окружения, конфигурации и наличия бинарных файлов.

Расположение навыков и приоритет

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

РасположениеОписание
Встроенные навыкиПоставляются с установкой (npm-пакет или Clawdbot.app)
Управляемые/локальные навыки~/.clawdbot/skills
Навыки рабочей области<workspace>/skills

Приоритет (от высшего к низшему):

  1. <workspace>/skills
  2. ~/.clawdbot/skills
  3. Встроенные навыки

Вы можете настроить дополнительные папки навыков через skills.load.extraDirs в ~/.clawdbot/clawdbot.json.

Навыки для конкретного агента vs общие

В многоагентных настройках:

  • Навыки для конкретного агента: Находятся в <workspace>/skills только для этого агента
  • Общие навыки: Находятся в ~/.clawdbot/skills и видны всем агентам

ClawHub (Установка + Синхронизация)

ClawHub — это публичный реестр навыков для Clawdbot. Просматривайте на https://clawhub.com.

Типичные операции:

# Установить навык в вашу рабочую область
clawhub install <skill-slug>

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

# Синхронизировать (сканировать + публиковать обновления)
clawhub sync --all

По умолчанию clawhub устанавливает в ./skills в текущем рабочем каталоге.

Формат навыка

SKILL.md должен содержать как минимум:

---
name: my-skill
description: What this skill does
---

Instructions for the agent...

Опциональные ключи метаданных

КлючОписание
homepageURL, отображаемый как «Веб-сайт» в интерфейсе навыков
user-invocabletrue|false (по умолчанию: true) — показывать как пользовательскую слэш-команду
disable-model-invocationtrue|false (по умолчанию: false) — исключить из промпта модели
command-dispatchtool — обойти модель и отправить напрямую к инструменту
command-toolИмя инструмента для вызова, когда command-dispatch: tool

Гейтинг (фильтры во время загрузки)

Фильтруйте навыки во время загрузки с помощью метаданных:

---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---

Поля гейтинга

ПолеОписание
always: trueВсегда включать навык
requires.binsНеобходимые бинарные файлы
requires.envНеобходимые переменные окружения
requires.configНеобходимые ключи конфигурации
primaryEnvОсновная переменная окружения для навыка

Переопределение конфигурации

Переопределите настройки навыка в ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-key"
        }
      }
    }
  }
}

Примечания по безопасности

  • Относитесь к сторонним навыкам как к ненадёжному коду
  • Читайте навыки перед включением
  • Предпочитайте запуск в песочнице для ненадёжных входных данных
  • Храните секреты вне промптов и логов

Плагины + Навыки

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

Наблюдатель навыков (автообновление)

Clawdbot отслеживает каталоги навыков на предмет изменений и автоматически обновляется при добавлении, изменении или удалении навыков.

Следующие шаги