Почніть тут
Для більшості агентів починайте з вбудованих категорій інструментів, а потім змінюйте політику лише тоді, коли агент має бачити менше інструментів або потребує явного доступу до хоста.| Якщо вам потрібно… | Спершу використайте | Потім прочитайте |
|---|---|---|
| Дозволити агенту діяти з наявними можливостями | Вбудовані інструменти | Категорії інструментів |
| Керувати тим, що агент може викликати | Політика інструментів | Інструменти та користувацькі провайдери |
| Навчити агента робочого процесу | Skills | Skills, Створення Skills і Майстерня Skills |
| Додати нову інтеграцію або поверхню середовища виконання | Plugin-и | Plugin-и і Створення Plugin-ів |
| Запустити роботу пізніше або у фоні | Автоматизація | Огляд автоматизації |
| Координувати кількох агентів або harness-и | Субагенти | Агенти ACP і Надсилання агенту |
| Шукати у великому каталозі інструментів OpenClaw | Пошук інструментів | Пошук інструментів |
Виберіть інструменти, Skills або Plugin-и
Використовуйте інструмент, коли агенту потрібно діяти
Інструмент — це типізована функція, яку агент може викликати, наприклад
exec, browser,
web_search, message або image_generate. Використовуйте інструменти, коли агенту
потрібно читати дані, змінювати файли, надсилати повідомлення, викликати провайдера або керувати
іншою системою. Видимі інструменти надсилаються моделі як структуровані визначення функцій.Модель бачить лише інструменти, які проходять активний профіль, політику allow/deny,
обмеження провайдера, стан пісочниці, дозволи каналу та доступність Plugin-а.Використовуйте Skill, коли агенту потрібні інструкції
Skill — це пакет інструкцій
SKILL.md, завантажений у prompt агента. Використовуйте
Skill, коли агент уже має потрібні інструменти, але потребує повторюваного робочого процесу,
рубрики рев’ю, послідовності команд або операційного обмеження.Skills можуть розміщуватися в робочій області, спільному каталозі Skills, керованому корені
Skills OpenClaw або пакеті Plugin-а.Skills | Майстерня Skills | Створення Skills | Конфігурація SkillsВикористовуйте Plugin, коли OpenClaw потрібна нова можливість
Plugin може додавати інструменти, Skills, канали, провайдерів моделей, мовлення, голос у реальному
часі, генерацію медіа, вебпошук, отримання вебвмісту, хуки та інші можливості середовища виконання.
Використовуйте Plugin, коли можливість має код, облікові дані, хуки життєвого циклу, метадані
маніфесту або встановлюване пакування. Наявні Plugin-и можна встановити з ClawHub, npm, git,
локальних каталогів або архівів.Установлення та налаштування Plugin-ів | Створення Plugin-ів | Plugin SDK
Категорії вбудованих інструментів
У таблиці наведено репрезентативні інструменти, щоб ви могли розпізнати поверхню. Це не повний довідник політики. Точні групи, стандартні значення та семантику allow/deny див. у Інструменти та користувацькі провайдери.| Категорія | Використовуйте, коли агенту потрібно… | Репрезентативні інструменти | Далі прочитайте |
|---|---|---|---|
| Середовище виконання | Запускати команди, керувати процесами або використовувати Python-аналіз із підтримкою провайдера | exec, process, code_execution | Exec, Виконання коду |
| Файли | Читати й змінювати файли робочої області | read, write, edit, apply_patch | Застосування patch |
| Веб | Шукати в інтернеті, шукати дописи X або отримувати читабельний вміст сторінок | web_search, x_search, web_fetch | Вебінструменти, Отримання вебвмісту |
| Браузер | Керувати сесією браузера | browser | Браузер |
| Повідомлення та канали | Надсилати відповіді або дії каналу | message | Надсилання агенту |
| Сесії та агенти | Інспектувати сесії, делегувати роботу, спрямовувати інший запуск або повідомляти статус | sessions_*, subagents, agents_list, session_status, goal | 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 | Пошук інструментів |
Пошук інструментів — це експериментальна поверхня агента OpenClaw. Запуски Codex harness використовують
нативний режим коду Codex, нативний пошук інструментів, відкладені динамічні інструменти та вкладені
виклики інструментів замість
tools.toolSearch.Інструменти, надані Plugin-ами
Plugin-и можуть реєструвати додаткові інструменти. Автори Plugin-ів під’єднують інструменти черезapi.registerTool(...) і contracts.tools маніфесту; докладні відомості про контракти див. у
Plugin SDK і Маніфест Plugin-а.
Поширені інструменти, надані Plugin-ами, включають:
- Diff-и для відображення diff-ів файлів і Markdown
- LLM Task для кроків робочого процесу лише з JSON
- Lobster для типізованих робочих процесів із відновлюваними схваленнями
- Tokenjuice для компактного подання шумного виводу інструментів
execіbash - Пошук інструментів для виявлення й виклику великих каталогів інструментів без додавання кожної схеми до prompt
- Canvas для керування Canvas вузла й рендерингу A2UI
Налаштуйте доступ і схвалення
Політика інструментів застосовується перед викликом моделі. Якщо політика вилучає інструмент, модель не отримує схему цього інструмента для поточного ходу. Запуск може втратити інструменти через глобальну конфігурацію, конфігурацію окремого агента, політику каналу, обмеження провайдера, правила пісочниці, політику каналу/середовища виконання або доступність Plugin-а.- Інструменти та користувацькі провайдери документують профілі інструментів, списки allow/deny, обмеження для конкретних провайдерів, виявлення циклів і налаштування інструментів із підтримкою провайдера.
- Схвалення Exec документують політику схвалення команд хоста.
- Підвищений exec документує контрольоване виконання поза пісочницею.
- Пісочниця проти політики інструментів проти підвищеного доступу пояснює, який рівень керує доступом до файлів і процесів.
- Пісочниця та обмеження інструментів для окремого агента документує специфічні для агента обмеження для делегованих запусків.
Розширення можливостей
Виберіть шлях розширення відповідно до роботи, яку OpenClaw має виконати:- Установіть або керуйте наявним Plugin-ом за допомогою Plugin-и.
- Створіть нову інтеграцію, провайдера, канал, інструмент або хук за допомогою Створення Plugin-ів.
- Додайте або налаштуйте повторно використовувані інструкції агента за допомогою Skills і Створення Skills.
- Використовуйте Plugin SDK і Маніфест Plugin-а, коли вам потрібні контракти реалізації.
Усунення проблем із відсутніми інструментами
Якщо модель не бачить або не може викликати інструмент, почніть з ефективної політики для поточного ходу:- Перевірте активний профіль,
tools.allowіtools.denyу Інструменти та користувацькі провайдери. - Перевірте обмеження для конкретного провайдера в Інструменти та користувацькі провайдери і підтвердьте, що вибраний провайдер моделі підтримує форму інструмента.
- Перевірте дозволи каналу, стан пісочниці та підвищений доступ за допомогою Пісочниця проти політики інструментів проти підвищеного доступу і Підвищений exec.
- Перевірте, чи встановлено й увімкнено Plugin-власник у Plugin-и.
- Для делегованих запусків перевірте обмеження окремого агента в Пісочниця та обмеження інструментів для окремого агента.
- Для великих каталогів OpenClaw підтвердьте, чи запуск використовує пряме надання інструментів, чи Пошук інструментів.
Пов’язане
- Автоматизація для cron, завдань, heartbeat, зобов’язань, хуків, постійних доручень і Task Flow
- Агенти для моделі агента, сесій, пам’яті та координації кількох агентів
- Інструменти та користувацькі провайдери як канонічний довідник політики інструментів
- Plugin-и для встановлення й керування Plugin-ами
- Plugin SDK як довідник для авторів Plugin-ів
- Skills для порядку завантаження Skills, gating і конфігурації
- Майстерня Skills для створення згенерованих і перевірених Skills
- Пошук інструментів для компактного виявлення каталогу інструментів OpenClaw