diff --git a/docs/uk/cli/plugins.md b/docs/uk/cli/plugins.md index 343724ae4..adb809d67 100644 --- a/docs/uk/cli/plugins.md +++ b/docs/uk/cli/plugins.md @@ -1,24 +1,24 @@ --- read_when: - - Ви хочете встановити Plugin-и Gateway чи сумісні пакети або керувати ними - - Ви хочете діагностувати збої завантаження Plugin + - Ви хочете встановити Plugin для Gateway або сумісні набори чи керувати ними + - Ви хочете налагодити збої завантаження Plugin sidebarTitle: Plugins summary: Довідник CLI для `openclaw plugins` (list, install, marketplace, uninstall, enable/disable, doctor) -title: Plugins +title: Плагіни x-i18n: - generated_at: "2026-05-02T17:21:53Z" + generated_at: "2026-05-02T19:03:04Z" model: gpt-5.5 provider: openai - source_hash: 2f29ff970a535812be046648547bb3851d870c2e6d8ce2f836f991c0ca28bbfc + source_hash: 162dac7c3e082d7de3bb4d97573761e824f30f6b0a5a806038ee9fb4f116ee4a source_path: cli/plugins.md workflow: 16 --- -Керуйте плагінами Gateway, пакетами хуків і сумісними бандлами. +Керуйте Plugin Gateway, пакетами хуків і сумісними бандлами. - Посібник для кінцевого користувача з установлення, увімкнення та усунення несправностей плагінів. + Посібник для кінцевих користувачів зі встановлення, увімкнення й усунення несправностей Plugin. Модель сумісності бандлів. @@ -27,7 +27,7 @@ x-i18n: Поля маніфесту та схема конфігурації. - Посилення безпеки для встановлень плагінів. + Посилення безпеки для встановлення Plugin. @@ -59,19 +59,19 @@ openclaw plugins marketplace list openclaw plugins marketplace list --json ``` -Для дослідження повільного встановлення, перевірки, видалення або оновлення реєстру запустіть -команду з `OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1`. Трасування записує таймінги фаз +Для розслідування повільного встановлення, інспектування, видалення або оновлення реєстру запустіть +команду з `OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1`. Трасування записує час виконання фаз у stderr і зберігає JSON-вивід придатним для розбору. Див. [Налагодження](/uk/help/debugging#plugin-lifecycle-trace). -Вбудовані плагіни постачаються з OpenClaw. Деякі увімкнені за замовчуванням (наприклад вбудовані провайдери моделей, вбудовані провайдери мовлення та вбудований браузерний плагін); інші потребують `plugins enable`. +Вбудовані Plugin постачаються з OpenClaw. Деякі ввімкнені за замовчуванням (наприклад вбудовані провайдери моделей, вбудовані провайдери мовлення та вбудований браузерний Plugin); інші потребують `plugins enable`. -Нативні плагіни OpenClaw мають постачати `openclaw.plugin.json` із вбудованою JSON Schema (`configSchema`, навіть якщо вона порожня). Сумісні бандли натомість використовують власні маніфести бандлів. +Нативні Plugin OpenClaw мають постачати `openclaw.plugin.json` із вбудованою JSON Schema (`configSchema`, навіть якщо вона порожня). Сумісні бандли натомість використовують власні маніфести бандлів. -`plugins list` показує `Format: openclaw` або `Format: bundle`. Детальний вивід list/info також показує підтип бандла (`codex`, `claude` або `cursor`) і виявлені можливості бандла. +`plugins list` показує `Format: openclaw` або `Format: bundle`. Докладний вивід list/info також показує підтип бандла (`codex`, `claude` або `cursor`) і виявлені можливості бандла. -### Установлення +### Встановлення ```bash openclaw plugins search "calendar" # search ClawHub plugins @@ -90,97 +90,97 @@ openclaw plugins install --marketplace https://github.com// -Голі назви пакетів спершу перевіряються в ClawHub, а потім у npm. Ставтеся до встановлення плагінів як до запуску коду. Надавайте перевагу зафіксованим версіям. +Голі назви пакетів спочатку перевіряються в ClawHub, а потім у npm. Ставтеся до встановлення Plugin як до запуску коду. Надавайте перевагу зафіксованим версіям. -`plugins search` запитує ClawHub щодо пакетів плагінів, доступних для встановлення, і друкує -назви пакетів, готові до встановлення. Пошук охоплює пакети code-plugin і bundle-plugin, -а не skills. Використовуйте `openclaw skills search` для Skills ClawHub. +`plugins search` запитує ClawHub щодо пакетів Plugin, доступних для встановлення, і виводить +готові до встановлення назви пакетів. Він шукає пакети code-plugin і bundle-plugin, +а не Skills. Використовуйте `openclaw skills search` для Skills у ClawHub. -ClawHub є основною поверхнею розповсюдження й пошуку для більшості плагінів. Npm -залишається підтримуваним резервним варіантом і шляхом прямого встановлення. Під час міграції на -ClawHub OpenClaw усе ще постачає деякі пакети плагінів `@openclaw/*`, що належать OpenClaw, -у npm; версії цих пакетів можуть відставати від вбудованого вихідного коду між релізними -потягами плагінів. Якщо npm повідомляє, що пакет плагіна, який належить OpenClaw, застарів, ця -опублікована версія є старим зовнішнім артефактом; використовуйте плагін, вбудований у +ClawHub є основною поверхнею розповсюдження й пошуку для більшості Plugin. Npm +залишається підтримуваним резервним і прямим шляхом встановлення. Під час міграції до +ClawHub OpenClaw усе ще постачає деякі пакети Plugin `@openclaw/*`, що належать OpenClaw, +у npm; версії цих пакетів можуть відставати від вбудованого джерела між релізними +потоками Plugin. Якщо npm повідомляє, що пакет Plugin, який належить OpenClaw, застарілий, +ця опублікована версія є старим зовнішнім артефактом; використовуйте Plugin, вбудований у поточний OpenClaw, або локальний checkout, доки не буде опубліковано новіший пакет npm. - - Якщо ваш розділ `plugins` підтримується однофайловим `$include`, `plugins install/update/enable/disable/uninstall` записують зміни в цей включений файл і залишають `openclaw.json` без змін. Кореневі включення, масиви включень і включення з сусідніми перевизначеннями завершуються закрито замість вирівнювання. Див. [Включення конфігурації](/uk/gateway/configuration) для підтримуваних форм. + + Якщо ваш розділ `plugins` підкріплений однофайловим `$include`, `plugins install/update/enable/disable/uninstall` записують зміни до цього включеного файлу й залишають `openclaw.json` без змін. Кореневі включення, масиви включень і включення із сусідніми перевизначеннями завершуються закрито замість розгортання. Див. [Config includes](/uk/gateway/configuration) щодо підтримуваних форм. - Якщо конфігурація недійсна під час установлення, `plugins install` зазвичай завершується закрито й просить спершу запустити `openclaw doctor --fix`. Під час запуску Gateway недійсна конфігурація одного плагіна ізолюється до цього плагіна, щоб інші канали та плагіни могли продовжувати роботу; `openclaw doctor --fix` може помістити недійсний запис плагіна в карантин. Єдиний задокументований виняток під час установлення — вузький шлях відновлення вбудованого плагіна для плагінів, які явно погоджуються на `openclaw.install.allowInvalidConfigRecovery`. + Якщо під час встановлення конфігурація недійсна, `plugins install` зазвичай завершується закрито й повідомляє, що спершу потрібно запустити `openclaw doctor --fix`. Під час запуску Gateway недійсна конфігурація одного Plugin ізолюється до цього Plugin, щоб інші канали та Plugin могли продовжувати працювати; `openclaw doctor --fix` може помістити недійсний запис Plugin у карантин. Єдиний задокументований виняток під час встановлення — вузький шлях відновлення для вбудованих Plugin, які явно вмикають `openclaw.install.allowInvalidConfigRecovery`. - - `--force` повторно використовує наявну ціль установлення та на місці перезаписує вже встановлений плагін або пакет хуків. Використовуйте його, коли навмисно перевстановлюєте той самий id із нового локального шляху, архіву, пакета ClawHub або артефакта npm. Для звичайних оновлень уже відстежуваного npm-плагіна надавайте перевагу `openclaw plugins update `. + + `--force` повторно використовує наявну ціль встановлення й перезаписує вже встановлений Plugin або пакет хуків на місці. Використовуйте його, коли ви навмисно перевстановлюєте той самий id із нового локального шляху, архіву, пакета ClawHub або артефакту npm. Для звичайних оновлень уже відстежуваного npm Plugin надавайте перевагу `openclaw plugins update `. - Якщо ви запускаєте `plugins install` для id плагіна, який уже встановлено, OpenClaw зупиняється й указує на `plugins update ` для звичайного оновлення або на `plugins install --force`, коли справді потрібно перезаписати поточне встановлення з іншого джерела. + Якщо ви запускаєте `plugins install` для id Plugin, який уже встановлено, OpenClaw зупиняється й спрямовує вас до `plugins update ` для звичайного оновлення або до `plugins install --force`, коли ви справді хочете перезаписати поточне встановлення з іншого джерела. - `--pin` застосовується лише до встановлень npm. Він не підтримується з установленнями `git:`; використовуйте явний git ref, наприклад `git:github.com/acme/plugin@v1.2.3`, коли потрібно зафіксувати джерело. Він не підтримується з `--marketplace`, оскільки встановлення з marketplace зберігають метадані джерела marketplace замість npm spec. + `--pin` застосовується лише до встановлень npm. Він не підтримується з установленнями `git:`; використовуйте явний git ref, наприклад `git:github.com/acme/plugin@v1.2.3`, коли хочете зафіксоване джерело. Він не підтримується з `--marketplace`, бо встановлення з marketplace зберігають метадані джерела marketplace замість специфікації npm. - `--dangerously-force-unsafe-install` — це аварійна опція для хибних спрацьовувань у вбудованому сканері небезпечного коду. Вона дозволяє продовжити встановлення, навіть коли вбудований сканер повідомляє про знахідки `critical`, але вона **не** обходить блокування політики хуків `before_install` плагіна й **не** обходить помилки сканування. + `--dangerously-force-unsafe-install` — це аварійна опція для хибних спрацювань у вбудованому сканері небезпечного коду. Вона дозволяє продовжити встановлення, навіть коли вбудований сканер повідомляє про знахідки `critical`, але вона **не** обходить блокування політики хуків Plugin `before_install` і **не** обходить помилки сканування. - Цей CLI-прапорець застосовується до потоків install/update для плагінів. Установлення залежностей Skills, підтримувані Gateway, використовують відповідне перевизначення запиту `dangerouslyForceUnsafeInstall`, тоді як `openclaw skills install` лишається окремим потоком завантаження/встановлення Skills із ClawHub. + Цей прапорець CLI застосовується до потоків встановлення/оновлення Plugin. Встановлення залежностей Skills через Gateway використовують відповідне перевизначення запиту `dangerouslyForceUnsafeInstall`, тоді як `openclaw skills install` залишається окремим потоком завантаження/встановлення Skills із ClawHub. - Якщо плагін, який ви опублікували в ClawHub, заблоковано скануванням реєстру, скористайтеся кроками для видавця в [ClawHub](/uk/tools/clawhub). + Якщо Plugin, який ви опублікували в ClawHub, заблоковано скануванням реєстру, скористайтеся кроками для видавців у [ClawHub](/uk/tools/clawhub). - - `plugins install` також є поверхнею встановлення для пакетів хуків, які експонують `openclaw.hooks` у `package.json`. Використовуйте `openclaw hooks` для фільтрованої видимості хуків і ввімкнення окремих хуків, а не для встановлення пакетів. + + `plugins install` також є поверхнею встановлення для пакетів хуків, які відкривають `openclaw.hooks` у `package.json`. Використовуйте `openclaw hooks` для фільтрованої видимості хуків і ввімкнення окремих хуків, а не для встановлення пакетів. - Npm specs є **лише реєстровими** (назва пакета + необов’язкова **точна версія** або **dist-tag**). Git/URL/file specs і діапазони semver відхиляються. Установлення залежностей виконуються локально для проєкту з `--ignore-scripts` заради безпеки, навіть якщо ваша оболонка має глобальні налаштування npm install. + Специфікації npm є **лише реєстровими** (назва пакета + необов’язкова **точна версія** або **dist-tag**). Специфікації Git/URL/file і діапазони semver відхиляються. Встановлення залежностей виконується локально для проєкту з `--ignore-scripts` задля безпеки, навіть якщо ваша оболонка має глобальні налаштування встановлення npm. - Використовуйте `npm:`, коли хочете пропустити пошук у ClawHub і встановити напряму з npm. Голі specs пакетів усе ще віддають перевагу ClawHub і повертаються до npm лише тоді, коли ClawHub не має такого пакета або версії. + Використовуйте `npm:`, коли хочете пропустити пошук у ClawHub і встановити безпосередньо з npm. Голі специфікації пакетів усе ще надають перевагу ClawHub і повертаються до npm лише тоді, коли ClawHub не має такого пакета або версії. - Голі specs і `@latest` залишаються на стабільному треку. Якщо npm вирішує будь-який із них у prerelease, OpenClaw зупиняється й просить явно погодитися за допомогою prerelease-тега, як-от `@beta`/`@rc`, або точної prerelease-версії, як-от `@1.2.3-beta.4`. + Голі специфікації та `@latest` залишаються на стабільному треку. Якщо npm розв’язує будь-яку з них у prerelease, OpenClaw зупиняється й просить вас явно погодитися за допомогою prerelease-тега, наприклад `@beta`/`@rc`, або точної prerelease-версії, наприклад `@1.2.3-beta.4`. - Якщо голий spec установлення відповідає офіційному id плагіна (наприклад `diffs`), OpenClaw встановлює запис каталогу напряму. Щоб встановити npm-пакет із такою самою назвою, використовуйте явний scoped spec (наприклад `@scope/diffs`). + Якщо гола специфікація встановлення збігається з офіційним id Plugin (наприклад `diffs`), OpenClaw встановлює запис каталогу безпосередньо. Щоб встановити пакет npm із такою самою назвою, використовуйте явну scoped-специфікацію (наприклад `@scope/diffs`). - Використовуйте `git:` для прямого встановлення з git-репозиторію. Підтримувані форми включають `git:github.com/owner/repo`, `git:owner/repo`, повні clone URL `https://`, `ssh://`, `git://`, `file://` і `git@host:owner/repo.git`. Додайте `@` або `#`, щоб перед установленням перейти на гілку, тег або коміт. + Використовуйте `git:`, щоб встановити безпосередньо з git-репозиторію. Підтримувані форми включають `git:github.com/owner/repo`, `git:owner/repo`, повні URL клонування `https://`, `ssh://`, `git://`, `file://` і `git@host:owner/repo.git`. Додайте `@` або `#`, щоб checkout гілку, тег або коміт перед встановленням. - Git-установлення клонують у тимчасовий каталог, переходять на запитаний ref, якщо він присутній, а потім використовують звичайний інсталятор каталогу плагіна. Це означає, що перевірка маніфесту, сканування небезпечного коду, робота встановлення менеджера пакетів і записи встановлення поводяться як у npm-установленнях. Записані git-установлення включають URL/ref джерела та розв’язаний коміт, щоб `openclaw plugins update` міг пізніше повторно розв’язати джерело. + Встановлення з Git клонують у тимчасовий каталог, виконують checkout запитаного ref, якщо він є, а потім використовують звичайний інсталятор каталогу Plugin. Це означає, що валідація маніфесту, сканування небезпечного коду, робота встановлення менеджера пакетів і записи встановлення поводяться як встановлення npm. Записані встановлення з git містять URL/ref джерела та розв’язаний коміт, щоб `openclaw plugins update` міг повторно розв’язати джерело пізніше. - Після встановлення з git використовуйте `openclaw plugins inspect --runtime --json`, щоб перевірити runtime-реєстрації, як-от методи gateway і CLI-команди. Якщо плагін зареєстрував корінь CLI через `api.registerCli`, виконайте цю команду напряму через кореневий CLI OpenClaw, наприклад `openclaw demo-plugin ping`. + Після встановлення з git використовуйте `openclaw plugins inspect --runtime --json`, щоб перевірити реєстрації runtime, як-от методи Gateway і команди CLI. Якщо Plugin зареєстрував корінь CLI через `api.registerCli`, виконайте цю команду безпосередньо через кореневий CLI OpenClaw, наприклад `openclaw demo-plugin ping`. - Підтримувані архіви: `.zip`, `.tgz`, `.tar.gz`, `.tar`. Архіви нативних плагінів OpenClaw мають містити дійсний `openclaw.plugin.json` у корені витягнутого плагіна; архіви, які містять лише `package.json`, відхиляються до того, як OpenClaw запише записи встановлення. + Підтримувані архіви: `.zip`, `.tgz`, `.tar.gz`, `.tar`. Архіви нативних Plugin OpenClaw мають містити чинний `openclaw.plugin.json` у корені розпакованого Plugin; архіви, які містять лише `package.json`, відхиляються до того, як OpenClaw запише записи встановлення. - Установлення з Claude marketplace також підтримуються. + Також підтримуються встановлення з Claude marketplace. -Установлення ClawHub використовують явний локатор `clawhub:`: +Встановлення з ClawHub використовують явний локатор `clawhub:`: ```bash openclaw plugins install clawhub:openclaw-codex-app-server openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3 ``` -OpenClaw тепер також віддає перевагу ClawHub для голих npm-безпечних specs плагінів. Він повертається до npm лише якщо ClawHub не має такого пакета або версії: +OpenClaw тепер також надає перевагу ClawHub для голих npm-безпечних специфікацій Plugin. Він повертається до npm лише якщо ClawHub не має такого пакета або версії: ```bash openclaw plugins install openclaw-codex-app-server ``` -Використовуйте `npm:`, щоб примусово застосувати розв’язання лише через npm, наприклад коли ClawHub недоступний або ви знаєте, що пакет існує лише в npm: +Використовуйте `npm:`, щоб примусити розв’язання лише через npm, наприклад коли ClawHub недоступний або ви знаєте, що пакет існує лише в npm: ```bash openclaw plugins install npm:openclaw-codex-app-server openclaw plugins install npm:@scope/plugin-name@1.0.1 ``` -OpenClaw перевіряє рекламований plugin API / мінімальну сумісність gateway перед установленням. Коли вибрана версія ClawHub публікує артефакт ClawPack, OpenClaw завантажує версійний npm-pack `.tgz`, перевіряє digest-заголовок ClawHub і digest артефакта, а потім встановлює його через звичайний шлях архіву. Старіші версії ClawHub без метаданих ClawPack усе ще встановлюються через застарілий шлях перевірки архіву пакета. Записані встановлення зберігають свої метадані джерела ClawHub, тип артефакта, npm integrity, npm shasum, назву tarball і факти digest ClawPack для подальших оновлень. -Неверсійовані встановлення ClawHub зберігають неверсійований записаний spec, щоб `openclaw plugins update` міг стежити за новішими релізами ClawHub; явні селектори версії або тега, як-от `clawhub:pkg@1.2.3` і `clawhub:pkg@beta`, залишаються зафіксованими на цьому селекторі. +OpenClaw перевіряє заявлену сумісність API Plugin / мінімального Gateway перед встановленням. Коли вибрана версія ClawHub публікує артефакт ClawPack, OpenClaw завантажує версійний npm-pack `.tgz`, перевіряє заголовок дайджесту ClawHub і дайджест артефакту, а потім встановлює його через звичайний шлях архіву. Старіші версії ClawHub без метаданих ClawPack усе ще встановлюються через застарілий шлях перевірки архіву пакета. Записані встановлення зберігають свої метадані джерела ClawHub, тип артефакту, npm integrity, npm shasum, назву tarball і факти дайджесту ClawPack для подальших оновлень. +Неверсійні встановлення з ClawHub зберігають неверсійну записану специфікацію, щоб `openclaw plugins update` міг стежити за новішими релізами ClawHub; явні селектори версії або тега, як-от `clawhub:pkg@1.2.3` і `clawhub:pkg@beta`, залишаються зафіксованими на цьому селекторі. #### Скорочення marketplace @@ -201,28 +201,28 @@ openclaw plugins install --marketplace ./my-marketplace ``` - - - відома назва marketplace Claude з `~/.claude/plugins/known_marketplaces.json` - - локальний корінь marketplace або шлях до `marketplace.json` + + - назва відомого маркетплейсу Claude з `~/.claude/plugins/known_marketplaces.json` + - локальний корінь маркетплейсу або шлях `marketplace.json` - скорочення репозиторію GitHub, як-от `owner/repo` - URL репозиторію GitHub, як-от `https://github.com/owner/repo` - git URL - - Для віддалених marketplace, завантажених із GitHub або git, записи plugin мають залишатися всередині клонованого репозиторію marketplace. OpenClaw приймає джерела з відносними шляхами з цього репозиторію та відхиляє HTTP(S), абсолютні шляхи, git, GitHub та інші непутьові джерела plugin із віддалених маніфестів. + + Для віддалених маркетплейсів, завантажених із GitHub або git, записи Plugin мають залишатися всередині клонованого репозиторію маркетплейсу. OpenClaw приймає джерела з відносними шляхами з цього репозиторію та відхиляє HTTP(S), абсолютні шляхи, git, GitHub та інші непутеві джерела Plugin з віддалених маніфестів. Для локальних шляхів і архівів OpenClaw автоматично визначає: -- нативні plugins OpenClaw (`openclaw.plugin.json`) +- нативні Plugin OpenClaw (`openclaw.plugin.json`) - сумісні з Codex пакети (`.codex-plugin/plugin.json`) -- сумісні з Claude пакети (`.claude-plugin/plugin.json` або стандартну структуру компонентів Claude) +- сумісні з Claude пакети (`.claude-plugin/plugin.json` або типовий макет компонентів Claude) - сумісні з Cursor пакети (`.cursor-plugin/plugin.json`) -Сумісні пакети встановлюються у звичайний корінь plugin і беруть участь у тому самому потоці list/info/enable/disable. Наразі підтримуються Skills пакета, command-skills Claude, типові значення `settings.json` Claude, типові значення `.lsp.json` Claude / оголошені в маніфесті `lspServers`, command-skills Cursor і сумісні каталоги хуків Codex; інші виявлені можливості пакетів показуються в діагностиці/info, але ще не підключені до виконання під час роботи. +Сумісні пакети встановлюються у звичайний корінь Plugin і беруть участь у тому самому потоці list/info/enable/disable. Наразі підтримуються Skills пакетів, command-skills Claude, типові значення Claude `settings.json`, типові значення Claude `.lsp.json` / оголошених у маніфесті `lspServers`, command-skills Cursor і сумісні каталоги хуків Codex; інші виявлені можливості пакетів показуються в діагностиці/info, але ще не підключені до виконання під час роботи. ### Список @@ -238,35 +238,41 @@ openclaw plugins search --json ``` - Показати лише ввімкнені plugins. + Показувати лише ввімкнені Plugin. - Перемкнутися з табличного подання на рядки деталей для кожного plugin з метаданими source/origin/version/activation. + Перемкнутися з табличного подання на рядки з деталями для кожного Plugin, що містять метадані джерела/походження/версії/активації. - Машинозчитувана інвентаризація плюс діагностика реєстру. + Машиночитний інвентар, а також діагностика реєстру й стан встановлення залежностей пакетів. -`plugins list` спершу читає збережений локальний реєстр plugin, із запасним варіантом, виведеним лише з маніфестів, коли реєстр відсутній або недійсний. Це корисно, щоб перевірити, чи встановлено plugin, чи його ввімкнено і чи він видимий для планування холодного запуску, але це не live-зонд під час роботи вже запущеного процесу Gateway. Після зміни коду plugin, стану ввімкнення, політики хуків або `plugins.load.paths` перезапустіть Gateway, який обслуговує канал, перш ніж очікувати виконання нового коду `register(api)` або хуків. Для віддалених/контейнерних розгортань перевірте, що ви перезапускаєте фактичний дочірній процес `openclaw gateway run`, а не лише процес-обгортку. +`plugins list` спочатку читає збережений локальний реєстр Plugin, із резервним варіантом, виведеним лише з маніфестів, коли реєстр відсутній або недійсний. Це корисно для перевірки, чи встановлений Plugin, чи ввімкнений він і чи видимий для планування холодного запуску, але це не live-зонд середовища виконання вже запущеного процесу Gateway. Після зміни коду Plugin, стану ввімкнення, політики хуків або `plugins.load.paths` перезапустіть Gateway, який обслуговує канал, перш ніж очікувати запуску нового коду `register(api)` або хуків. Для віддалених/контейнерних розгортань перевірте, що ви перезапускаєте фактичний дочірній процес `openclaw gateway run`, а не лише процес-обгортку. + +`plugins list --json` включає `dependencyStatus` кожного Plugin з `package.json` +`dependencies` і `optionalDependencies`. OpenClaw перевіряє, чи присутні ці назви пакетів +уздовж звичайного шляху пошуку Node `node_modules` для Plugin; він +не імпортує код Plugin часу виконання, не запускає менеджер пакетів і не виправляє +відсутні залежності. `plugins search` — це віддалений пошук у каталозі ClawHub. Він не перевіряє локальний -стан, не змінює конфігурацію, не встановлює пакети й не завантажує runtime-код plugin. Результати пошуку -містять назву пакета ClawHub, family, channel, version, summary і +стан, не змінює конфігурацію, не встановлює пакети й не завантажує код Plugin часу виконання. Результати пошуку +містять назву пакета ClawHub, сімейство, канал, версію, короткий опис і підказку для встановлення, як-от `openclaw plugins install clawhub:`. -Для роботи з вбудованими plugin всередині запакованого образу Docker змонтуйте каталог -джерел plugin поверх відповідного запакованого шляху до джерел, наприклад -`/app/extensions/synology-chat`. OpenClaw виявить це змонтоване overlay джерел -перед `/app/dist/extensions/synology-chat`; звичайний скопійований каталог джерел -залишається неактивним, тож стандартні запаковані встановлення й далі використовують скомпільований dist. +Для роботи з вбудованими Plugin у запакованому образі Docker змонтуйте з прив’язкою каталог +джерельного коду Plugin поверх відповідного запакованого шляху джерел, наприклад +`/app/extensions/synology-chat`. OpenClaw виявить це змонтоване +перекриття джерел перед `/app/dist/extensions/synology-chat`; звичайний скопійований каталог +джерел залишиться інертним, тому звичайні запаковані встановлення й надалі використовуватимуть скомпільований dist. -Для налагодження runtime-хуків: +Для налагодження хуків часу виконання: -- `openclaw plugins inspect --runtime --json` показує зареєстровані хуки та діагностику з проходу інспекції із завантаженням модуля. Runtime-інспекція ніколи не встановлює залежності; використовуйте `openclaw doctor --fix`, щоб очистити застарілий стан залежностей або встановити відсутні налаштовані завантажувані plugins. -- `openclaw gateway status --deep --require-rpc` підтверджує доступний Gateway, підказки service/process, шлях конфігурації та стан RPC. -- Невбудовані хуки розмов (`llm_input`, `llm_output`, `before_agent_finalize`, `agent_end`) потребують `plugins.entries..hooks.allowConversationAccess=true`. +- `openclaw plugins inspect --runtime --json` показує зареєстровані хуки та діагностику з проходу інспекції із завантаженням модуля. Інспекція часу виконання ніколи не встановлює залежності; використовуйте `openclaw doctor --fix`, щоб очистити застарілий стан залежностей або встановити відсутні налаштовані завантажувані Plugin. +- `openclaw gateway status --deep --require-rpc` підтверджує доступний Gateway, підказки щодо служби/процесу, шлях конфігурації та справність RPC. +- Невбудовані хуки розмови (`llm_input`, `llm_output`, `before_agent_finalize`, `agent_end`) потребують `plugins.entries..hooks.allowConversationAccess=true`. Використовуйте `--link`, щоб уникнути копіювання локального каталогу (додає до `plugins.load.paths`): @@ -275,16 +281,16 @@ openclaw plugins install -l ./my-plugin ``` -`--force` не підтримується з `--link`, оскільки пов'язані встановлення повторно використовують шлях до джерел замість копіювання поверх керованої цілі встановлення. +`--force` не підтримується з `--link`, оскільки пов’язані встановлення повторно використовують шлях джерела замість копіювання поверх керованої цілі встановлення. -Використовуйте `--pin` для npm-встановлень, щоб зберегти розв'язану точну специфікацію (`name@version`) у керованому індексі plugin, залишаючи стандартну поведінку незакріпленою. +Використовуйте `--pin` під час npm-встановлень, щоб зберегти розв’язану точну специфікацію (`name@version`) у керованому індексі Plugin, зберігаючи типову поведінку незакріпленою. ### Індекс Plugin -Метадані встановлення Plugin — це машинно керований стан, а не користувацька конфігурація. Встановлення й оновлення записують його до `plugins/installs.json` у активному каталозі стану OpenClaw. Його верхньорівнева мапа `installRecords` є довговічним джерелом метаданих встановлення, включно із записами для зламаних або відсутніх маніфестів plugin. Масив `plugins` — це кеш холодного реєстру, виведений із маніфестів. Файл містить попередження не редагувати його і використовується `openclaw plugins update`, видаленням, діагностикою та холодним реєстром plugin. +Метадані встановлення Plugin — це машинно керований стан, а не користувацька конфігурація. Встановлення й оновлення записують його до `plugins/installs.json` у поточному каталозі стану OpenClaw. Його верхньорівнева мапа `installRecords` є довготривалим джерелом метаданих встановлення, включно із записами для зламаних або відсутніх маніфестів Plugin. Масив `plugins` — це холодний кеш реєстру, виведений із маніфестів. Файл містить попередження не редагувати його та використовується `openclaw plugins update`, видаленням, діагностикою й холодним реєстром Plugin. -Коли OpenClaw бачить поставлені застарілі записи `plugins.installs` у конфігурації, він переносить їх в індекс plugin і видаляє ключ конфігурації; якщо будь-який запис не вдається, записи конфігурації зберігаються, щоб метадані встановлення не було втрачено. +Коли OpenClaw бачить поставлені застарілі записи `plugins.installs` у конфігурації, він переносить їх в індекс Plugin і видаляє ключ конфігурації; якщо будь-який запис не вдається, записи конфігурації зберігаються, щоб метадані встановлення не були втрачені. ### Видалення @@ -294,7 +300,7 @@ openclaw plugins uninstall --dry-run openclaw plugins uninstall --keep-files ``` -`uninstall` видаляє записи plugin з `plugins.entries`, збереженого індексу plugin, записів списку дозволів/заборон plugin і пов'язаних записів `plugins.load.paths`, коли це застосовно. Якщо не задано `--keep-files`, видалення також прибирає відстежуваний керований каталог встановлення, коли він розташований у корені розширень plugin OpenClaw. Для plugins active memory слот пам'яті скидається до `memory-core`. +`uninstall` видаляє записи Plugin з `plugins.entries`, збереженого індексу Plugin, записів списків дозволу/заборони Plugin і пов’язаних записів `plugins.load.paths`, коли це застосовно. Якщо `--keep-files` не задано, видалення також прибирає відстежуваний керований каталог встановлення, коли він розташований у корені розширень Plugin OpenClaw. Для Plugin active memory слот пам’яті скидається до `memory-core`. `--keep-config` підтримується як застарілий псевдонім для `--keep-files`. @@ -310,25 +316,25 @@ openclaw plugins update @openclaw/voice-call@beta openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install ``` -Оновлення застосовуються до відстежуваних встановлень plugin у керованому індексі plugin і відстежуваних встановлень hook-pack у `hooks.internal.installs`. +Оновлення застосовуються до відстежуваних встановлень Plugin у керованому індексі Plugin і відстежуваних встановлень hook-pack у `hooks.internal.installs`. - - Коли ви передаєте id plugin, OpenClaw повторно використовує записану специфікацію встановлення для цього plugin. Це означає, що раніше збережені dist-tags, як-от `@beta`, і точні закріплені версії й надалі використовуються під час наступних запусків `update `. + + Коли ви передаєте id Plugin, OpenClaw повторно використовує записану специфікацію встановлення для цього Plugin. Це означає, що раніше збережені dist-tags, як-от `@beta`, і точні закріплені версії продовжують використовуватися під час наступних запусків `update `. - Для npm-встановлень ви також можете передати явну специфікацію npm-пакета з dist-tag або точною версією. OpenClaw зіставляє цю назву пакета назад із відстежуваним записом plugin, оновлює встановлений plugin і записує нову npm-специфікацію для майбутніх оновлень на основі id. + Для npm-встановлень ви також можете передати явну специфікацію npm-пакета з dist-tag або точною версією. OpenClaw зіставляє цю назву пакета назад із відстежуваним записом Plugin, оновлює цей встановлений Plugin і записує нову специфікацію npm для майбутніх оновлень на основі id. - Передавання назви npm-пакета без версії або тегу також зіставляється назад із відстежуваним записом plugin. Використовуйте це, коли plugin було закріплено на точній версії, а ви хочете повернути його до стандартної лінії релізів реєстру. + Передавання назви npm-пакета без версії або тега також зіставляється назад із відстежуваним записом Plugin. Використовуйте це, коли Plugin був закріплений на точній версії, а ви хочете повернути його до типової лінії випусків реєстру. - - Перед live-оновленням npm OpenClaw перевіряє встановлену версію пакета за метаданими npm registry. Якщо встановлена версія і записана ідентичність артефакта вже збігаються з розв'язаною ціллю, оновлення пропускається без завантаження, перевстановлення або перезапису `openclaw.json`. + + Перед live-оновленням npm OpenClaw перевіряє встановлену версію пакета за метаданими реєстру npm. Якщо встановлена версія та записана ідентичність артефакту вже збігаються з розв’язаною ціллю, оновлення пропускається без завантаження, перевстановлення або перезапису `openclaw.json`. - Коли існує збережений integrity hash і hash отриманого артефакта змінюється, OpenClaw трактує це як drift артефакта npm. Інтерактивна команда `openclaw plugins update` друкує очікуваний і фактичний hashes та просить підтвердження перед продовженням. Неінтерактивні помічники оновлення fail closed, якщо викликач не надає явну політику продовження. + Коли існує збережений хеш цілісності й хеш отриманого артефакту змінюється, OpenClaw трактує це як дрейф артефакту npm. Інтерактивна команда `openclaw plugins update` друкує очікуваний і фактичний хеші та просить підтвердження перед продовженням. Неінтерактивні помічники оновлення завершуються закрито, якщо викликач не надає явну політику продовження. - `--dangerously-force-unsafe-install` також доступний у `plugins update` як break-glass override для хибних спрацювань вбудованого сканування dangerous-code під час оновлень plugin. Він усе одно не обходить блокування політики `before_install` plugin або блокування через помилку сканування, і застосовується лише до оновлень plugin, а не до оновлень hook-pack. + `--dangerously-force-unsafe-install` також доступний у `plugins update` як аварійний override для хибних спрацювань вбудованого сканування небезпечного коду під час оновлень Plugin. Він усе одно не обходить блокування політики `before_install` Plugin або блокування через помилки сканування, і застосовується лише до оновлень Plugin, а не до оновлень hook-pack. @@ -340,21 +346,21 @@ openclaw plugins inspect --runtime openclaw plugins inspect --json ``` -Inspect показує identity, load status, source, manifest capabilities, policy flags, diagnostics, install metadata, bundle capabilities і будь-яку виявлену підтримку серверів MCP або LSP без імпорту runtime plugin за замовчуванням. Додайте `--runtime`, щоб завантажити модуль plugin і включити зареєстровані hooks, tools, commands, services, gateway methods і HTTP routes. Runtime-інспекція повідомляє про відсутні залежності plugin напряму; встановлення й ремонти залишаються в `openclaw plugins install`, `openclaw plugins update` і `openclaw doctor --fix`. +Inspect показує ідентичність, стан завантаження, джерело, можливості маніфесту, прапорці політик, діагностику, метадані встановлення, можливості пакетів і будь-яку виявлену підтримку серверів MCP або LSP без імпорту коду Plugin часу виконання за замовчуванням. Додайте `--runtime`, щоб завантажити модуль Plugin і включити зареєстровані хуки, інструменти, команди, служби, методи Gateway і HTTP-маршрути. Інспекція часу виконання прямо повідомляє про відсутні залежності Plugin; встановлення й виправлення залишаються в `openclaw plugins install`, `openclaw plugins update` і `openclaw doctor --fix`. -CLI-команди, якими володіє plugin, встановлюються як кореневі групи команд `openclaw`. Після того як `inspect --runtime` показує команду в `cliCommands`, запускайте її як `openclaw ...`; наприклад, plugin, який реєструє `demo-git`, можна перевірити через `openclaw demo-git ping`. +CLI-команди, якими володіє Plugin, встановлюються як кореневі групи команд `openclaw`. Після того як `inspect --runtime` показує команду в `cliCommands`, запускайте її як `openclaw ...`; наприклад, Plugin, який реєструє `demo-git`, можна перевірити за допомогою `openclaw demo-git ping`. -Кожен plugin класифікується за тим, що він фактично реєструє під час роботи: +Кожен Plugin класифікується за тим, що він фактично реєструє під час виконання: -- **plain-capability** — один тип capability (наприклад, plugin лише для provider) -- **hybrid-capability** — кілька типів capability (наприклад, text + speech + images) -- **hook-only** — лише hooks, без capabilities або surfaces -- **non-capability** — tools/commands/services, але без capabilities +- **plain-capability** — один тип можливості (наприклад, Plugin лише для провайдера) +- **hybrid-capability** — кілька типів можливостей (наприклад, текст + мовлення + зображення) +- **hook-only** — лише хуки, без можливостей або поверхонь +- **non-capability** — інструменти/команди/служби, але без можливостей -Докладніше про модель capability див. [Форми Plugin](/uk/plugins/architecture#plugin-shapes). +Див. [Форми Plugin](/uk/plugins/architecture#plugin-shapes), щоб дізнатися більше про модель можливостей. -Прапорець `--json` виводить машинозчитуваний звіт, придатний для скриптів і аудиту. `inspect --all` рендерить таблицю для всього парку з колонками shape, capability kinds, compatibility notices, bundle capabilities і hook summary. `info` — це псевдонім для `inspect`. +Прапорець `--json` виводить машиночитний звіт, придатний для скриптів і аудиту. `inspect --all` відображає таблицю для всього парку з колонками форми, типів можливостей, повідомлень сумісності, можливостей пакетів і зведення хуків. `info` є псевдонімом для `inspect`. ### Doctor @@ -363,9 +369,9 @@ CLI-команди, якими володіє plugin, встановлюютьс openclaw plugins doctor ``` -`doctor` повідомляє про помилки завантаження plugin, діагностику manifest/discovery і compatibility notices. Коли все чисто, він друкує `No plugin issues detected.` +`doctor` повідомляє про помилки завантаження Plugin, діагностику маніфесту/виявлення та повідомлення сумісності. Коли все чисто, він друкує `No plugin issues detected.` -Для помилок форми модуля, як-от відсутні exports `register`/`activate`, повторіть запуск із `OPENCLAW_PLUGIN_LOAD_DEBUG=1`, щоб включити компактний підсумок export-shape у діагностичний вивід. +Для збоїв форми модуля, як-от відсутніх експортів `register`/`activate`, запустіть повторно з `OPENCLAW_PLUGIN_LOAD_DEBUG=1`, щоб включити компактне зведення форми експортів у діагностичний вивід. ### Реєстр @@ -375,25 +381,25 @@ openclaw plugins registry --refresh openclaw plugins registry --json ``` -Локальний реєстр plugin — це збережена cold read model OpenClaw для installed plugin identity, enablement, source metadata і contribution ownership. Звичайний запуск, пошук власника provider, класифікація налаштування каналу та інвентаризація plugin можуть читати його без імпорту runtime-модулів plugin. +Локальний реєстр Plugin — це збережена в OpenClaw холодна модель читання для ідентичності встановлених Plugin, стану ввімкнення, метаданих джерела й володіння внесками. Звичайний запуск, пошук власника провайдера, класифікація налаштування каналу та інвентар Plugin можуть читати його без імпорту модулів Plugin часу виконання. -Використовуйте `plugins registry`, щоб перевірити, чи збережений реєстр присутній, актуальний або застарілий. Використовуйте `--refresh`, щоб перебудувати його зі збереженого індексу plugin, config policy і manifest/package metadata. Це шлях ремонту, а не шлях runtime-активації. +Використовуйте `plugins registry`, щоб перевірити, чи збережений реєстр присутній, актуальний або застарілий. Використовуйте `--refresh`, щоб перебудувати його зі збереженого індексу Plugin, політики конфігурації та метаданих маніфесту/пакета. Це шлях виправлення, а не шлях активації часу виконання. -`OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY=1` — застарілий break-glass compatibility switch для збоїв читання реєстру. Надавайте перевагу `plugins registry --refresh` або `openclaw doctor --fix`; env fallback призначений лише для аварійного відновлення запуску, доки міграція розгортається. +`OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY=1` — це застарілий аварійний перемикач сумісності для збоїв читання реєстру. Надавайте перевагу `plugins registry --refresh` або `openclaw doctor --fix`; резервний варіант env призначений лише для аварійного відновлення запуску, поки розгортається міграція. -### Marketplace +### Маркетплейс ```bash openclaw plugins marketplace list openclaw plugins marketplace list --json ``` -Marketplace list приймає локальний шлях marketplace, шлях до `marketplace.json`, скорочення GitHub на кшталт `owner/repo`, URL репозиторію GitHub або git URL. `--json` друкує розв'язану мітку джерела плюс розібраний маніфест marketplace і записи plugin. +Список маркетплейсу приймає локальний шлях маркетплейсу, шлях `marketplace.json`, скорочення GitHub на кшталт `owner/repo`, URL репозиторію GitHub або git URL. `--json` друкує розв’язану мітку джерела, а також розібраний маніфест маркетплейсу й записи Plugin. -## Пов'язане +## Пов’язане -- [Створення plugins](/uk/plugins/building-plugins) +- [Створення Plugin](/uk/plugins/building-plugins) - [Довідник CLI](/uk/cli) -- [Plugins спільноти](/uk/plugins/community) +- [Plugin спільноти](/uk/plugins/community) diff --git a/docs/uk/tools/plugin.md b/docs/uk/tools/plugin.md index efd8ddd67..fb193f738 100644 --- a/docs/uk/tools/plugin.md +++ b/docs/uk/tools/plugin.md @@ -1,38 +1,38 @@ --- read_when: - - Встановлення або налаштування плагінів + - Установлення або налаштування плагінів - Розуміння правил виявлення та завантаження Plugin - Робота з пакетами Plugin, сумісними з Codex/Claude sidebarTitle: Install and Configure -summary: Встановлюйте, налаштовуйте та керуйте плагінами OpenClaw -title: Плагіни +summary: Встановлюйте, налаштовуйте та керуйте Plugin OpenClaw +title: Plugins x-i18n: - generated_at: "2026-05-02T18:33:45Z" + generated_at: "2026-05-02T19:03:15Z" model: gpt-5.5 provider: openai - source_hash: 595552574751bde36eee4b3617afa1c1f10471d6191ae35b5f4b11518cb4b5d4 + source_hash: 378ce95601d5b97a30bc046b8f987d17d0a40c1e48ecb3f66e02a1810b20e027 source_path: tools/plugin.md workflow: 16 --- -Плагіни розширюють OpenClaw новими можливостями: каналами, постачальниками моделей, -обв’язками агентів, інструментами, Skills, мовленням, транскрипцією в реальному часі, голосом у реальному часі, розумінням -медіа, генерацією зображень, генерацією відео, вебзавантаженням, вебпошуком -та іншим. Деякі плагіни є **основними** (постачаються з OpenClaw), інші -є **зовнішніми**. Більшість зовнішніх плагінів публікуються та знаходяться через +Розширення Plugin додають OpenClaw нові можливості: канали, постачальників моделей, +обгортки агентів, інструменти, Skills, мовлення, транскрипцію в реальному часі, +голос у реальному часі, розуміння медіа, генерацію зображень, генерацію відео, отримання веб-вмісту, веб-пошук +та інше. Деякі розширення Plugin є **основними** (постачаються з OpenClaw), інші +є **зовнішніми**. Більшість зовнішніх розширень Plugin публікуються й знаходяться через [ClawHub](/uk/tools/clawhub). Npm і надалі підтримується для прямих встановлень і для -тимчасового набору пакетів плагінів, що належать OpenClaw, доки ця міграція завершується. +тимчасового набору пакетів Plugin, що належать OpenClaw, доки ця міграція завершується. ## Швидкий старт - + ```bash openclaw plugins list ``` - + ```bash # Search ClawHub plugins openclaw plugins search "calendar" @@ -53,7 +53,7 @@ x-i18n: - + ```bash openclaw gateway restart ``` @@ -62,17 +62,17 @@ x-i18n: - + У запущеному Gateway команди лише для власника `/plugins enable` і `/plugins disable` - запускають перезавантажувач конфігурації Gateway. Gateway перезавантажує runtime-поверхні - плагінів у процесі, а нові ходи агента перебудовують свій список інструментів з - оновленого реєстру. `/plugins install` змінює вихідний код плагіна, тому - Gateway запитує перезапуск, замість удавати, що поточний процес може + запускають перезавантажувач конфігурації Gateway. Gateway перезавантажує поверхні + часу виконання Plugin у процесі, а нові ходи агента перебудовують свій список інструментів із + оновленого реєстру. `/plugins install` змінює вихідний код Plugin, тому + Gateway запитує перезапуск, а не вдає, що поточний процес може безпечно перезавантажити вже імпортовані модулі. - + ```bash openclaw plugins inspect --runtime --json @@ -80,9 +80,9 @@ x-i18n: openclaw --help ``` - Використовуйте `--runtime`, коли потрібно довести зареєстровані інструменти, служби, методи Gateway, - хуки або CLI-команди, що належать плагіну. Звичайний `inspect` є холодною - перевіркою маніфесту/реєстру й навмисно уникає імпорту runtime плагіна. + Використовуйте `--runtime`, коли потрібно підтвердити зареєстровані інструменти, сервіси, методи Gateway, + хуки або CLI-команди, що належать Plugin. Звичайний `inspect` є холодною + перевіркою маніфесту/реєстру й навмисно уникає імпорту часу виконання Plugin. @@ -96,72 +96,75 @@ x-i18n: ``` Шлях встановлення використовує той самий резолвер, що й CLI: локальний шлях/архів, явний -`clawhub:`, явний `npm:`, явний `git:` або просту специфікацію пакета -(спочатку ClawHub, потім резервний npm). +`clawhub:`, явний `npm:`, явний `git:` або специфікація пакета без префікса +(спершу ClawHub, потім резервний npm). -Якщо конфігурація недійсна, встановлення зазвичай аварійно зупиняється й спрямовує вас до +Якщо конфігурація недійсна, встановлення зазвичай завершується відмовою безпечним способом і спрямовує вас до `openclaw doctor --fix`. Єдиний виняток для відновлення — вузький шлях перевстановлення -вбудованого плагіна для плагінів, які явно вмикають +вбудованого Plugin для розширень Plugin, які погоджуються на `openclaw.install.allowInvalidConfigRecovery`. -Під час запуску Gateway недійсна конфігурація одного плагіна ізолюється до цього плагіна: -запуск записує проблему `plugins.entries..config` у журнали, пропускає цей плагін під час -завантаження та залишає інші плагіни й канали онлайн. Запустіть `openclaw doctor --fix`, -щоб помістити некоректну конфігурацію плагіна в карантин, вимкнувши цей запис плагіна й видаливши -його недійсне корисне навантаження конфігурації; звичайна резервна копія конфігурації зберігає попередні значення. -Коли конфігурація каналу посилається на плагін, який більше не виявляється, але той самий -застарілий id плагіна лишається в конфігурації плагінів або записах встановлення, запуск Gateway -записує попередження та пропускає цей канал замість блокування всіх інших каналів. -Запустіть `openclaw doctor --fix`, щоб видалити застарілі записи каналу/плагіна; невідомі -ключі каналів без доказів застарілого плагіна все ще не проходять валідацію, тож помилки введення залишаються +Під час запуску Gateway недійсна конфігурація одного Plugin ізолюється до цього Plugin: +запуск журналює проблему `plugins.entries..config`, пропускає цей Plugin під час +завантаження й залишає інші розширення Plugin і канали онлайн. Запустіть `openclaw doctor --fix`, +щоб ізолювати погану конфігурацію Plugin, вимкнувши цей запис Plugin і видаливши +його недійсне конфігураційне навантаження; звичайна резервна копія конфігурації зберігає попередні значення. +Коли конфігурація каналу посилається на Plugin, який більше не можна виявити, але той самий +застарілий ідентифікатор Plugin залишається в конфігурації Plugin або записах встановлення, запуск Gateway +журналює попередження й пропускає цей канал замість блокування всіх інших каналів. +Запустіть `openclaw doctor --fix`, щоб видалити застарілі записи каналу/Plugin; невідомі +ключі каналів без доказів застарілого Plugin і надалі не проходять валідацію, щоб помилки введення залишалися видимими. -Якщо встановлено `plugins.enabled: false`, застарілі посилання на плагіни вважаються інертними: -запуск Gateway пропускає виявлення/завантаження плагінів, а `openclaw doctor` зберігає -вимкнену конфігурацію плагінів замість її автоматичного видалення. Знову ввімкніть плагіни перед -запуском очищення doctor, якщо хочете видалити застарілі id плагінів. +Якщо встановлено `plugins.enabled: false`, застарілі посилання на Plugin вважаються інертними: +запуск Gateway пропускає виявлення/завантаження Plugin, а `openclaw doctor` зберігає +вимкнену конфігурацію Plugin замість автоматичного видалення. Знову ввімкніть розширення Plugin перед +запуском очищення doctor, якщо хочете видалити застарілі ідентифікатори Plugin. -Встановлення залежностей плагіна відбувається лише під час явних потоків встановлення/оновлення або -ремонту doctor. Запуск Gateway, перезавантаження конфігурації та runtime-інспекція не -запускають менеджери пакетів і не ремонтують дерева залежностей. Локальні плагіни вже мають -мати встановлені залежності, тоді як npm-, git- і ClawHub-плагіни -встановлюються під керованими коренями плагінів OpenClaw. Залежності npm можуть бути підняті -всередині керованого npm-кореня OpenClaw; встановлення/оновлення сканує цей керований корінь перед -довірою, а видалення прибирає npm-керовані пакети через npm. Зовнішні плагіни -та користувацькі шляхи завантаження все ще мають встановлюватися через `openclaw plugins install`. -Див. [Розв’язання залежностей плагінів](/uk/plugins/dependency-resolution) для життєвого циклу під час встановлення. +Встановлення залежностей Plugin відбувається лише під час явного встановлення/оновлення або +потоків відновлення doctor. Запуск Gateway, перезавантаження конфігурації та інспекція часу виконання +не запускають менеджери пакетів і не відновлюють дерева залежностей. Локальні розширення Plugin мають уже +мати встановлені залежності, тоді як npm, git і ClawHub Plugin встановлюються +в керовані корені Plugin OpenClaw. Залежності npm можуть підніматися +в межах керованого npm-кореня OpenClaw; встановлення/оновлення сканує цей керований корінь перед +довірою, а видалення прибирає керовані npm пакети через npm. Зовнішні розширення Plugin +і власні шляхи завантаження все одно потрібно встановлювати через `openclaw plugins install`. +Використовуйте `openclaw plugins list --json`, щоб побачити статичний `dependencyStatus` для кожного +видимого Plugin без імпорту коду часу виконання чи відновлення залежностей. +Див. [вирішення залежностей Plugin](/uk/plugins/dependency-resolution) для життєвого циклу +під час встановлення. -Вихідні checkout-и є pnpm workspaces. Якщо ви клонуєте OpenClaw, щоб працювати над вбудованими -плагінами, запустіть `pnpm install`; після цього OpenClaw завантажує вбудовані плагіни з -`extensions/`, тож зміни та локальні для пакета залежності використовуються напряму. +Вихідні checkout-и є pnpm-workspace. Якщо ви клонуєте OpenClaw, щоб працювати над вбудованими +розширеннями Plugin, запустіть `pnpm install`; тоді OpenClaw завантажує вбудовані розширення Plugin з +`extensions/`, тож зміни та локальні залежності пакетів використовуються напряму. Звичайні кореневі встановлення npm призначені для пакетованого OpenClaw, а не для розробки -з checkout вихідного коду. +з вихідного checkout-а. -## Типи плагінів +## Типи Plugin -OpenClaw розпізнає два формати плагінів: +OpenClaw розпізнає два формати Plugin: -| Формат | Як це працює | Приклади | -| ---------- | ------------------------------------------------------------------ | ------------------------------------------------------ | -| **Нативний** | `openclaw.plugin.json` + runtime-модуль; виконується в процесі | Офіційні плагіни, спільнотні npm-пакети | -| **Bundle** | Сумісний із Codex/Claude/Cursor layout; зіставляється з можливостями OpenClaw | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` | +| Формат | Як це працює | Приклади | +| ----------- | --------------------------------------------------------------- | ------------------------------------------------------- | +| **Нативний** | `openclaw.plugin.json` + модуль часу виконання; виконується в процесі | Офіційні розширення Plugin, npm-пакети спільноти | +| **Bundle** | макет, сумісний із Codex/Claude/Cursor; зіставляється з можливостями OpenClaw | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` | -Обидва відображаються в `openclaw plugins list`. Див. [Plugin Bundles](/uk/plugins/bundles) для деталей bundle. +Обидва відображаються в `openclaw plugins list`. Див. [пакети Plugin](/uk/plugins/bundles), щоб дізнатися подробиці про bundle. -Якщо ви пишете нативний плагін, почніть з [Створення плагінів](/uk/plugins/building-plugins) -і [Огляд Plugin SDK](/uk/plugins/sdk-overview). +Якщо ви пишете нативний Plugin, почніть зі [створення розширень Plugin](/uk/plugins/building-plugins) +та [огляду Plugin SDK](/uk/plugins/sdk-overview). ## Точки входу пакетів -Npm-пакети нативних плагінів мають оголошувати `openclaw.extensions` у `package.json`. -Кожен запис має залишатися всередині директорії пакета й розв’язуватися в читабельний -runtime-файл або TypeScript-файл вихідного коду з виведеним збудованим JavaScript -відповідником, наприклад `src/index.ts` до `dist/index.js`. +Нативні npm-пакети Plugin мають оголошувати `openclaw.extensions` у `package.json`. +Кожен запис має залишатися всередині каталогу пакета й розв’язуватися до читабельного +файлу часу виконання або до вихідного файлу TypeScript із виведеним зібраним JavaScript- +відповідником, наприклад від `src/index.ts` до `dist/index.js`. -Використовуйте `openclaw.runtimeExtensions`, коли опубліковані runtime-файли не розташовані за -тими самими шляхами, що й записи вихідного коду. Якщо `runtimeExtensions` присутній, він має містити -рівно один запис для кожного запису `extensions`. Невідповідні списки призводять до помилки встановлення та -виявлення плагіна, а не мовчазного fallback до шляхів вихідного коду. Якщо ви також -публікуєте `openclaw.setupEntry`, використовуйте `openclaw.runtimeSetupEntry` для його збудованого -JavaScript-відповідника; цей файл є обов’язковим, якщо оголошений. +Використовуйте `openclaw.runtimeExtensions`, коли опубліковані файли часу виконання не розміщені за +тими самими шляхами, що й вихідні записи. Якщо `runtimeExtensions` присутній, він має містити +рівно один запис для кожного запису `extensions`. Невідповідні списки провалюють встановлення та +виявлення Plugin, а не мовчки повертаються до вихідних шляхів. Якщо ви також +публікуєте `openclaw.setupEntry`, використовуйте `openclaw.runtimeSetupEntry` для його зібраного +JavaScript-відповідника; цей файл є обов’язковим, коли його оголошено. ```json { @@ -173,21 +176,21 @@ JavaScript-відповідника; цей файл є обов’язкови } ``` -## Офіційні плагіни +## Офіційні розширення Plugin ### Npm-пакети, що належать OpenClaw, під час міграції -ClawHub є основним шляхом поширення для більшості плагінів. Поточні пакетовані -релізи OpenClaw уже включають багато офіційних плагінів, тому для них не потрібні -окремі npm-встановлення у звичайних налаштуваннях. Поки кожен плагін, що належить OpenClaw, -не мігрував до ClawHub, OpenClaw все ще постачає деякі пакети плагінів `@openclaw/*` -в npm для старіших/користувацьких встановлень і прямих npm-процесів. +ClawHub є основним шляхом розповсюдження для більшості розширень Plugin. Поточні пакетовані +релізи OpenClaw уже включають багато офіційних розширень Plugin, тому їм не потрібні +окремі встановлення npm у звичайних налаштуваннях. Доки кожен Plugin, що належить OpenClaw, +не мігрував до ClawHub, OpenClaw і надалі постачає деякі пакети Plugin `@openclaw/*` +на npm для старіших/власних встановлень і прямих npm-процесів. -Якщо npm повідомляє, що пакет плагіна `@openclaw/*` застарів, ця версія пакета -походить зі старішої лінійки зовнішніх пакетів. Використовуйте вбудований плагін з -поточного OpenClaw або локальний checkout, доки не буде опубліковано новіший npm-пакет. +Якщо npm повідомляє, що пакет Plugin `@openclaw/*` застарілий, ця версія пакета +належить до старішої зовнішньої лінійки пакетів. Використовуйте вбудований Plugin із +поточного OpenClaw або локального checkout-а, доки не буде опубліковано новіший npm-пакет. -| Plugin | Пакет | Документація | +| Plugin | Пакет | Документація | | --------------- | -------------------------- | ------------------------------------------ | | BlueBubbles | `@openclaw/bluebubbles` | [BlueBubbles](/uk/channels/bluebubbles) | | Discord | `@openclaw/discord` | [Discord](/uk/channels/discord) | @@ -203,10 +206,10 @@ ClawHub є основним шляхом поширення для більшо | Zalo | `@openclaw/zalo` | [Zalo](/uk/channels/zalo) | | Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/uk/plugins/zalouser) | -### Core (постачається з OpenClaw) +### Основні (постачаються з OpenClaw) - + `anthropic`, `byteplus`, `cloudflare-ai-gateway`, `github-copilot`, `google`, `huggingface`, `kilocode`, `kimi-coding`, `minimax`, `mistral`, `qwen`, `moonshot`, `nvidia`, `openai`, `opencode`, `opencode-go`, `openrouter`, @@ -214,27 +217,27 @@ ClawHub є основним шляхом поширення для більшо `vercel-ai-gateway`, `volcengine`, `xiaomi`, `zai` - - - `memory-core` — вбудований пошук пам’яті (типово через `plugins.slots.memory`) + + - `memory-core` — вбудований пошук у пам’яті (за замовчуванням через `plugins.slots.memory`) - `memory-lancedb` — довгострокова пам’ять на базі LanceDB з автоматичним пригадуванням/захопленням (встановіть `plugins.slots.memory = "memory-lancedb"`) - Див. [Memory LanceDB](/uk/plugins/memory-lancedb) для налаштування embeddings, сумісних з OpenAI, - прикладів Ollama, лімітів пригадування та усунення несправностей. + Див. [Memory LanceDB](/uk/plugins/memory-lancedb), щоб дізнатися про налаштування + ембедингів, сумісних з OpenAI, приклади Ollama, ліміти пригадування та усунення несправностей. - + `elevenlabs`, `microsoft` - - - `browser` — вбудований браузерний плагін для браузерного інструмента, CLI `openclaw browser`, методу Gateway `browser.request`, runtime браузера та типової служби керування браузером (увімкнено типово; вимкніть перед заміною) - - `copilot-proxy` — міст VS Code Copilot Proxy (вимкнено типово) + + - `browser` — вбудований браузерний Plugin для браузерного інструмента, CLI `openclaw browser`, методу Gateway `browser.request`, часу виконання браузера та стандартного сервісу керування браузером (увімкнено за замовчуванням; вимкніть перед заміною) + - `copilot-proxy` — міст VS Code Copilot Proxy (вимкнено за замовчуванням) -Шукаєте сторонні плагіни? Див. [Плагіни спільноти](/uk/plugins/community). +Шукаєте сторонні розширення Plugin? Див. [розширення Plugin від спільноти](/uk/plugins/community). ## Конфігурація @@ -252,37 +255,37 @@ ClawHub є основним шляхом поширення для більшо } ``` -| Поле | Опис | +| Поле | Опис | | ---------------- | --------------------------------------------------------- | -| `enabled` | Головний перемикач (типово: `true`) | -| `allow` | Allowlist плагінів (необов’язково) | -| `deny` | Denylist плагінів (необов’язково; deny має перевагу) | -| `load.paths` | Додаткові файли/директорії плагінів | +| `enabled` | Головний перемикач (за замовчуванням: `true`) | +| `allow` | Список дозволених розширень Plugin (необов’язково) | +| `deny` | Список заборонених розширень Plugin (необов’язково; заборона має пріоритет) | +| `load.paths` | Додаткові файли/каталоги розширень Plugin | | `slots` | Ексклюзивні селектори слотів (наприклад, `memory`, `contextEngine`) | -| `entries.\` | Перемикачі та конфігурація для кожного плагіна | +| `entries.\` | Перемикачі + конфігурація для окремого Plugin | `plugins.allow` є ексклюзивним. Коли він непорожній, завантажуватися -або надавати інструменти можуть лише перелічені плагіни, навіть якщо `tools.allow` містить `"*"` або конкретну -назву інструмента, що належить плагіну. Якщо allowlist інструментів посилається на інструменти плагінів, додайте id плагінів-власників -до `plugins.allow` або видаліть `plugins.allow`; `openclaw doctor` попереджає про таку +або надавати інструменти можуть лише перелічені розширення Plugin, навіть якщо `tools.allow` містить `"*"` або конкретну +назву інструмента, що належить Plugin. Якщо список дозволених інструментів посилається на інструменти Plugin, додайте ідентифікатори розширень Plugin, +яким вони належать, до `plugins.allow` або видаліть `plugins.allow`; `openclaw doctor` попереджає про таку форму. Зміни конфігурації, внесені через `/plugins enable` або `/plugins disable`, запускають -перезавантаження Plugin у Gateway в межах процесу. Нові ходи агента перебудовують свій список інструментів із -оновленого реєстру Plugin. Операції, що змінюють джерело, як-от встановлення, -оновлення та видалення, все ще перезапускають процес Gateway, оскільки вже імпортовані +перезавантаження Plugin у процесі Gateway. Нові ходи агента перебудовують свій список інструментів із +оновленого реєстру Plugin. Операції, що змінюють джерела, як-от install, +update та uninstall, усе ще перезапускають процес Gateway, тому що вже імпортовані модулі Plugin неможливо безпечно замінити на місці. -`openclaw plugins list` — це локальний знімок реєстру Plugin/конфігурації. Plugin зі станом +`openclaw plugins list` — це локальний знімок реєстру/конфігурації Plugin. Plugin зі станом `enabled` там означає, що збережений реєстр і поточна конфігурація дозволяють Plugin брати участь. Це не доводить, що вже запущений віддалений Gateway перезавантажився або перезапустився з тим самим кодом Plugin. У налаштуваннях VPS/контейнерів із процесами-обгортками надсилайте перезапуски або записи, що запускають перезавантаження, до фактичного процесу `openclaw gateway run`, або використовуйте `openclaw gateway restart` для -запущеного Gateway, коли перезавантаження повідомляє про помилку. +запущеного Gateway, коли перезавантаження повідомляє про збій. - - **Вимкнений**: Plugin існує, але правила ввімкнення його вимкнули. Конфігурація зберігається. + - **Вимкнений**: Plugin існує, але правила ввімкнення вимкнули його. Конфігурація збережена. - **Відсутній**: конфігурація посилається на id Plugin, який виявлення не знайшло. - **Недійсний**: Plugin існує, але його конфігурація не відповідає оголошеній схемі. Запуск Gateway пропускає лише цей Plugin; `openclaw doctor --fix` може ізолювати недійсний запис, вимкнувши його та видаливши його конфігураційне навантаження. @@ -295,8 +298,8 @@ OpenClaw сканує Plugin у такому порядку (перший збі `plugins.load.paths` — явні шляхи до файлів або каталогів. Шляхи, що вказують - назад на власні запаковані каталоги вбудованих Plugin OpenClaw, ігноруються; - виконайте `openclaw doctor --fix`, щоб видалити ці застарілі псевдоніми. + назад на власні упаковані каталоги вбудованих Plugin OpenClaw, ігноруються; + запустіть `openclaw doctor --fix`, щоб видалити ці застарілі псевдоніми. @@ -313,59 +316,59 @@ OpenClaw сканує Plugin у такому порядку (перший збі -Запаковані встановлення та Docker-образи зазвичай знаходять вбудовані Plugin у -скомпільованому дереві `dist/extensions`. Якщо каталог джерела вбудованого Plugin -змонтовано поверх відповідного запакованого шляху джерела, наприклад -`/app/extensions/synology-chat`, OpenClaw розглядає цей змонтований каталог джерела -як накладення джерела вбудованого Plugin і виявляє його перед запакованим +Упаковані встановлення та Docker-образи зазвичай знаходять вбудовані Plugin у +скомпільованому дереві `dist/extensions`. Якщо каталог джерел вбудованого Plugin +змонтовано поверх відповідного упакованого шляху джерел, наприклад +`/app/extensions/synology-chat`, OpenClaw розглядає цей змонтований каталог джерел +як накладення джерел вбудованого Plugin і виявляє його перед упакованим пакетом `/app/dist/extensions/synology-chat`. Це зберігає працездатність контейнерних -циклів супровідників без перемикання кожного вбудованого Plugin назад на джерело TypeScript. -Установіть `OPENCLAW_DISABLE_BUNDLED_SOURCE_OVERLAYS=1`, щоб примусово використовувати запаковані dist-пакети, -навіть коли наявні змонтовані накладення джерела. +циклів супровідників без перемикання кожного вбудованого Plugin назад на джерела TypeScript. +Установіть `OPENCLAW_DISABLE_BUNDLED_SOURCE_OVERLAYS=1`, щоб примусово використовувати упаковані dist-пакети +навіть за наявності змонтованих накладень джерел. ### Правила ввімкнення - `plugins.enabled: false` вимикає всі Plugin і пропускає роботу з виявлення/завантаження Plugin -- `plugins.deny` завжди має пріоритет над allow +- `plugins.deny` завжди має перевагу над allow - `plugins.entries.\.enabled: false` вимикає цей Plugin -- Plugin з робочої області **вимкнені за замовчуванням** (їх потрібно явно ввімкнути) -- Вбудовані Plugin дотримуються вбудованого набору, увімкненого за замовчуванням, якщо не перевизначено +- Plugin із робочої області **вимкнені за замовчуванням** (їх потрібно явно ввімкнути) +- Вбудовані Plugin дотримуються вбудованого набору ввімкнення за замовчуванням, якщо це не перевизначено - Ексклюзивні слоти можуть примусово ввімкнути вибраний Plugin для цього слота - Деякі вбудовані opt-in Plugin вмикаються автоматично, коли конфігурація називає поверхню, що належить Plugin, як-от посилання на модель провайдера, конфігурацію каналу або runtime - стенда -- Застаріла конфігурація Plugin зберігається, поки активний `plugins.enabled: false`; + harness +- Застаріла конфігурація Plugin зберігається, доки активний `plugins.enabled: false`; повторно ввімкніть Plugin перед запуском очищення doctor, якщо хочете видалити застарілі id - Маршрути Codex сімейства OpenAI зберігають окремі межі Plugin: - `openai-codex/*` належить Plugin OpenAI, тоді як вбудований Plugin app-server Codex - вибирається через `agentRuntime.id: "codex"` або застарілі посилання на моделі - `codex/*` + `openai-codex/*` належить до OpenAI Plugin, тоді як вбудований Plugin сервера застосунку Codex + вибирається через `agentRuntime.id: "codex"` або застарілі + посилання на моделі `codex/*` ## Усунення несправностей runtime-хуків -Якщо Plugin з'являється в `plugins list`, але побічні ефекти або хуки -`register(api)` не виконуються в живому чат-трафіку, спершу перевірте таке: +Якщо Plugin з’являється в `plugins list`, але побічні ефекти або хуки `register(api)` +не виконуються в живому чат-трафіку, спершу перевірте це: -- Виконайте `openclaw gateway status --deep --require-rpc` і підтвердьте, що активні +- Запустіть `openclaw gateway status --deep --require-rpc` і підтвердьте, що активні URL Gateway, профіль, шлях конфігурації та процес є саме тими, які ви редагуєте. -- Перезапустіть живий Gateway після змін у встановленні/конфігурації/коді Plugin. У контейнерах-обгортках - PID 1 може бути лише супервізором; перезапустіть або надішліть сигнал дочірньому - процесу `openclaw gateway run`. +- Перезапустіть живий Gateway після змін установлення/конфігурації/коду Plugin. У контейнерах-обгортках + PID 1 може бути лише супервізором; перезапустіть або просигналізуйте дочірній + процес `openclaw gateway run`. - Використовуйте `openclaw plugins inspect --runtime --json`, щоб підтвердити реєстрації хуків і діагностику. Невбудовані хуки розмови, як-от `llm_input`, `llm_output`, `before_agent_finalize` і `agent_end`, потребують `plugins.entries..hooks.allowConversationAccess=true`. -- Для перемикання моделей надавайте перевагу `before_model_resolve`. Він виконується перед - розв'язанням моделі для ходів агента; `llm_output` виконується лише після того, як спроба моделі - створить відповідь асистента. -- Для підтвердження ефективної моделі сесії використовуйте `openclaw sessions` або - поверхні сесії/стану Gateway, а під час налагодження payload-ів провайдера запускайте - Gateway з `--raw-stream --raw-stream-path `. +- Для перемикання моделей надавайте перевагу `before_model_resolve`. Він виконується до розв’язання + моделі для ходів агента; `llm_output` виконується лише після того, як спроба моделі + створить вивід асистента. +- Для підтвердження ефективної моделі сеансу використовуйте `openclaw sessions` або + поверхні сеансу/статусу Gateway, а під час налагодження навантажень провайдера запускайте + Gateway із `--raw-stream --raw-stream-path `. ### Повільне налаштування інструментів Plugin -Якщо здається, що ходи агента зависають під час підготовки інструментів, увімкніть журналювання трасування та -перевірте рядки часу фабрик інструментів Plugin: +Якщо ходи агента, здається, зависають під час підготовки інструментів, увімкніть трасувальне журналювання та +перевірте рядки часу виконання фабрик інструментів Plugin: ```bash openclaw config set logging.level trace @@ -378,28 +381,28 @@ openclaw logs --follow [trace:plugin-tools] factory timings ... ``` -Зведення перелічує загальний час фабрик і найповільніші фабрики інструментів Plugin, -зокрема id Plugin, оголошені назви інструментів, форму результату та чи є інструмент -необов'язковим. Повільні рядки підвищуються до попереджень, коли одна фабрика займає -щонайменше 1 с або загальна підготовка фабрик інструментів Plugin займає щонайменше 5 с. +Підсумок перелічує загальний час фабрик і найповільніші фабрики інструментів Plugin, +включно з id Plugin, оголошеними назвами інструментів, формою результату та тим, чи є інструмент +необов’язковим. Повільні рядки підвищуються до попереджень, коли одна фабрика триває +щонайменше 1 с або загальна підготовка фабрик інструментів Plugin триває щонайменше 5 с. -OpenClaw кешує успішні результати фабрик інструментів Plugin для повторних розв'язань +OpenClaw кешує успішні результати фабрик інструментів Plugin для повторних розв’язань з тим самим ефективним контекстом запиту. Ключ кешу містить ефективну -runtime-конфігурацію, робочу область, id агента/сесії, політику sandbox, налаштування браузера, -контекст доставки, ідентичність запитувача та стан власності, тому фабрики, які -залежать від цих довірених полів, повторно виконуються, коли контекст змінюється. +runtime-конфігурацію, робочу область, id агента/сеансу, політику sandbox, налаштування браузера, +контекст доставки, ідентичність запитувача та стан володіння, тому фабрики, що +залежать від цих довірених полів, повторно запускаються, коли контекст змінюється. -Якщо один Plugin домінує за часом, перевірте його runtime-реєстрації: +Якщо один Plugin домінує в часі, перевірте його runtime-реєстрації: ```bash openclaw plugins inspect --runtime --json ``` -Потім оновіть, перевстановіть або вимкніть цей Plugin. Автори Plugin повинні переносити -дороге завантаження залежностей за шлях виконання інструмента, а не виконувати його -всередині фабрики інструментів. +Потім оновіть, перевстановіть або вимкніть цей Plugin. Автори Plugin мають переносити +дороге завантаження залежностей за шлях виконання інструмента, а не робити це +всередині фабрики інструмента. -### Дублювання власності каналу або інструмента +### Дублювання володіння каналом або інструментом Симптоми: @@ -413,20 +416,20 @@ openclaw plugins inspect --runtime --json Кроки налагодження: -- Виконайте `openclaw plugins list --enabled --verbose`, щоб побачити кожен увімкнений Plugin - і походження. -- Виконайте `openclaw plugins inspect --runtime --json` для кожного підозрюваного Plugin і +- Запустіть `openclaw plugins list --enabled --verbose`, щоб побачити кожен увімкнений Plugin + і його походження. +- Запустіть `openclaw plugins inspect --runtime --json` для кожного підозрюваного Plugin і порівняйте `channels`, `channelConfigs`, `tools` і діагностику. -- Виконайте `openclaw plugins registry --refresh` після встановлення або видалення +- Запустіть `openclaw plugins registry --refresh` після встановлення або видалення пакетів Plugin, щоб збережені метадані відображали поточне встановлення. -- Перезапустіть Gateway після змін встановлення, реєстру або конфігурації. +- Перезапустіть Gateway після змін установлення, реєстру або конфігурації. Варіанти виправлення: - Якщо один Plugin навмисно замінює інший для того самого id каналу, бажаний - Plugin повинен оголосити `channelConfigs..preferOver` з + Plugin має оголосити `channelConfigs..preferOver` з id Plugin нижчого пріоритету. Див. [/plugins/manifest#replacing-another-channel-plugin](/uk/plugins/manifest#replacing-another-channel-plugin). -- Якщо дублювання випадкове, вимкніть один бік через +- Якщо дублювання випадкове, вимкніть одну сторону через `plugins.entries..enabled: false` або видаліть застаріле встановлення Plugin. - Якщо ви явно ввімкнули обидва Plugin, OpenClaw зберігає цей запит і @@ -435,7 +438,7 @@ openclaw plugins inspect --runtime --json ## Слоти Plugin (ексклюзивні категорії) -Деякі категорії є ексклюзивними (активною може бути лише одна за раз): +Деякі категорії є ексклюзивними (активна лише одна за раз): ```json5 { @@ -448,9 +451,9 @@ openclaw plugins inspect --runtime --json } ``` -| Слот | Що він контролює | За замовчуванням | +| Слот | Що він контролює | Типове значення | | --------------- | --------------------- | ------------------- | -| `memory` | Plugin активної пам'яті | `memory-core` | +| `memory` | Active Memory Plugin | `memory-core` | | `contextEngine` | Активний рушій контексту | `legacy` (вбудований) | ## Довідник CLI @@ -503,77 +506,77 @@ openclaw plugins disable Вбудовані Plugin постачаються з OpenClaw. Багато з них увімкнені за замовчуванням (наприклад вбудовані провайдери моделей, вбудовані провайдери мовлення та вбудований браузерний -Plugin). Інші вбудовані Plugin все ще потребують `openclaw plugins enable `. +Plugin). Інші вбудовані Plugin усе ще потребують `openclaw plugins enable `. -`--force` перезаписує наявний встановлений Plugin або пакет хуків на місці. Використовуйте +`--force` перезаписує на місці вже встановлений Plugin або набір хуків. Використовуйте `openclaw plugins update ` для звичайних оновлень відстежуваних npm -Plugin. Він не підтримується з `--link`, який повторно використовує шлях джерела замість -копіювання в керовану ціль встановлення. +Plugin. Це не підтримується з `--link`, який повторно використовує шлях джерел замість +копіювання поверх керованої цілі встановлення. -Коли `plugins.allow` вже встановлено, `openclaw plugins install` додає -id встановленого Plugin до цього allowlist перед його ввімкненням. Якщо той самий id Plugin +Коли `plugins.allow` уже задано, `openclaw plugins install` додає +id встановленого Plugin до цього списку allow перед його ввімкненням. Якщо той самий id Plugin наявний у `plugins.deny`, install видаляє цей застарілий запис deny, щоб явне встановлення можна було завантажити одразу після перезапуску. -OpenClaw зберігає персистентний локальний реєстр Plugin як холодну модель читання для -інвентарю Plugin, власності внесків і планування запуску. Потоки встановлення, оновлення, -видалення, увімкнення та вимкнення оновлюють цей реєстр після зміни стану Plugin. -Той самий файл `plugins/installs.json` зберігає довговічні метадані встановлення у -верхньорівневому `installRecords` і відновлювані метадані маніфесту в `plugins`. Якщо +OpenClaw зберігає постійний локальний реєстр Plugin як холодну модель читання для +інвентарю plugin, власності внесків і планування запуску. Потоки встановлення, оновлення, +видалення, увімкнення та вимкнення оновлюють цей реєстр після зміни стану plugin. +Той самий файл `plugins/installs.json` зберігає довговічні метадані встановлення в +верхньорівневому `installRecords` і відновлювані метадані маніфестів у `plugins`. Якщо реєстр відсутній, застарілий або недійсний, `openclaw plugins registry ---refresh` перебудовує його подання маніфестів із записів встановлення, політики конфігурації та -метаданих маніфесту/пакета без завантаження runtime-модулів Plugin. +--refresh` перебудовує його представлення маніфестів із записів встановлення, політики +конфігурації та метаданих маніфесту/пакета без завантаження runtime-модулів plugin. `openclaw plugins update ` застосовується до відстежуваних встановлень. Передавання -специфікації npm-пакета з dist-tag або точною версією зіставляє ім’я пакета -назад із відстежуваним записом Plugin і записує нову специфікацію для майбутніх оновлень. -Передавання імені пакета без версії повертає встановлення, закріплене за точною версією, назад до -типової лінії релізів реєстру. Якщо встановлений npm Plugin уже відповідає -розв’язаній версії та записаній ідентичності артефакту, OpenClaw пропускає оновлення -без завантаження, перевстановлення або переписування конфігурації. +специфікації npm-пакета з dist-tag або точною версією зіставляє назву пакета +назад із відстежуваним записом plugin і записує нову специфікацію для майбутніх оновлень. +Передавання назви пакета без версії повертає точно закріплене встановлення назад до +типової лінії випусків реєстру. Якщо встановлений npm plugin уже відповідає +визначеній версії та записаній ідентичності артефакту, OpenClaw пропускає оновлення +без завантаження, повторного встановлення або переписування конфігурації. -`--pin` працює лише з npm. Він не підтримується з `--marketplace`, бо +`--pin` працює лише з npm. Він не підтримується з `--marketplace`, тому що marketplace-встановлення зберігають метадані джерела marketplace замість npm-специфікації. -`--dangerously-force-unsafe-install` — це аварійне перевизначення для хибних -спрацьовувань вбудованого сканера небезпечного коду. Воно дозволяє встановлення Plugin -і оновлення Plugin продовжуватися попри вбудовані знахідки рівня `critical`, але все одно -не обходить блокування політик Plugin `before_install` або блокування через помилки сканування. -Сканування встановлення ігнорує поширені тестові файли та каталоги, як-от `tests/`, +`--dangerously-force-unsafe-install` — аварійне перевизначення для хибних +спрацювань вбудованого сканера небезпечного коду. Воно дозволяє встановлення plugin +та оновлення plugin продовжувати попри вбудовані знахідки `critical`, але все одно +не обходить блокування політики plugin `before_install` або блокування через збій сканування. +Сканування встановлення ігнорують поширені тестові файли й каталоги, як-от `tests/`, `__tests__/`, `*.test.*` і `*.spec.*`, щоб не блокувати запаковані тестові моки; -оголошені runtime-точки входу Plugin усе одно скануються, навіть якщо вони використовують одну з +оголошені runtime-точки входу plugin все одно скануються, навіть якщо вони використовують одну з цих назв. -Цей прапорець CLI застосовується лише до потоків встановлення/оновлення Plugin. Встановлення -залежностей Skills через Gateway натомість використовують відповідне перевизначення запиту -`dangerouslyForceUnsafeInstall`, тоді як `openclaw skills install` залишається окремим потоком -завантаження/встановлення Skills із ClawHub. +Цей прапорець CLI застосовується лише до потоків встановлення/оновлення plugin. Встановлення +залежностей skill через Gateway використовують відповідне перевизначення запиту +`dangerouslyForceUnsafeInstall`, тоді як `openclaw skills install` лишається окремим +потоком завантаження/встановлення skill із ClawHub. -Якщо Plugin, який ви опублікували в ClawHub, приховано або заблоковано скануванням, відкрийте -панель керування ClawHub або виконайте `clawhub package rescan `, щоб попросити ClawHub перевірити -його знову. `--dangerously-force-unsafe-install` впливає лише на встановлення на вашій власній -машині; він не просить ClawHub повторно просканувати Plugin і не робить заблокований реліз +Якщо plugin, який ви опублікували на ClawHub, приховано або заблоковано скануванням, відкрийте +панель ClawHub або запустіть `clawhub package rescan `, щоб попросити ClawHub перевірити +його ще раз. `--dangerously-force-unsafe-install` впливає лише на встановлення на вашій власній +машині; він не просить ClawHub повторно просканувати plugin або зробити заблокований випуск публічним. -Сумісні пакети беруть участь у тому самому потоці списку/інспекції/увімкнення/вимкнення Plugin. -Поточна runtime-підтримка охоплює bundle skills, Claude command-skills, -типові значення Claude `settings.json`, типові значення Claude `.lsp.json` і оголошених у маніфесті -`lspServers`, Cursor command-skills і сумісні каталоги Codex hook. +Сумісні bundles беруть участь у тому самому потоці списку/інспекції/увімкнення/вимкнення +plugin. Поточна runtime-підтримка включає bundle skills, command-skills Claude, +типові значення Claude `settings.json`, типові значення Claude `.lsp.json` і оголошені в маніфесті +`lspServers`, command-skills Cursor і сумісні каталоги hook Codex. -`openclaw plugins inspect ` також повідомляє виявлені можливості пакета, а також -підтримувані або непідтримувані записи MCP- і LSP-серверів для Plugin на основі пакетів. +`openclaw plugins inspect ` також повідомляє виявлені можливості bundle, а також +підтримувані або непідтримувані записи MCP- і LSP-серверів для plugin на основі bundle. -Джерелами marketplace можуть бути відоме marketplace-ім’я Claude з -`~/.claude/plugins/known_marketplaces.json`, локальний корінь marketplace або шлях до -`marketplace.json`, GitHub-скорочення на кшталт `owner/repo`, URL репозиторію GitHub -або git URL. Для віддалених marketplace записи Plugin мають залишатися всередині -клонованого репозиторію marketplace і використовувати лише джерела з відносними шляхами. +Джерелами marketplace можуть бути відома назва marketplace Claude з +`~/.claude/plugins/known_marketplaces.json`, локальний корінь marketplace або +шлях `marketplace.json`, скорочення GitHub на кшталт `owner/repo`, URL репозиторію GitHub +або git URL. Для віддалених marketplaces записи plugin мають залишатися всередині +клонованого репозиторію marketplace і використовувати лише відносні джерела шляхів. -Дивіться [довідник CLI `openclaw plugins`](/uk/cli/plugins) для повних подробиць. +Див. [довідник CLI `openclaw plugins`](/uk/cli/plugins) для повних подробиць. ## Огляд API Plugin -Нативні Plugin експортують об’єкт входу, який надає `register(api)`. Старіші -Plugin можуть усе ще використовувати `activate(api)` як застарілий псевдонім, але нові Plugin мають +Нативні plugins експортують об’єкт входу, який надає `register(api)`. Старіші +plugins усе ще можуть використовувати `activate(api)` як legacy-псевдонім, але нові plugins мають використовувати `register`. ```typescript @@ -594,75 +597,75 @@ export default definePluginEntry({ }); ``` -OpenClaw завантажує об’єкт входу й викликає `register(api)` під час активації Plugin. -Завантажувач усе ще повертається до `activate(api)` для старіших Plugin, -але вбудовані Plugin і нові зовнішні Plugin мають вважати `register` публічним -контрактом. +OpenClaw завантажує об’єкт входу й викликає `register(api)` під час активації plugin. +Loader усе ще повертається до `activate(api)` для старіших plugins, +але bundled plugins і нові зовнішні plugins мають розглядати `register` як +публічний контракт. -`api.registrationMode` повідомляє Plugin, чому його точку входу завантажують: +`api.registrationMode` повідомляє plugin, навіщо завантажується його entry: -| Режим | Значення | +| Режим | Значення | | --------------- | -------------------------------------------------------------------------------------------------------------------------------- | -| `full` | Runtime-активація. Реєструйте інструменти, hooks, сервіси, команди, маршрути та інші live-побічні ефекти. | -| `discovery` | Виявлення можливостей лише для читання. Реєструйте провайдерів і метадані; довірений код входу Plugin може завантажуватися, але пропускайте live-побічні ефекти. | -| `setup-only` | Завантаження метаданих налаштування каналу через легковагову точку входу налаштування. | -| `setup-runtime` | Завантаження налаштування каналу, якому також потрібна runtime-точка входу. | +| `full` | Runtime-активація. Реєструйте tools, hooks, services, commands, routes та інші живі побічні ефекти. | +| `discovery` | Read-only виявлення можливостей. Реєструйте providers і metadata; довірений код entry plugin може завантажуватися, але пропускайте живі побічні ефекти. | +| `setup-only` | Завантаження метаданих налаштування каналу через легковаговий setup entry. | +| `setup-runtime` | Завантаження налаштування каналу, якому також потрібен runtime entry. | | `cli-metadata` | Лише збирання метаданих команд CLI. | -Точки входу Plugin, які відкривають сокети, бази даних, фонові worker-и або довгоживучі -клієнти, мають захищати ці побічні ефекти перевіркою `api.registrationMode === "full"`. -Завантаження discovery кешуються окремо від активаційних завантажень і не замінюють -поточний реєстр Gateway. Discovery не активує, але й не є вільним від імпортів: -OpenClaw може виконати довірену точку входу Plugin або модуль канального Plugin, щоб побудувати -знімок. Тримайте верхні рівні модулів легковаговими й без побічних ефектів, а -мережеві клієнти, підпроцеси, listeners, читання облікових даних і запуск сервісів -переносьте за повні runtime-шляхи. +Entry plugin, які відкривають sockets, databases, background workers або довгоживучі +clients, мають захищати ці побічні ефекти перевіркою `api.registrationMode === "full"`. +Завантаження discovery кешуються окремо від activating loads і не замінюють +поточний registry Gateway. Discovery не активує, але й не є import-free: +OpenClaw може виконати довірений entry plugin або module channel plugin, щоб побудувати +snapshot. Тримайте верхні рівні модулів легковаговими й без побічних ефектів, а +network clients, subprocesses, listeners, credential reads і service startup +переносьте за full-runtime paths. Поширені методи реєстрації: -| Метод | Що він реєструє | -| --------------------------------------- | --------------------------- | -| `registerProvider` | Провайдер моделі (LLM) | -| `registerChannel` | Чат-канал | -| `registerTool` | Інструмент агента | -| `registerHook` / `on(...)` | Lifecycle hooks | -| `registerSpeechProvider` | Text-to-speech / STT | -| `registerRealtimeTranscriptionProvider` | Streaming STT | -| `registerRealtimeVoiceProvider` | Дуплексний голос у реальному часі | -| `registerMediaUnderstandingProvider` | Аналіз зображень/аудіо | -| `registerImageGenerationProvider` | Генерація зображень | -| `registerMusicGenerationProvider` | Генерація музики | -| `registerVideoGenerationProvider` | Генерація відео | -| `registerWebFetchProvider` | Провайдер web fetch / scrape | -| `registerWebSearchProvider` | Вебпошук | -| `registerHttpRoute` | HTTP endpoint | -| `registerCommand` / `registerCli` | Команди CLI | -| `registerContextEngine` | Рушій контексту | -| `registerService` | Фоновий сервіс | +| Метод | Що він реєструє | +| --------------------------------------- | ---------------------------- | +| `registerProvider` | Model provider (LLM) | +| `registerChannel` | Chat channel | +| `registerTool` | Agent tool | +| `registerHook` / `on(...)` | Lifecycle hooks | +| `registerSpeechProvider` | Text-to-speech / STT | +| `registerRealtimeTranscriptionProvider` | Streaming STT | +| `registerRealtimeVoiceProvider` | Duplex realtime voice | +| `registerMediaUnderstandingProvider` | Аналіз зображень/аудіо | +| `registerImageGenerationProvider` | Генерація зображень | +| `registerMusicGenerationProvider` | Генерація музики | +| `registerVideoGenerationProvider` | Генерація відео | +| `registerWebFetchProvider` | Web fetch / scrape provider | +| `registerWebSearchProvider` | Web search | +| `registerHttpRoute` | HTTP endpoint | +| `registerCommand` / `registerCli` | Команди CLI | +| `registerContextEngine` | Context engine | +| `registerService` | Background service | -Поведінка захисту hooks для типізованих lifecycle hooks: +Поведінка guard для типізованих lifecycle hooks: - `before_tool_call`: `{ block: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. -- `before_tool_call`: `{ block: false }` є no-op і не скасовує попередній block. +- `before_tool_call`: `{ block: false }` є no-op і не знімає попереднє блокування. - `before_install`: `{ block: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. -- `before_install`: `{ block: false }` є no-op і не скасовує попередній block. +- `before_install`: `{ block: false }` є no-op і не знімає попереднє блокування. - `message_sending`: `{ cancel: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. - `message_sending`: `{ cancel: false }` є no-op і не скасовує попередній cancel. -Нативний Codex app-server передає Codex-native події інструментів назад у цю -поверхню hooks. Plugin можуть блокувати нативні інструменти Codex через `before_tool_call`, +Native Codex app-server прокидає bridge-події Codex-native tools назад у цю +hook-поверхню. Plugins можуть блокувати Native Codex tools через `before_tool_call`, спостерігати результати через `after_tool_call` і брати участь у схваленнях Codex -`PermissionRequest`. Bridge поки що не переписує аргументи Codex-native інструментів. -Точна межа runtime-підтримки Codex описана в +`PermissionRequest`. Bridge ще не переписує аргументи Codex-native tools. +Точна межа підтримки runtime Codex описана в [контракті підтримки Codex harness v1](/uk/plugins/codex-harness#v1-support-contract). -Повну поведінку типізованих hooks дивіться в [огляді SDK](/uk/plugins/sdk-overview#hook-decision-semantics). +Повну поведінку типізованих hook див. в [огляді SDK](/uk/plugins/sdk-overview#hook-decision-semantics). ## Пов’язане -- [Створення Plugin](/uk/plugins/building-plugins) — створіть власний Plugin -- [Пакети Plugin](/uk/plugins/bundles) — сумісність пакетів Codex/Claude/Cursor +- [Створення plugins](/uk/plugins/building-plugins) — створіть власний plugin +- [Bundles Plugin](/uk/plugins/bundles) — сумісність bundles Codex/Claude/Cursor - [Маніфест Plugin](/uk/plugins/manifest) — схема маніфесту -- [Реєстрація інструментів](/uk/plugins/building-plugins#registering-agent-tools) — додайте інструменти агента в Plugin -- [Внутрішня архітектура Plugin](/uk/plugins/architecture) — модель можливостей і конвеєр завантаження -- [Спільнотні Plugin](/uk/plugins/community) — сторонні списки +- [Реєстрація tools](/uk/plugins/building-plugins#registering-agent-tools) — додайте agent tools у plugin +- [Внутрішня архітектура Plugin](/uk/plugins/architecture) — модель можливостей і pipeline завантаження +- [Спільнотні plugins](/uk/plugins/community) — списки сторонніх розробників