С чего начать
Для большинства агентов начните со встроенных категорий инструментов, а затем корректируйте политику, только если агенту должно быть доступно меньше инструментов или ему требуется явный доступ к хосту.Выбор инструментов, Skills или плагинов
1
Используйте инструмент, когда агенту нужно выполнить действие
Инструмент — это типизированная функция, которую может вызвать агент, например
exec, browser,
web_search, message или image_generate. Используйте инструменты, когда агенту
необходимо прочитать данные, изменить файлы, отправить сообщения, вызвать провайдера или
управлять другой системой. Видимые инструменты передаются модели как структурированные
определения функций.Модель видит только те инструменты, которые не были исключены активным профилем, политикой
разрешений и запретов, ограничениями провайдера, состоянием песочницы, разрешениями канала и
доступностью плагинов.2
Используйте Skill, когда агенту нужны инструкции
Skill — это пакет инструкций
SKILL.md, загружаемый в промпт агента. Используйте
Skill, когда у агента уже есть необходимые инструменты, но ему нужен
воспроизводимый рабочий процесс, набор критериев проверки, последовательность команд или эксплуатационное
ограничение.Skills могут находиться в рабочем пространстве, общем каталоге Skills, управляемом корневом каталоге
Skills OpenClaw или в пакете плагина.Skills | Мастерская Skills | Самообучение | Создание Skills | Конфигурация Skills3
Используйте плагин, когда OpenClaw нужна новая возможность
Плагин может добавлять инструменты, Skills, каналы, провайдеров моделей, синтез речи,
голосовую связь в реальном времени, генерацию медиа, веб-поиск, получение веб-страниц, хуки и другие
возможности среды выполнения. Используйте плагин, если возможность включает код,
учётные данные, хуки жизненного цикла, метаданные манифеста или устанавливаемую
упаковку. Существующие плагины можно устанавливать из ClawHub, npm, git,
локальных каталогов или архивов.Установка и настройка плагинов | Разработка плагинов | SDK плагинов
Категории встроенных инструментов
В таблице перечислены типичные инструменты, чтобы вы могли ознакомиться с этой поверхностью. Это не полный справочник по политике. Точные группы, значения по умолчанию и семантику разрешений и запретов см. в разделе Инструменты и пользовательские провайдеры.Поиск инструментов — экспериментальная поверхность агента OpenClaw. Запуски в среде Codex используют
собственный режим кода Codex, встроенный поиск инструментов, отложенные динамические инструменты и
вложенные вызовы инструментов вместо
tools.toolSearch.Инструменты, предоставляемые плагинами
Плагины могут регистрировать дополнительные инструменты. Авторы плагинов подключают инструменты черезapi.registerTool(...) и contracts.tools манифеста; подробности контрактов см. в разделах
SDK плагинов и Манифест плагина.
Распространённые инструменты, предоставляемые плагинами:
- Различия для отображения различий файлов и Markdown
- Показать виджет для автономных встроенных SVG и HTML в веб-чате
- Задача LLM для шагов рабочего процесса только с JSON
- Lobster для типизированных рабочих процессов с возобновляемыми подтверждениями
- Tokenjuice для уплотнения перегруженного вывода инструментов
execиbash - Поиск инструментов для обнаружения и вызова больших каталогов инструментов без размещения каждой схемы в промпте
- Canvas для управления Canvas узла и рендеринга A2UI
Настройка доступа и подтверждений
Политика инструментов применяется до вызова модели. Если политика исключает инструмент, модель не получает схему этого инструмента на текущий ход. Во время запуска инструменты могут стать недоступны из-за глобальной конфигурации, конфигурации конкретного агента, политики канала, ограничений провайдера, правил песочницы, политики канала или среды выполнения либо доступности плагина.- Инструменты и пользовательские провайдеры описывает профили инструментов, списки разрешений и запретов, ограничения для конкретных провайдеров, обнаружение циклов и настройки инструментов, работающих через провайдера.
- Подтверждения Exec описывает политику подтверждения команд хоста.
- Повышенные привилегии Exec описывает контролируемое выполнение за пределами песочницы.
- Песочница, политика инструментов и повышенные привилегии объясняет, какой уровень управляет доступом к файлам и процессам.
- Песочница и ограничения инструментов для отдельных агентов описывает ограничения конкретных агентов для делегированных запусков.
Расширение возможностей
Выберите способ расширения в зависимости от задачи, которую должен выполнять OpenClaw:- Установите существующий плагин или управляйте им с помощью раздела Плагины.
- Создайте новую интеграцию, провайдера, канал, инструмент или хук с помощью раздела Разработка плагинов.
- Добавьте или настройте многократно используемые инструкции агента с помощью разделов Skills и Создание Skills.
- Используйте SDK плагинов и Манифест плагина, когда вам нужны контракты реализации.
Устранение неполадок с отсутствующими инструментами
Если модель не видит или не может вызвать инструмент, начните с действующей политики для текущего хода:- Проверьте активный профиль,
tools.allowиtools.denyв разделе Инструменты и пользовательские провайдеры. - Проверьте ограничения конкретного провайдера в разделе Инструменты и пользовательские провайдеры и убедитесь, что выбранный провайдер модели поддерживает структуру инструмента.
- Проверьте разрешения канала, состояние песочницы и расширенный доступ с помощью Песочница, политика инструментов и расширенный доступ и Расширенное выполнение команд.
- Проверьте, установлен и включён ли отвечающий за это плагин, в разделе Плагины.
- Для делегированных запусков проверьте ограничения каждого агента в разделе Песочница и ограничения инструментов для каждого агента.
- Для больших каталогов OpenClaw проверьте, использует ли запуск прямое предоставление инструментов или Поиск инструментов.
Связанные разделы
- Автоматизация: Cron, задачи, Heartbeat, обязательства, хуки, постоянные поручения и Task Flow
- Агенты: модель агента, сеансы, память и координация нескольких агентов
- Инструменты и пользовательские провайдеры: каноническое справочное руководство по политике инструментов
- Плагины: установка и управление плагинами
- SDK плагинов: справочник для авторов плагинов
- Skills: порядок загрузки, ограничение доступа и конфигурация навыков
- Мастерская навыков: создание сгенерированных и проверенных навыков
- Поиск инструментов: компактный поиск по каталогу инструментов OpenClaw