OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Overview

Обзор

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

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

С чего начать

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

Если требуется... Сначала используйте Затем прочитайте
Дать агенту действовать с имеющимися возможностями Встроенные инструменты Категории инструментов
Управлять тем, что может вызывать агент Политика инструментов Инструменты и пользовательские провайдеры
Обучить агента рабочему процессу Skills Skills, Создание Skills, Мастерская Skills и Самообучение
Добавить новую интеграцию или поверхность среды выполнения Плагины Плагины и Разработка плагинов
Выполнить работу позже или в фоновом режиме Автоматизация Обзор автоматизации
Координировать несколько агентов или сред запуска Субагенты Агенты ACP и Отправка агенту
Искать в большом каталоге инструментов OpenClaw Поиск инструментов Поиск инструментов

Выбор инструментов, Skills или плагинов

  • Используйте инструмент, когда агенту нужно выполнить действие

    Инструмент — это типизированная функция, которую может вызвать агент, например exec, browser, web_search, message или image_generate. Используйте инструменты, когда агенту необходимо прочитать данные, изменить файлы, отправить сообщения, вызвать провайдера или управлять другой системой. Видимые инструменты передаются модели как структурированные определения функций.

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

  • Используйте Skill, когда агенту нужны инструкции

    Skill — это пакет инструкций SKILL.md, загружаемый в промпт агента. Используйте Skill, когда у агента уже есть необходимые инструменты, но ему нужен воспроизводимый рабочий процесс, набор критериев проверки, последовательность команд или эксплуатационное ограничение.

    Skills могут находиться в рабочем пространстве, общем каталоге Skills, управляемом корневом каталоге Skills OpenClaw или в пакете плагина.

    Skills | Мастерская Skills | Самообучение | Создание Skills | Конфигурация Skills

  • Используйте плагин, когда OpenClaw нужна новая возможность

    Плагин может добавлять инструменты, Skills, каналы, провайдеров моделей, синтез речи, голосовую связь в реальном времени, генерацию медиа, веб-поиск, получение веб-страниц, хуки и другие возможности среды выполнения. Используйте плагин, если возможность включает код, учётные данные, хуки жизненного цикла, метаданные манифеста или устанавливаемую упаковку. Существующие плагины можно устанавливать из ClawHub, npm, git, локальных каталогов или архивов.

    Установка и настройка плагинов | Разработка плагинов | SDK плагинов

    • Категории встроенных инструментов

    В таблице перечислены типичные инструменты, чтобы вы могли ознакомиться с этой поверхностью. Это не полный справочник по политике. Точные группы, значения по умолчанию и семантику разрешений и запретов см. в разделе Инструменты и пользовательские провайдеры.

    Категория Используйте, когда агенту требуется... Типичные инструменты Что читать дальше
    Среда выполнения Выполнять команды, управлять процессами или использовать анализ Python через провайдера exec, process, code_execution Exec, Выполнение кода
    Файлы Читать и изменять файлы рабочего пространства read, write, edit, apply_patch Применение патча
    Веб Искать в интернете, искать публикации в X или получать читаемое содержимое страниц web_search, x_search, web_fetch Веб-инструменты, Получение веб-страниц
    Браузер Управлять сеансом браузера browser Браузер
    Обмен сообщениями и каналы Отправлять ответы или выполнять действия в каналах message Отправка агенту
    Сеансы и агенты Проверять сеансы, делегировать работу, направлять другой запуск или сообщать о состоянии sessions_*, subagents, agents_list, session_status, get_goal, create_goal, update_goal Цель, Субагенты, Инструмент сеанса
    Автоматизация Планировать работу или реагировать на фоновые события cron, heartbeat_respond Автоматизация
    Gateway и узлы Проверять состояние Gateway или сопряжённых целевых устройств gateway, nodes Конфигурация Gateway, Узлы
    Медиа Анализировать, генерировать или озвучивать медиаданные image, image_generate, music_generate, video_generate, tts Обзор медиа
    Большие каталоги OpenClaw Искать и вызывать множество доступных инструментов, не отправляя модели каждую схему tool_search_code, tool_search, tool_describe Поиск инструментов

    Инструменты, предоставляемые плагинами

    Плагины могут регистрировать дополнительные инструменты. Авторы плагинов подключают инструменты через api.registerTool(...) и contracts.tools манифеста; подробности контрактов см. в разделах SDK плагинов и Манифест плагина.

    Распространённые инструменты, предоставляемые плагинами:

    • Различия для отображения различий файлов и Markdown
    • Показать виджет для автономных встроенных SVG и HTML в веб-чате
    • Задача LLM для шагов рабочего процесса только с JSON
    • Lobster для типизированных рабочих процессов с возобновляемыми подтверждениями
    • Tokenjuice для уплотнения перегруженного вывода инструментов exec и bash
    • Поиск инструментов для обнаружения и вызова больших каталогов инструментов без размещения каждой схемы в промпте
    • Canvas для управления Canvas узла и рендеринга A2UI

    Настройка доступа и подтверждений

    Политика инструментов применяется до вызова модели. Если политика исключает инструмент, модель не получает схему этого инструмента на текущий ход. Во время запуска инструменты могут стать недоступны из-за глобальной конфигурации, конфигурации конкретного агента, политики канала, ограничений провайдера, правил песочницы, политики канала или среды выполнения либо доступности плагина.

    Расширение возможностей

    Выберите способ расширения в зависимости от задачи, которую должен выполнять OpenClaw:

    • Установите существующий плагин или управляйте им с помощью раздела Плагины.
    • Создайте новую интеграцию, провайдера, канал, инструмент или хук с помощью раздела Разработка плагинов.
    • Добавьте или настройте многократно используемые инструкции агента с помощью разделов Skills и Создание Skills.
    • Используйте SDK плагинов и Манифест плагина, когда вам нужны контракты реализации.

    Устранение неполадок с отсутствующими инструментами

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

    1. Проверьте активный профиль, tools.allow и tools.deny в разделе Инструменты и пользовательские провайдеры.
    2. Проверьте ограничения конкретного провайдера в разделе Инструменты и пользовательские провайдеры и убедитесь, что выбранный провайдер модели поддерживает структуру инструмента.
    3. Проверьте разрешения канала, состояние песочницы и расширенный доступ с помощью Песочница, политика инструментов и расширенный доступ и Расширенное выполнение команд.
    4. Проверьте, установлен и включён ли отвечающий за это плагин, в разделе Плагины.
    5. Для делегированных запусков проверьте ограничения каждого агента в разделе Песочница и ограничения инструментов для каждого агента.
    6. Для больших каталогов OpenClaw проверьте, использует ли запуск прямое предоставление инструментов или Поиск инструментов.

    Связанные разделы

    Was this useful?
    On this page

    On this page