Начните здесь
Для большинства агентов начните со встроенных категорий инструментов, затем настраивайте правила только когда агент должен видеть меньше инструментов или ему нужен явный доступ к хосту.| Если вам нужно… | Сначала используйте | Затем прочитайте |
|---|---|---|
| Позволить агенту действовать с существующими возможностями | Встроенные инструменты | Категории инструментов |
| Управлять тем, что агент может вызывать | Правила инструментов | Инструменты и пользовательские провайдеры |
| Обучить агента workflow | Skills | Skills, Создание Skills и Skill Workshop |
| Добавить новую интеграцию или runtime-поверхность | Plugins | Plugins и Создание Plugins |
| Запустить работу позже или в фоне | Automation | Обзор Automation |
| Координировать нескольких агентов или harnesses | Субагенты | Агенты ACP и Отправка агенту |
| Искать в большом каталоге инструментов OpenClaw | Tool Search | Tool Search |
Выберите инструменты, Skills или Plugins
Используйте инструмент, когда агенту нужно действовать
Инструмент — это типизированная функция, которую агент может вызвать, например
exec, browser,
web_search, message или image_generate. Используйте инструменты, когда агенту
нужно читать данные, изменять файлы, отправлять сообщения, вызывать провайдера или управлять
другой системой. Видимые инструменты отправляются модели как структурированные определения
функций.Модель видит только инструменты, которые прошли активный профиль, правила allow/deny,
ограничения провайдера, состояние sandbox, разрешения канала и доступность
плагинов.Используйте Skill, когда агенту нужны инструкции
Skill — это пакет инструкций
SKILL.md, загружаемый в prompt агента. Используйте
Skill, когда у агента уже есть нужные инструменты, но ему нужен повторяемый
workflow, рубрика ревью, последовательность команд или операционное ограничение.Skills могут находиться в workspace, общем каталоге Skills, управляемом корне Skills OpenClaw
или пакете плагина.Skills | Skill Workshop | Создание Skills | Конфигурация SkillsИспользуйте Plugin, когда OpenClaw нужна новая возможность
Plugin может добавлять инструменты, Skills, каналы, провайдеров моделей, речь, realtime-
голос, генерацию медиа, веб-поиск, веб-загрузку, хуки и другие runtime-
возможности. Используйте Plugin, когда возможность имеет код, учетные данные,
lifecycle-хуки, метаданные manifest или устанавливаемую упаковку. Существующие
плагины можно установить из ClawHub, npm, git, локальных каталогов или
архивов.Установка и настройка Plugins | Создание Plugins | Plugin SDK
Категории встроенных инструментов
В таблице перечислены репрезентативные инструменты, чтобы вы могли распознать поверхность. Это не полный справочник правил. Точные группы, значения по умолчанию и семантику allow/deny см. в Инструментах и пользовательских провайдерах.| Категория | Используйте, когда агенту нужно… | Репрезентативные инструменты | Читать далее |
|---|---|---|---|
| Runtime | Запускать команды, управлять процессами или использовать Python-анализ с поддержкой провайдера | exec, process, code_execution | Exec, Выполнение кода |
| Файлы | Читать и изменять файлы workspace | read, write, edit, apply_patch | Apply patch |
| Web | Искать в интернете, искать посты X или получать читаемое содержимое страниц | web_search, x_search, web_fetch | Веб-инструменты, Web fetch |
| Browser | Управлять сессией браузера | browser | Browser |
| Сообщения и каналы | Отправлять ответы или действия канала | message | Отправка агенту |
| Сессии и агенты | Проверять сессии, делегировать работу, направлять другой запуск или сообщать статус | sessions_*, subagents, agents_list, session_status, goal | Goal, Субагенты, Инструмент сессии |
| Automation | Планировать работу или реагировать на фоновые события | cron, heartbeat_respond | Automation |
| Gateway и узлы | Проверять состояние Gateway или сопряженные целевые устройства | gateway, nodes | Конфигурация Gateway, Узлы |
| Медиа | Анализировать, генерировать или озвучивать медиа | image, image_generate, music_generate, video_generate, tts | Обзор медиа |
| Большие каталоги OpenClaw | Искать и вызывать множество подходящих инструментов, не отправляя каждую схему модели | tool_search_code, tool_search, tool_describe | Tool Search |
Tool Search — экспериментальная агентская поверхность OpenClaw. Запуски Codex harness используют
нативный для Codex режим кода, нативный поиск инструментов, отложенные динамические инструменты и вложенные
вызовы инструментов вместо
tools.toolSearch.Инструменты, предоставляемые плагинами
Плагины могут регистрировать дополнительные инструменты. Авторы плагинов подключают инструменты черезapi.registerTool(...) и contracts.tools в manifest; подробности контрактов см. в
Plugin SDK и Plugin manifest.
Распространенные инструменты, предоставляемые плагинами:
- Diffs для рендеринга diff файлов и Markdown
- LLM Task для шагов workflow только с JSON
- Lobster для типизированных workflow с возобновляемыми approvals
- Tokenjuice для компактного представления шумного вывода инструментов
execиbash - Tool Search для обнаружения и вызова больших каталогов инструментов без помещения каждой схемы в prompt
- Canvas для управления node Canvas и рендеринга A2UI
Настройка доступа и approvals
Правила инструментов применяются до вызова модели. Если правило удаляет инструмент, модель не получает схему этого инструмента для текущего хода. Запуск может потерять инструменты из-за глобальной конфигурации, конфигурации отдельного агента, правил канала, ограничений провайдера, правил sandbox, правил канала/runtime или доступности плагинов.- Инструменты и пользовательские провайдеры документируют профили инструментов, списки allow/deny, ограничения, специфичные для провайдеров, обнаружение циклов и настройки инструментов с поддержкой провайдера.
- Approvals для exec документирует правила approval для команд хоста.
- Elevated exec документирует контролируемое выполнение вне sandbox.
- Sandbox vs tool policy vs elevated объясняет, какой слой управляет доступом к файлам и процессам.
- Sandbox и ограничения инструментов для отдельных агентов документирует ограничения для делегированных запусков, специфичные для агента.
Расширение возможностей
Выберите путь расширения по задаче, которую OpenClaw должен выполнить:- Установите существующий Plugin или управляйте им с помощью Plugins.
- Создайте новую интеграцию, провайдера, канал, инструмент или хук с помощью Создания Plugins.
- Добавьте или настройте переиспользуемые инструкции агента с помощью Skills и Создания Skills.
- Используйте Plugin SDK и Plugin manifest, когда вам нужны контракты реализации.
Устранение проблем с отсутствующими инструментами
Если модель не видит или не может вызвать инструмент, начните с effective policy для текущего хода:- Проверьте активный профиль,
tools.allowиtools.denyв Инструментах и пользовательских провайдерах. - Проверьте ограничения, специфичные для провайдера, в Инструментах и пользовательских провайдерах и подтвердите, что выбранный провайдер модели поддерживает форму инструмента.
- Проверьте разрешения канала, состояние sandbox и elevated-доступ с помощью Sandbox vs tool policy vs elevated и Elevated exec.
- Проверьте, установлен и включен ли владеющий Plugin в Plugins.
- Для делегированных запусков проверьте ограничения для отдельных агентов в Sandbox и ограничениях инструментов для отдельных агентов.
- Для больших каталогов OpenClaw подтвердите, использует ли запуск прямое предоставление инструментов или Tool Search.
Связанные материалы
- Automation для cron, задач, Heartbeat, обязательств, хуков, постоянных поручений и Task Flow
- Агенты для модели агента, сессий, памяти и координации нескольких агентов
- Инструменты и пользовательские провайдеры для канонического справочника правил инструментов
- Plugins для установки и управления плагинами
- Plugin SDK для справочника автора плагинов
- Skills для порядка загрузки Skills, gating и конфигурации
- Skill Workshop для создания сгенерированных и проверенных Skills
- Tool Search для компактного обнаружения каталога инструментов OpenClaw