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 Виконання команд, Виконання коду
    Файли Читати та змінювати файли робочого простору 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