From 281323a98f32089469dee1edfd551eb3a38e287b Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Fri, 24 Apr 2026 23:00:46 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/providers/github-copilot.md | 104 +++++---- docs/uk/tools/plugin.md | 338 +++++++++++++++------------- 2 files changed, 240 insertions(+), 202 deletions(-) diff --git a/docs/uk/providers/github-copilot.md b/docs/uk/providers/github-copilot.md index 0d33a2f8b..2a2b35f23 100644 --- a/docs/uk/providers/github-copilot.md +++ b/docs/uk/providers/github-copilot.md @@ -1,33 +1,38 @@ --- read_when: - - Ви хочете використовувати GitHub Copilot як постачальника моделі - - Вам потрібен процес `openclaw models auth login-github-copilot` -summary: Увійдіть у GitHub Copilot з OpenClaw за допомогою device flow + - Ви хочете використовувати GitHub Copilot як постачальника моделей + - Вам потрібен потік `openclaw models auth login-github-copilot` +summary: Увійдіть у GitHub Copilot з OpenClaw за допомогою потоку пристрою title: GitHub Copilot x-i18n: - generated_at: "2026-04-24T22:51:39Z" + generated_at: "2026-04-24T22:59:26Z" model: gpt-5.4 provider: openai - source_hash: d21ef936578741fe458f50ca25034a71e4571ae1e873de5e6d71138a950f5d70 + source_hash: 4b5361f196bbb27ba74f281b4665eaaba770d3532eae2d02f76a14f44d3b4618 source_path: providers/github-copilot.md workflow: 15 --- -GitHub Copilot — це помічник для кодування зі штучним інтелектом від GitHub. Він надає доступ до моделей Copilot для вашого облікового запису GitHub і тарифного плану. OpenClaw може використовувати Copilot як постачальника моделі двома різними способами. +GitHub Copilot — це помічник GitHub для програмування на основі ШІ. Він надає доступ до +моделей Copilot для вашого облікового запису GitHub і тарифного плану. OpenClaw може використовувати Copilot як постачальника моделей +двома різними способами. -## Два способи використовувати Copilot в OpenClaw +## Два способи використання Copilot в OpenClaw - Використовуйте нативний процес входу через device flow, щоб отримати токен GitHub, а потім обміняти його на токени API Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях, оскільки він не потребує VS Code. + Використовуйте нативний потік входу через пристрій, щоб отримати токен GitHub, а потім обміняти його на + токени API Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях, + оскільки він не потребує VS Code. - + ```bash openclaw models auth login-github-copilot ``` - Вам буде запропоновано перейти за URL-адресою та ввести одноразовий код. Тримайте термінал відкритим, доки процес не завершиться. + Вам буде запропоновано відкрити URL-адресу та ввести одноразовий код. Не + закривайте термінал, доки процес не завершиться. ```bash @@ -49,10 +54,12 @@ GitHub Copilot — це помічник для кодування зі штуч - Використовуйте розширення VS Code **Copilot Proxy** як локальний міст. OpenClaw звертається до endpoint `/v1` проксі та використовує список моделей, який ви там налаштовуєте. + Використовуйте розширення VS Code **Copilot Proxy** як локальний міст. OpenClaw звертається до + кінцевої точки проксі `/v1` і використовує список моделей, який ви там налаштуєте. - Вибирайте цей варіант, якщо ви вже запускаєте Copilot Proxy у VS Code або вам потрібно маршрутизувати трафік через нього. Ви маєте ввімкнути Plugin і підтримувати роботу розширення VS Code. + Оберіть цей варіант, якщо ви вже запускаєте Copilot Proxy у VS Code або вам потрібно спрямовувати трафік + через нього. Ви повинні ввімкнути Plugin і підтримувати роботу розширення VS Code. @@ -60,9 +67,9 @@ GitHub Copilot — це помічник для кодування зі штуч ## Необов’язкові прапорці -| Прапорець | Опис | -| -------------- | --------------------------------------------------- | -| `--yes` | Пропустити запит на підтвердження | +| Flag | Опис | +| --------------- | -------------------------------------------------- | +| `--yes` | Пропустити запит підтвердження | | `--set-default` | Також застосувати рекомендовану типову модель постачальника | ```bash @@ -75,55 +82,68 @@ openclaw models auth login --provider github-copilot --method device --set-defau - Процес входу через device flow вимагає інтерактивного TTY. Запускайте його безпосередньо в терміналі, а не в неінтерактивному скрипті чи CI-конвеєрі. + Потік входу через пристрій потребує інтерактивного TTY. Запускайте його безпосередньо в + терміналі, а не в неінтерактивному скрипті чи конвеєрі CI. - Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель відхиляється, спробуйте інший ідентифікатор (наприклад, `github-copilot/gpt-4.1`). + Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель + відхиляється, спробуйте інший ID (наприклад, `github-copilot/gpt-4.1`). - Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. Моделі GPT, o-series і Gemini зберігають транспорт OpenAI Responses. OpenClaw вибирає правильний транспорт на основі посилання на модель. + Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. Моделі GPT, + o-series і Gemini зберігають транспорт OpenAI Responses. OpenClaw + вибирає правильний транспорт на основі посилання на модель. - OpenClaw надсилає для транспортів Copilot заголовки запитів у стилі Copilot IDE, включно з подальшими ходами tool-result і image. Він не вмикає continuation Responses на рівні постачальника для Copilot, якщо таку поведінку не було перевірено на API Copilot. + OpenClaw надсилає заголовки запитів Copilot у стилі IDE на транспортних рівнях Copilot, + зокрема для вбудованого Compaction, результатів інструментів і наступних ходів із зображеннями. Він + не вмикає продовження Responses на рівні постачальника для Copilot, якщо + таку поведінку не було перевірено на API Copilot. - - OpenClaw визначає автентифікацію Copilot зі змінних середовища в такому порядку пріоритету: + + OpenClaw визначає автентифікацію Copilot зі змінних середовища в такому + порядку пріоритету: - | Пріоритет | Змінна | Примітки | - | --------- | -------------------- | -------------------------------- | - | 1 | `COPILOT_GITHUB_TOKEN` | Найвищий пріоритет, специфічна для Copilot | - | 2 | `GH_TOKEN` | Токен GitHub CLI (резервний варіант) | - | 3 | `GITHUB_TOKEN` | Стандартний токен GitHub (найнижчий пріоритет) | + | Priority | Variable | Примітки | + | -------- | --------------------- | -------------------------------- | + | 1 | `COPILOT_GITHUB_TOKEN` | Найвищий пріоритет, спеціально для Copilot | + | 2 | `GH_TOKEN` | Токен GitHub CLI (резервний варіант) | + | 3 | `GITHUB_TOKEN` | Стандартний токен GitHub (найнижчий пріоритет) | - Коли встановлено кілька змінних, OpenClaw використовує ту, що має найвищий пріоритет. - Процес входу через device flow (`openclaw models auth login-github-copilot`) зберігає свій токен у сховищі профілів автентифікації та має пріоритет над усіма змінними середовища. + Коли встановлено кілька змінних, OpenClaw використовує змінну з найвищим пріоритетом. + Потік входу через пристрій (`openclaw models auth login-github-copilot`) зберігає + свій токен у сховищі профілю автентифікації та має пріоритет над усіма змінними + середовища. - - Під час входу токен GitHub зберігається у сховищі профілів автентифікації та обмінюється на токен API Copilot під час роботи OpenClaw. Вам не потрібно керувати токеном вручну. + + Під час входу токен GitHub зберігається у сховищі профілю автентифікації та обмінюється + на токен API Copilot під час роботи OpenClaw. Вам не потрібно керувати + токеном вручну. -Потрібен інтерактивний TTY. Запускайте команду входу безпосередньо в терміналі, а не всередині headless-скрипту чи CI-завдання. +Потрібен інтерактивний TTY. Запускайте команду входу безпосередньо в терміналі, а не +всередині безголового скрипта чи завдання CI. ## Вбудовування для пошуку в пам’яті GitHub Copilot також може слугувати постачальником вбудовувань для [пошуку в пам’яті](/uk/concepts/memory-search). Якщо у вас є підписка Copilot і -ви виконали вхід, OpenClaw може використовувати його для вбудовувань без окремого API-ключа. +ви вже увійшли, OpenClaw може використовувати його для вбудовувань без окремого ключа API. ### Автовиявлення -Коли `memorySearch.provider` має значення `"auto"` (типове значення), GitHub Copilot -пробується з пріоритетом 15 — після локальних вбудовувань, але перед OpenAI та іншими платними -постачальниками. Якщо доступний токен GitHub, OpenClaw виявляє доступні +Коли `memorySearch.provider` має значення `"auto"` (типове значення), GitHub Copilot перевіряється +з пріоритетом 15 — після локальних вбудовувань, але перед OpenAI та іншими платними +постачальниками. Якщо токен GitHub доступний, OpenClaw виявляє доступні моделі вбудовувань через API Copilot і автоматично вибирає найкращу. ### Явна конфігурація @@ -134,7 +154,7 @@ GitHub Copilot також може слугувати постачальнико defaults: { memorySearch: { provider: "github-copilot", - // Необов’язково: перевизначити модель, виявлену автоматично + // Необов’язково: перевизначити автоматично виявлену модель model: "text-embedding-3-small", }, }, @@ -145,13 +165,13 @@ GitHub Copilot також може слугувати постачальнико ### Як це працює 1. OpenClaw визначає ваш токен GitHub (зі змінних середовища або профілю автентифікації). -2. Обмінює його на короткоживучий токен API Copilot. -3. Виконує запит до endpoint `/models` Copilot, щоб виявити доступні моделі вбудовувань. +2. Обмінює його на короткостроковий токен API Copilot. +3. Виконує запит до кінцевої точки Copilot `/models`, щоб виявити доступні моделі вбудовувань. 4. Вибирає найкращу модель (надає перевагу `text-embedding-3-small`). -5. Надсилає запити на вбудовування до endpoint `/embeddings` Copilot. +5. Надсилає запити на вбудовування до кінцевої точки Copilot `/embeddings`. -Доступність моделей залежить від вашого тарифного плану GitHub. Якщо моделі -вбудовувань недоступні, OpenClaw пропускає Copilot і переходить до наступного постачальника. +Доступність моделей залежить від вашого тарифного плану GitHub. Якщо жодні моделі вбудовувань не +доступні, OpenClaw пропускає Copilot і переходить до наступного постачальника. ## Пов’язане @@ -160,6 +180,6 @@ GitHub Copilot також може слугувати постачальнико Вибір постачальників, посилань на моделі та поведінки резервного перемикання. - Докладніше про автентифікацію та правила повторного використання облікових даних. + Докладно про автентифікацію та правила повторного використання облікових даних. diff --git a/docs/uk/tools/plugin.md b/docs/uk/tools/plugin.md index efb808b6c..2d06f2494 100644 --- a/docs/uk/tools/plugin.md +++ b/docs/uk/tools/plugin.md @@ -2,35 +2,35 @@ read_when: - Встановлення або налаштування плагінів - Розуміння правил виявлення та завантаження плагінів - - Робота з сумісними з Codex/Claude наборами плагінів + - Робота з наборами плагінів, сумісними з Codex/Claude sidebarTitle: Install and Configure -summary: Встановлення, налаштування та керування плагінами OpenClaw +summary: Встановлюйте, налаштовуйте та керуйте плагінами OpenClaw title: Плагіни x-i18n: - generated_at: "2026-04-24T16:58:33Z" + generated_at: "2026-04-24T22:59:29Z" model: gpt-5.4 provider: openai - source_hash: 1f4968e70dc215dc50916f2d180121ce2afbe90e6bb2a85d3fe0bd8d989244fd + source_hash: 7d962119bcb2bf94da08fcd48d4da8be76618104ea3c37ce60e2fcf397b05c98 source_path: tools/plugin.md workflow: 15 --- Плагіни розширюють OpenClaw новими можливостями: канали, постачальники моделей, -agent harnesses, інструменти, Skills, мовлення, транскрипція в реальному часі, голос у реальному -часі, розуміння медіа, генерація зображень, генерація відео, отримання даних з вебу, вебпошук -та інше. Деякі плагіни є **core** (постачаються разом з OpenClaw), інші +середовища агентів, інструменти, Skills, мовлення, транскрипція в реальному часі, голос +у реальному часі, розуміння медіа, генерація зображень, генерація відео, отримання даних із вебу, вебпошук +та інше. Деякі плагіни є **core** (постачаються з OpenClaw), інші є **external** (опубліковані спільнотою в npm). ## Швидкий старт - + ```bash openclaw plugins list ``` - + ```bash # З npm openclaw plugins install @openclaw/voice-call @@ -47,12 +47,12 @@ agent harnesses, інструменти, Skills, мовлення, транск openclaw gateway restart ``` - Потім налаштуйте в `plugins.entries.\.config` у вашому файлі конфігурації. + Потім налаштуйте в розділі `plugins.entries.\.config` у вашому файлі конфігурації. -Якщо ви віддаєте перевагу керуванню безпосередньо в чаті, увімкніть `commands.plugins: true` і використовуйте: +Якщо ви віддаєте перевагу керуванню прямо в чаті, увімкніть `commands.plugins: true` і використовуйте: ```text /plugin install clawhub:@openclaw/voice-call @@ -60,23 +60,23 @@ agent harnesses, інструменти, Skills, мовлення, транск /plugin enable voice-call ``` -Шлях встановлення використовує той самий механізм резолюції, що й CLI: локальний -шлях/архів, явний `clawhub:` або специфікація пакета без префікса (спочатку -ClawHub, потім резервний варіант npm). +Шлях установлення використовує той самий механізм визначення, що й CLI: локальний +шлях/архів, явний `clawhub:` або специфікація пакета без префікса +(спочатку ClawHub, потім резервний варіант через npm). -Якщо конфігурація некоректна, встановлення зазвичай завершується із захистом від помилок і пропонує -скористатися `openclaw doctor --fix`. Єдиний виняток для відновлення — це вузький шлях +Якщо конфігурація некоректна, установлення зазвичай безпечно завершується з помилкою й +спрямовує вас до `openclaw doctor --fix`. Єдиний виняток для відновлення — це вузький шлях перевстановлення вбудованого плагіна для плагінів, які підтримують `openclaw.install.allowInvalidConfigRecovery`. -Пакетні встановлення OpenClaw не виконують завчасне встановлення всього дерева залежностей -середовища виконання для кожного вбудованого плагіна. Коли вбудований плагін OpenClaw є активним через -конфігурацію плагіна, застарілу конфігурацію каналу або маніфест, увімкнений за замовчуванням, -під час запуску відновлюються лише оголошені цим плагіном залежності середовища виконання -перед його імпортом. Явне вимкнення все одно має пріоритет: `plugins.entries..enabled: false`, +Упаковані встановлення OpenClaw не встановлюють завчасно все дерево залежностей +середовища виконання для кожного вбудованого плагіна. Коли вбудований плагін, що належить OpenClaw, активний через +конфігурацію плагіна, застарілу конфігурацію каналу або стандартно ввімкнений маніфест, +під час запуску відновлюються лише оголошені залежності середовища виконання цього плагіна перед його імпортом. +Явне вимкнення все одно має пріоритет: `plugins.entries..enabled: false`, `plugins.deny`, `plugins.enabled: false` і `channels..enabled: false` запобігають автоматичному відновленню залежностей середовища виконання для цього вбудованого плагіна/каналу. -External плагіни та власні шляхи завантаження, як і раніше, потрібно встановлювати через +Зовнішні плагіни та власні шляхи завантаження все ще потрібно встановлювати через `openclaw plugins install`. ## Типи плагінів @@ -85,13 +85,13 @@ OpenClaw розпізнає два формати плагінів: | Формат | Як це працює | Приклади | | ---------- | ----------------------------------------------------------------- | ------------------------------------------------------ | -| **Native** | `openclaw.plugin.json` + модуль середовища виконання; виконується в межах процесу | Офіційні плагіни, npm-пакети спільноти | -| **Bundle** | Сумісне з Codex/Claude/Cursor компонування; зіставляється з можливостями OpenClaw | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` | +| **Native** | `openclaw.plugin.json` + модуль середовища виконання; виконується в межах процесу | Офіційні плагіни, пакети npm від спільноти | +| **Bundle** | Макет, сумісний із Codex/Claude/Cursor; зіставляється з можливостями OpenClaw | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` | -Обидва відображаються в `openclaw plugins list`. Докладніше про набори див. в [Набори плагінів](/uk/plugins/bundles). +Обидва відображаються в `openclaw plugins list`. Докладніше про набори див. у [Набори плагінів](/uk/plugins/bundles). -Якщо ви пишете native плагін, почніть з [Створення плагінів](/uk/plugins/building-plugins) -і [Огляду Plugin SDK](/uk/plugins/sdk-overview). +Якщо ви пишете native-плагін, почніть із [Створення плагінів](/uk/plugins/building-plugins) +та [Огляд Plugin SDK](/uk/plugins/sdk-overview). ## Офіційні плагіни @@ -99,17 +99,17 @@ OpenClaw розпізнає два формати плагінів: | Плагін | Пакет | Документація | | --------------- | --------------------- | ------------------------------------ | -| Matrix | `@openclaw/matrix` | [Matrix](/uk/channels/matrix) | -| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/uk/channels/msteams) | -| Nostr | `@openclaw/nostr` | [Nostr](/uk/channels/nostr) | -| Voice Call | `@openclaw/voice-call` | [Voice Call](/uk/plugins/voice-call) | -| Zalo | `@openclaw/zalo` | [Zalo](/uk/channels/zalo) | -| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/uk/plugins/zalouser) | +| Matrix | `@openclaw/matrix` | [Matrix](/uk/channels/matrix) | +| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/uk/channels/msteams) | +| Nostr | `@openclaw/nostr` | [Nostr](/uk/channels/nostr) | +| Voice Call | `@openclaw/voice-call`| [Voice Call](/uk/plugins/voice-call) | +| Zalo | `@openclaw/zalo` | [Zalo](/uk/channels/zalo) | +| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/uk/plugins/zalouser) | -### Core (постачаються разом з OpenClaw) +### Core (постачаються з OpenClaw) - + `anthropic`, `byteplus`, `cloudflare-ai-gateway`, `github-copilot`, `google`, `huggingface`, `kilocode`, `kimi-coding`, `minimax`, `mistral`, `qwen`, `moonshot`, `nvidia`, `openai`, `opencode`, `opencode-go`, `openrouter`, @@ -118,17 +118,17 @@ OpenClaw розпізнає два формати плагінів: - - `memory-core` — вбудований пошук у пам’яті (типово через `plugins.slots.memory`) - - `memory-lancedb` — довготривала пам’ять із встановленням за потреби, автоматичним пригадуванням/захопленням (встановіть `plugins.slots.memory = "memory-lancedb"`) + - `memory-core` — вбудований пошук у пам’яті (за замовчуванням через `plugins.slots.memory`) + - `memory-lancedb` — довготривала пам’ять зі встановленням за потреби з автоматичним пригадуванням/збереженням (установіть `plugins.slots.memory = "memory-lancedb"`) - + `elevenlabs`, `microsoft` - - `browser` — вбудований browser плагін для browser tool, CLI `openclaw browser`, методу Gateway `browser.request`, browser runtime і типового сервісу керування browser (увімкнено за замовчуванням; вимкніть перед заміною) - - `copilot-proxy` — міст VS Code Copilot Proxy (типово вимкнено) + - `browser` — вбудований плагін браузера для інструмента браузера, CLI `openclaw browser`, методу Gateway `browser.request`, середовища виконання браузера та стандартної служби керування браузером (увімкнений за замовчуванням; вимкніть його перед заміною) + - `copilot-proxy` — міст VS Code Copilot Proxy (вимкнений за замовчуванням) @@ -154,25 +154,25 @@ OpenClaw розпізнає два формати плагінів: | ---------------- | --------------------------------------------------------- | | `enabled` | Головний перемикач (типово: `true`) | | `allow` | Список дозволених плагінів (необов’язково) | -| `deny` | Список заборонених плагінів (необов’язково; заборона має пріоритет) | +| `deny` | Список заборонених плагінів (необов’язково; deny має пріоритет) | | `load.paths` | Додаткові файли/каталоги плагінів | | `slots` | Селектори ексклюзивних слотів (наприклад, `memory`, `contextEngine`) | -| `entries.\` | Перемикачі та конфігурація для окремого плагіна | +| `entries.\` | Перемикачі й конфігурація для окремого плагіна | -Зміни конфігурації **потребують перезапуску Gateway**. Якщо Gateway запущено з -відстеженням конфігурації та увімкненим перезапуском у межах процесу (типовий шлях `openclaw gateway`), -цей перезапуск зазвичай виконується автоматично невдовзі після застосування запису конфігурації. -Підтримуваного шляху гарячого перезавантаження для native коду середовища виконання плагінів або lifecycle -hooks немає; перезапустіть процес Gateway, який обслуговує активний канал, перш ніж -очікувати, що оновлений код `register(api)`, хуки `api.on(...)`, інструменти, сервіси або +Зміни конфігурації **потребують перезапуску Gateway**. Якщо Gateway працює з відстеженням +конфігурації та увімкненим внутрішньопроцесним перезапуском (стандартний шлях `openclaw gateway`), +цей перезапуск зазвичай виконується автоматично невдовзі після запису змін до конфігурації. +Підтримуваного шляху гарячого перезавантаження для native-коду середовища виконання плагіна або хуків +життєвого циклу немає; перезапустіть процес Gateway, який обслуговує активний канал, перш ніж +очікувати, що оновлений код `register(api)`, хуки `api.on(...)`, інструменти, служби або хуки постачальника/середовища виконання почнуть працювати. `openclaw plugins list` — це локальний знімок CLI/конфігурації. Позначка `loaded` для плагіна там -означає, що плагін можна виявити та завантажити з конфігурації/файлів, які бачить -цей виклик CLI. Це не доводить, що вже запущений віддалений дочірній процес Gateway -було перезапущено в той самий код плагіна. У налаштуваннях VPS/контейнерів з процесами-обгортками -надсилайте перезапуски фактичному процесу `openclaw gateway run` або -використовуйте `openclaw gateway restart` для запущеного Gateway. +означає, що плагін можна виявити й завантажити з конфігурації/файлів, які бачить цей +запуск CLI. Це не доводить, що вже запущений віддалений дочірній процес Gateway +було перезапущено з тим самим кодом плагіна. У середовищах VPS/контейнерів з обгортковими +процесами надсилайте перезапуск фактичному процесу `openclaw gateway run` або використовуйте +`openclaw gateway restart` для запущеного Gateway. - **Вимкнений**: плагін існує, але правила ввімкнення його вимкнули. Конфігурація зберігається. @@ -182,7 +182,7 @@ hooks немає; перезапустіть процес Gateway, який об ## Виявлення та пріоритетність -OpenClaw сканує плагіни в такому порядку (перше співпадіння має пріоритет): +OpenClaw сканує плагіни в такому порядку (перше знайдене збігання має пріоритет): @@ -198,8 +198,8 @@ OpenClaw сканує плагіни в такому порядку (перше - Постачаються разом з OpenClaw. Багато з них увімкнено за замовчуванням (постачальники моделей, мовлення). - Для інших потрібне явне ввімкнення. + Постачаються з OpenClaw. Багато з них увімкнені за замовчуванням (постачальники моделей, мовлення). + Інші потребують явного ввімкнення. @@ -209,68 +209,68 @@ OpenClaw сканує плагіни в такому порядку (перше - `plugins.deny` завжди має пріоритет над allow - `plugins.entries.\.enabled: false` вимикає цей плагін - Плагіни з робочого простору **типово вимкнені** (їх потрібно явно ввімкнути) -- Вбудовані плагіни дотримуються вбудованого набору, увімкненого за замовчуванням, якщо не перевизначено +- Вбудовані плагіни дотримуються вбудованого набору типово ввімкнених, якщо не перевизначено - Ексклюзивні слоти можуть примусово ввімкнути вибраний плагін для цього слота -- Деякі вбудовані opt-in плагіни вмикаються автоматично, коли конфігурація задає - surface, що належить плагіну, наприклад посилання на модель постачальника, конфігурацію каналу або harness - runtime -- Маршрути Codex сімейства OpenAI зберігають окремі межі між плагінами: - `openai-codex/*` належить плагіну OpenAI, тоді як вбудований плагін Codex - app-server вибирається через `embeddedHarness.runtime: "codex"` або застарілі - посилання на модель `codex/*` +- Деякі вбудовані плагіни з добровільним увімкненням активуються автоматично, коли конфігурація вказує поверхню, що належить плагіну, + наприклад посилання на модель постачальника, конфігурацію каналу або + середовище виконання harness +- Маршрути Codex сімейства OpenAI зберігають окремі межі плагінів: + `openai-codex/*` належить плагіну OpenAI, тоді як вбудований плагін + app-server Codex вибирається через `embeddedHarness.runtime: "codex"` або застарілі + посилання на моделі `codex/*` ## Усунення проблем із хуками середовища виконання -Якщо плагін відображається в `plugins list`, але побічні ефекти `register(api)` або hooks -не спрацьовують у живому чат-трафіку, спочатку перевірте таке: +Якщо плагін з’являється в `plugins list`, але побічні ефекти або хуки `register(api)` +не працюють у живому трафіку чату, спершу перевірте таке: -- Запустіть `openclaw gateway status --deep --require-rpc` і переконайтеся, що активні - URL Gateway, профіль, шлях до конфігурації та процес — це саме ті, які ви редагуєте. -- Перезапустіть активний Gateway після змін у встановленні/конфігурації/коді плагіна. У контейнерах - з обгортками процес PID 1 може бути лише супервізором; перезапустіть або надішліть сигнал дочірньому +- Виконайте `openclaw gateway status --deep --require-rpc` і підтвердьте, що активні + URL Gateway, профіль, шлях до конфігурації та процес — саме ті, які ви редагуєте. +- Перезапустіть активний Gateway після змін встановлення/конфігурації/коду плагіна. У контейнерах + з обгортками PID 1 може бути лише супервізором; перезапустіть або надішліть сигнал дочірньому процесу `openclaw gateway run`. -- Використайте `openclaw plugins inspect --json`, щоб підтвердити реєстрації hooks і - діагностику. Невбудовані conversation hooks, такі як `llm_input`, +- Використовуйте `openclaw plugins inspect --json`, щоб підтвердити реєстрації хуків і + діагностику. Невбудовані хуки розмови, як-от `llm_input`, `llm_output` і `agent_end`, потребують `plugins.entries..hooks.allowConversationAccess=true`. -- Для перемикання моделей надавайте перевагу `before_model_resolve`. Він запускається до - визначення моделі для ходів агента; `llm_output` запускається лише після того, як спроба моделі - створить вивід асистента. -- Щоб підтвердити фактичну модель сесії, використовуйте `openclaw sessions` або - поверхні Gateway session/status, а під час налагодження payloads постачальника запускайте +- Для перемикання моделей віддавайте перевагу `before_model_resolve`. Він виконується перед визначенням + моделі для ходів агента; `llm_output` виконується лише після того, як спроба моделі + створює відповідь асистента. +- Для підтвердження фактичної моделі сесії використовуйте `openclaw sessions` або + поверхні сесії/статусу Gateway, а під час налагодження навантажень постачальника запускайте Gateway з `--raw-stream --raw-stream-path `. ## Слоти плагінів (ексклюзивні категорії) -Деякі категорії є ексклюзивними (одночасно може бути активним лише один плагін): +Деякі категорії є ексклюзивними (одночасно активним може бути лише один плагін): ```json5 { plugins: { slots: { memory: "memory-core", // або "none", щоб вимкнути - contextEngine: "legacy", // або ідентифікатор плагіна + contextEngine: "legacy", // або id плагіна }, }, } ``` -| Слот | Що він контролює | Типове значення | -| --------------- | ----------------------- | ------------------- | -| `memory` | Active Memory плагін | `memory-core` | +| Слот | Що він контролює | Типове значення | +| --------------- | ------------------------ | ------------------- | +| `memory` | Плагін Active Memory | `memory-core` | | `contextEngine` | Активний рушій контексту | `legacy` (вбудований) | ## Довідник CLI ```bash -openclaw plugins list # компактний перелік +openclaw plugins list # стислий перелік openclaw plugins list --enabled # лише завантажені плагіни -openclaw plugins list --verbose # докладні рядки для кожного плагіна -openclaw plugins list --json # машиночитаний перелік +openclaw plugins list --verbose # детальні рядки для кожного плагіна +openclaw plugins list --json # перелік у форматі для машинного читання openclaw plugins inspect # докладна інформація -openclaw plugins inspect --json # машиночитаний формат -openclaw plugins inspect --all # таблиця для всіх -openclaw plugins info # псевдонім для inspect +openclaw plugins inspect --json # формат для машинного читання +openclaw plugins inspect --all # таблиця для всього набору +openclaw plugins info # псевдонім inspect openclaw plugins doctor # діагностика openclaw plugins install # встановлення (спочатку ClawHub, потім npm) @@ -280,7 +280,7 @@ openclaw plugins install # встановлення з лок openclaw plugins install -l # підключення (без копіювання) для розробки openclaw plugins install --marketplace openclaw plugins install --marketplace https://github.com// -openclaw plugins install --pin # зафіксувати точну розв’язану npm-специфікацію +openclaw plugins install --pin # записати точну визначену специфікацію npm openclaw plugins install --dangerously-force-unsafe-install openclaw plugins update # оновити один плагін openclaw plugins update --dangerously-force-unsafe-install @@ -294,59 +294,60 @@ openclaw plugins enable openclaw plugins disable ``` -Вбудовані плагіни постачаються разом з OpenClaw. Багато з них увімкнено за замовчуванням (наприклад, -вбудовані постачальники моделей, вбудовані постачальники мовлення та вбудований -browser плагін). Інші вбудовані плагіни все одно потребують `openclaw plugins enable `. +Вбудовані плагіни постачаються разом з OpenClaw. Багато з них увімкнені за замовчуванням (наприклад, +вбудовані постачальники моделей, вбудовані постачальники мовлення та вбудований плагін +браузера). Інші вбудовані плагіни все одно потребують `openclaw plugins enable `. -`--force` перезаписує наявний встановлений плагін або набір hooks на місці. Використовуйте -`openclaw plugins update ` для звичайних оновлень відстежуваних npm -плагінів. Це не підтримується разом із `--link`, який повторно використовує вихідний шлях -замість копіювання в кероване місце встановлення. +`--force` перезаписує наявний встановлений плагін або пакунок хуків на місці. Використовуйте +`openclaw plugins update ` для звичайних оновлень відстежуваних npm- +плагінів. Він не підтримується разом із `--link`, який повторно використовує шлях до джерела +замість копіювання в керовану ціль установлення. -Коли `plugins.allow` уже задано, `openclaw plugins install` додає -ідентифікатор встановленого плагіна до цього списку дозволених перед його ввімкненням, щоб установлені плагіни -можна було одразу завантажити після перезапуску. +Коли `plugins.allow` уже налаштовано, `openclaw plugins install` додає +ідентифікатор установленого плагіна до цього списку дозволених перед його ввімкненням, тож установлені плагіни +можна відразу завантажувати після перезапуску. -`openclaw plugins update ` застосовується до відстежуваних встановлень. Передавання -npm-специфікації пакета з dist-tag або точною версією зводить назву пакета -назад до запису відстежуваного плагіна та зберігає нову специфікацію для майбутніх оновлень. -Передавання назви пакета без версії повертає точно зафіксоване встановлення до -типової лінії випусків реєстру. Якщо встановлений npm плагін уже відповідає -розв’язаній версії та збереженій ідентичності артефакту, OpenClaw пропускає оновлення -без завантаження, перевстановлення або перезапису конфігурації. +`openclaw plugins update ` застосовується до відстежуваних установлень. Передавання +специфікації пакета npm із dist-tag або точною версією зіставляє назву пакета +назад із записом відстежуваного плагіна та зберігає нову специфікацію для майбутніх оновлень. +Передавання назви пакета без версії переводить точно закріплене встановлення назад на +стандартну лінійку випусків реєстру. Якщо встановлений npm-плагін уже відповідає +визначеній версії та збереженій ідентичності артефакту, OpenClaw пропускає оновлення +без завантаження, перевстановлення чи перезапису конфігурації. -`--pin` працює лише для npm. Він не підтримується разом із `--marketplace`, оскільки -встановлення з marketplace зберігають метадані джерела marketplace замість npm-специфікації. +`--pin` призначений лише для npm. Він не підтримується з `--marketplace`, оскільки +встановлення з marketplace зберігають метадані джерела marketplace замість специфікації npm. -`--dangerously-force-unsafe-install` — це аварійне перевизначення для хибнопозитивних -спрацьовувань вбудованого сканера небезпечного коду. Воно дозволяє продовжити встановлення -та оновлення плагінів попри вбудовані результати рівня `critical`, але все одно -не обходить блокування політики плагіна `before_install` або блокування через помилку сканування. +`--dangerously-force-unsafe-install` — це аварійний обхідний параметр для хибнопозитивних +спрацьовувань вбудованого сканера небезпечного коду. Він дозволяє продовжити встановлення +й оновлення плагінів попри вбудовані результати рівня `critical`, але все одно +не обходить блокування політики плагіна `before_install` або блокування через помилки сканування. -Цей прапорець CLI застосовується лише до потоків встановлення/оновлення плагінів. Встановлення залежностей Skills -через Gateway натомість використовують відповідне перевизначення запиту `dangerouslyForceUnsafeInstall`, тоді як -`openclaw skills install` залишається окремим потоком завантаження/встановлення Skills із ClawHub. +Цей прапорець CLI застосовується лише до потоків встановлення/оновлення плагінів. Встановлення +залежностей Skills через Gateway натомість використовують відповідний параметр запиту +`dangerouslyForceUnsafeInstall`, тоді як `openclaw skills install` залишається окремим +потоком завантаження/встановлення Skills із ClawHub. -Сумісні набори беруть участь у тому самому потоці list/inspect/enable/disable для плагінів. -Поточна підтримка середовища виконання включає bundle Skills, command-skills Claude, +Сумісні набори беруть участь у тому самому потоці list/inspect/enable/disable плагінів. +Поточна підтримка середовища виконання включає Skills із наборів, command-skills Claude, типові значення Claude `settings.json`, типові значення Claude `.lsp.json` і -оголошених у маніфесті `lspServers`, command-skills Cursor та сумісні каталоги hooks Codex. +оголошені в маніфесті `lspServers`, command-skills Cursor і сумісні каталоги хуків Codex. `openclaw plugins inspect ` також повідомляє про виявлені можливості набору, а також -підтримувані й непідтримувані записи серверів MCP і LSP для плагінів на основі наборів. +підтримувані або непідтримувані записи серверів MCP і LSP для плагінів на основі наборів. Джерелами marketplace можуть бути відома назва marketplace Claude з `~/.claude/plugins/known_marketplaces.json`, локальний корінь marketplace або шлях до `marketplace.json`, скорочений запис GitHub на кшталт `owner/repo`, URL репозиторію GitHub -або URL git. Для віддалених marketplace записи плагінів мають залишатися в межах -клонованого репозиторію marketplace та використовувати лише відносні джерела шляхів. +або URL git. Для віддалених marketplace записи плагінів мають залишатися всередині +клонованого репозиторію marketplace і використовувати лише відносні шляхи до джерел. -Повні відомості див. у [довіднику CLI `openclaw plugins`](/uk/cli/plugins). +Див. [довідник CLI `openclaw plugins`](/uk/cli/plugins), щоб отримати повну інформацію. -## Огляд API плагінів +## Огляд Plugin API -Native плагіни експортують об’єкт входу, який надає `register(api)`. Старіші -плагіни все ще можуть використовувати `activate(api)` як застарілий псевдонім, але нові плагіни повинні +Native-плагіни експортують об’єкт входу, який надає `register(api)`. Старіші +плагіни ще можуть використовувати `activate(api)` як застарілий псевдонім, але нові плагіни мають використовувати `register`. ```typescript @@ -368,52 +369,69 @@ export default definePluginEntry({ ``` OpenClaw завантажує об’єкт входу та викликає `register(api)` під час -активації плагіна. Завантажувач усе ще використовує резервний перехід до `activate(api)` для старіших плагінів, -але вбудовані плагіни та нові external плагіни повинні вважати `register` публічним контрактом. +активації плагіна. Завантажувач усе ще повертається до `activate(api)` для старіших плагінів, +але вбудовані плагіни та нові зовнішні плагіни повинні розглядати `register` як +публічний контракт. + +`api.registrationMode` повідомляє плагіну, чому завантажується його об’єкт входу: + +| Режим | Значення | +| --------------- | ----------------------------------------------------------------------------------------------------- | +| `full` | Активація середовища виконання. Реєструйте інструменти, хуки, служби, команди, маршрути та інші живі побічні ефекти. | +| `discovery` | Виявлення можливостей лише для читання. Реєструйте постачальників і метадані, але пропускайте дорогі живі побічні ефекти. | +| `setup-only` | Завантаження метаданих налаштування каналу через полегшений запис налаштування. | +| `setup-runtime` | Завантаження налаштування каналу, яке також потребує запису середовища виконання. | +| `cli-metadata` | Лише збирання метаданих команд CLI. | + +Об’єкти входу плагінів, які відкривають сокети, бази даних, фонові воркери або довготривалі +клієнти, повинні обмежувати ці побічні ефекти через `api.registrationMode === "full"`. +Завантаження для виявлення кешуються окремо від завантажень для активації та не замінюють +реєстр запущеного Gateway. Поширені методи реєстрації: -| Метод | Що він реєструє | -| -------------------------------------- | -------------------------- | -| `registerProvider` | Постачальник моделей (LLM) | -| `registerChannel` | Канал чату | -| `registerTool` | Інструмент агента | -| `registerHook` / `on(...)` | Lifecycle hooks | -| `registerSpeechProvider` | Синтез мовлення / STT | -| `registerRealtimeTranscriptionProvider`| Потоковий STT | -| `registerRealtimeVoiceProvider` | Двобічний голос у реальному часі | -| `registerMediaUnderstandingProvider` | Аналіз зображень/аудіо | -| `registerImageGenerationProvider` | Генерація зображень | -| `registerMusicGenerationProvider` | Генерація музики | -| `registerVideoGenerationProvider` | Генерація відео | -| `registerWebFetchProvider` | Постачальник веб-отримання / збирання | -| `registerWebSearchProvider` | Вебпошук | -| `registerHttpRoute` | HTTP endpoint | -| `registerCommand` / `registerCli` | Команди CLI | -| `registerContextEngine` | Рушій контексту | -| `registerService` | Фоновий сервіс | +| Метод | Що реєструє | +| -------------------------------------- | ---------------------------- | +| `registerProvider` | Постачальник моделей (LLM) | +| `registerChannel` | Чат-канал | +| `registerTool` | Інструмент агента | +| `registerHook` / `on(...)` | Хуки життєвого циклу | +| `registerSpeechProvider` | Синтез мовлення / STT | +| `registerRealtimeTranscriptionProvider`| Потоковий STT | +| `registerRealtimeVoiceProvider` | Двосторонній голос у реальному часі | +| `registerMediaUnderstandingProvider` | Аналіз зображень/аудіо | +| `registerImageGenerationProvider` | Генерація зображень | +| `registerMusicGenerationProvider` | Генерація музики | +| `registerVideoGenerationProvider` | Генерація відео | +| `registerWebFetchProvider` | Постачальник отримання / скрапінгу вебданих | +| `registerWebSearchProvider` | Вебпошук | +| `registerHttpRoute` | HTTP-ендпойнт | +| `registerCommand` / `registerCli` | Команди CLI | +| `registerContextEngine` | Рушій контексту | +| `registerService` | Фонова служба | -Поведінка guard hooks для типізованих lifecycle hooks: +Поведінка захисту хуків для типізованих хуків життєвого циклу: -- `before_tool_call`: `{ block: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. -- `before_tool_call`: `{ block: false }` не має ефекту та не скасовує раніше встановлене блокування. -- `before_install`: `{ block: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. -- `before_install`: `{ block: false }` не має ефекту та не скасовує раніше встановлене блокування. -- `message_sending`: `{ cancel: true }` є термінальним; обробники з нижчим пріоритетом пропускаються. -- `message_sending`: `{ cancel: false }` не має ефекту та не скасовує раніше встановлене скасування. +- `before_tool_call`: `{ block: true }` є кінцевим; обробники з нижчим пріоритетом пропускаються. +- `before_tool_call`: `{ block: false }` не змінює стан і не скасовує раніше встановлене блокування. +- `before_install`: `{ block: true }` є кінцевим; обробники з нижчим пріоритетом пропускаються. +- `before_install`: `{ block: false }` не змінює стан і не скасовує раніше встановлене блокування. +- `message_sending`: `{ cancel: true }` є кінцевим; обробники з нижчим пріоритетом пропускаються. +- `message_sending`: `{ cancel: false }` не змінює стан і не скасовує раніше встановлене скасування. -Native Codex app-server повертає події інструментів, нативних для Codex, назад у цю -поверхню hooks через міст. Плагіни можуть блокувати нативні інструменти Codex через `before_tool_call`, -спостерігати за результатами через `after_tool_call` і брати участь у погодженнях -`PermissionRequest` Codex. Міст поки що не переписує аргументи інструментів, нативних для Codex. +Native app-server Codex повертає містком власні події інструментів Codex назад у цю +поверхню хуків. Плагіни можуть блокувати власні інструменти Codex через `before_tool_call`, +спостерігати за результатами через `after_tool_call` і брати участь у схваленні +`PermissionRequest` Codex. Місток поки що не переписує аргументи +власних інструментів Codex. -Повну поведінку типізованих hooks див. в [Огляді SDK](/uk/plugins/sdk-overview#hook-decision-semantics). +Повну типізовану поведінку хуків див. в [Огляд SDK](/uk/plugins/sdk-overview#hook-decision-semantics). ## Пов’язане - [Створення плагінів](/uk/plugins/building-plugins) — створіть власний плагін - [Набори плагінів](/uk/plugins/bundles) — сумісність наборів Codex/Claude/Cursor - [Маніфест плагіна](/uk/plugins/manifest) — схема маніфесту -- [Реєстрація інструментів](/uk/plugins/building-plugins#registering-agent-tools) — додавання інструментів агента в плагін -- [Внутрішня архітектура плагінів](/uk/plugins/architecture) — модель можливостей і конвеєр завантаження +- [Реєстрація інструментів](/uk/plugins/building-plugins#registering-agent-tools) — додайте інструменти агента в плагін +- [Внутрішня будова плагінів](/uk/plugins/architecture) — модель можливостей і конвеєр завантаження - [Плагіни спільноти](/uk/plugins/community) — сторонні добірки