chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
fad8b7174d
commit
281323a98f
@ -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
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Вбудований постачальник (github-copilot)">
|
||||
Використовуйте нативний процес входу через device flow, щоб отримати токен GitHub, а потім обміняти його на токени API Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях, оскільки він не потребує VS Code.
|
||||
Використовуйте нативний потік входу через пристрій, щоб отримати токен GitHub, а потім обміняти його на
|
||||
токени API Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях,
|
||||
оскільки він не потребує VS Code.
|
||||
|
||||
<Steps>
|
||||
<Step title="Запустіть команду входу">
|
||||
<Step title="Виконайте команду входу">
|
||||
```bash
|
||||
openclaw models auth login-github-copilot
|
||||
```
|
||||
|
||||
Вам буде запропоновано перейти за URL-адресою та ввести одноразовий код. Тримайте термінал відкритим, доки процес не завершиться.
|
||||
Вам буде запропоновано відкрити URL-адресу та ввести одноразовий код. Не
|
||||
закривайте термінал, доки процес не завершиться.
|
||||
</Step>
|
||||
<Step title="Установіть типову модель">
|
||||
```bash
|
||||
@ -49,10 +54,12 @@ GitHub Copilot — це помічник для кодування зі штуч
|
||||
</Tab>
|
||||
|
||||
<Tab title="Plugin Copilot Proxy (copilot-proxy)">
|
||||
Використовуйте розширення VS Code **Copilot Proxy** як локальний міст. OpenClaw звертається до endpoint `/v1` проксі та використовує список моделей, який ви там налаштовуєте.
|
||||
Використовуйте розширення VS Code **Copilot Proxy** як локальний міст. OpenClaw звертається до
|
||||
кінцевої точки проксі `/v1` і використовує список моделей, який ви там налаштуєте.
|
||||
|
||||
<Note>
|
||||
Вибирайте цей варіант, якщо ви вже запускаєте Copilot Proxy у VS Code або вам потрібно маршрутизувати трафік через нього. Ви маєте ввімкнути Plugin і підтримувати роботу розширення VS Code.
|
||||
Оберіть цей варіант, якщо ви вже запускаєте Copilot Proxy у VS Code або вам потрібно спрямовувати трафік
|
||||
через нього. Ви повинні ввімкнути Plugin і підтримувати роботу розширення VS Code.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
@ -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
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Потрібен інтерактивний TTY">
|
||||
Процес входу через device flow вимагає інтерактивного TTY. Запускайте його безпосередньо в терміналі, а не в неінтерактивному скрипті чи CI-конвеєрі.
|
||||
Потік входу через пристрій потребує інтерактивного TTY. Запускайте його безпосередньо в
|
||||
терміналі, а не в неінтерактивному скрипті чи конвеєрі CI.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Доступність моделей залежить від вашого тарифного плану">
|
||||
Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель відхиляється, спробуйте інший ідентифікатор (наприклад, `github-copilot/gpt-4.1`).
|
||||
Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель
|
||||
відхиляється, спробуйте інший ID (наприклад, `github-copilot/gpt-4.1`).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Вибір транспорту">
|
||||
Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. Моделі GPT, o-series і Gemini зберігають транспорт OpenAI Responses. OpenClaw вибирає правильний транспорт на основі посилання на модель.
|
||||
Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. Моделі GPT,
|
||||
o-series і Gemini зберігають транспорт OpenAI Responses. OpenClaw
|
||||
вибирає правильний транспорт на основі посилання на модель.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Сумісність запитів">
|
||||
OpenClaw надсилає для транспортів Copilot заголовки запитів у стилі Copilot IDE, включно з подальшими ходами tool-result і image. Він не вмикає continuation Responses на рівні постачальника для Copilot, якщо таку поведінку не було перевірено на API Copilot.
|
||||
OpenClaw надсилає заголовки запитів Copilot у стилі IDE на транспортних рівнях Copilot,
|
||||
зокрема для вбудованого Compaction, результатів інструментів і наступних ходів із зображеннями. Він
|
||||
не вмикає продовження Responses на рівні постачальника для Copilot, якщо
|
||||
таку поведінку не було перевірено на API Copilot.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Порядок пріоритету змінних середовища">
|
||||
OpenClaw визначає автентифікацію Copilot зі змінних середовища в такому порядку пріоритету:
|
||||
<Accordion title="Порядок визначення змінних середовища">
|
||||
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`) зберігає
|
||||
свій токен у сховищі профілю автентифікації та має пріоритет над усіма змінними
|
||||
середовища.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Зберігання токена">
|
||||
Під час входу токен GitHub зберігається у сховищі профілів автентифікації та обмінюється на токен API Copilot під час роботи OpenClaw. Вам не потрібно керувати токеном вручну.
|
||||
<Accordion title="Зберігання токенів">
|
||||
Під час входу токен GitHub зберігається у сховищі профілю автентифікації та обмінюється
|
||||
на токен API Copilot під час роботи OpenClaw. Вам не потрібно керувати
|
||||
токеном вручну.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
<Warning>
|
||||
Потрібен інтерактивний TTY. Запускайте команду входу безпосередньо в терміналі, а не всередині headless-скрипту чи CI-завдання.
|
||||
Потрібен інтерактивний TTY. Запускайте команду входу безпосередньо в терміналі, а не
|
||||
всередині безголового скрипта чи завдання CI.
|
||||
</Warning>
|
||||
|
||||
## Вбудовування для пошуку в пам’яті
|
||||
|
||||
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 також може слугувати постачальнико
|
||||
Вибір постачальників, посилань на моделі та поведінки резервного перемикання.
|
||||
</Card>
|
||||
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
|
||||
Докладніше про автентифікацію та правила повторного використання облікових даних.
|
||||
Докладно про автентифікацію та правила повторного використання облікових даних.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -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).
|
||||
|
||||
## Швидкий старт
|
||||
|
||||
<Steps>
|
||||
<Step title="Подивіться, що завантажено">
|
||||
<Step title="Перегляньте, що завантажено">
|
||||
```bash
|
||||
openclaw plugins list
|
||||
```
|
||||
</Step>
|
||||
|
||||
<Step title="Встановіть плагін">
|
||||
<Step title="Установіть плагін">
|
||||
```bash
|
||||
# З npm
|
||||
openclaw plugins install @openclaw/voice-call
|
||||
@ -47,12 +47,12 @@ agent harnesses, інструменти, Skills, мовлення, транск
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
Потім налаштуйте в `plugins.entries.\<id\>.config` у вашому файлі конфігурації.
|
||||
Потім налаштуйте в розділі `plugins.entries.\<id\>.config` у вашому файлі конфігурації.
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
Якщо ви віддаєте перевагу керуванню безпосередньо в чаті, увімкніть `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:<pkg>` або специфікація пакета без префікса (спочатку
|
||||
ClawHub, потім резервний варіант npm).
|
||||
Шлях установлення використовує той самий механізм визначення, що й CLI: локальний
|
||||
шлях/архів, явний `clawhub:<pkg>` або специфікація пакета без префікса
|
||||
(спочатку ClawHub, потім резервний варіант через npm).
|
||||
|
||||
Якщо конфігурація некоректна, встановлення зазвичай завершується із захистом від помилок і пропонує
|
||||
скористатися `openclaw doctor --fix`. Єдиний виняток для відновлення — це вузький шлях
|
||||
Якщо конфігурація некоректна, установлення зазвичай безпечно завершується з помилкою й
|
||||
спрямовує вас до `openclaw doctor --fix`. Єдиний виняток для відновлення — це вузький шлях
|
||||
перевстановлення вбудованого плагіна для плагінів, які підтримують
|
||||
`openclaw.install.allowInvalidConfigRecovery`.
|
||||
|
||||
Пакетні встановлення OpenClaw не виконують завчасне встановлення всього дерева залежностей
|
||||
середовища виконання для кожного вбудованого плагіна. Коли вбудований плагін OpenClaw є активним через
|
||||
конфігурацію плагіна, застарілу конфігурацію каналу або маніфест, увімкнений за замовчуванням,
|
||||
під час запуску відновлюються лише оголошені цим плагіном залежності середовища виконання
|
||||
перед його імпортом. Явне вимкнення все одно має пріоритет: `plugins.entries.<id>.enabled: false`,
|
||||
Упаковані встановлення OpenClaw не встановлюють завчасно все дерево залежностей
|
||||
середовища виконання для кожного вбудованого плагіна. Коли вбудований плагін, що належить OpenClaw, активний через
|
||||
конфігурацію плагіна, застарілу конфігурацію каналу або стандартно ввімкнений маніфест,
|
||||
під час запуску відновлюються лише оголошені залежності середовища виконання цього плагіна перед його імпортом.
|
||||
Явне вимкнення все одно має пріоритет: `plugins.entries.<id>.enabled: false`,
|
||||
`plugins.deny`, `plugins.enabled: false` і `channels.<id>.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)
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Постачальники моделей (увімкнено за замовчуванням)">
|
||||
<Accordion title="Постачальники моделей (увімкнені за замовчуванням)">
|
||||
`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 розпізнає два формати плагінів:
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Плагіни пам’яті">
|
||||
- `memory-core` — вбудований пошук у пам’яті (типово через `plugins.slots.memory`)
|
||||
- `memory-lancedb` — довготривала пам’ять із встановленням за потреби, автоматичним пригадуванням/захопленням (встановіть `plugins.slots.memory = "memory-lancedb"`)
|
||||
- `memory-core` — вбудований пошук у пам’яті (за замовчуванням через `plugins.slots.memory`)
|
||||
- `memory-lancedb` — довготривала пам’ять зі встановленням за потреби з автоматичним пригадуванням/збереженням (установіть `plugins.slots.memory = "memory-lancedb"`)
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Постачальники мовлення (увімкнено за замовчуванням)">
|
||||
<Accordion title="Постачальники мовлення (увімкнені за замовчуванням)">
|
||||
`elevenlabs`, `microsoft`
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Інше">
|
||||
- `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 (вимкнений за замовчуванням)
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
@ -154,25 +154,25 @@ OpenClaw розпізнає два формати плагінів:
|
||||
| ---------------- | --------------------------------------------------------- |
|
||||
| `enabled` | Головний перемикач (типово: `true`) |
|
||||
| `allow` | Список дозволених плагінів (необов’язково) |
|
||||
| `deny` | Список заборонених плагінів (необов’язково; заборона має пріоритет) |
|
||||
| `deny` | Список заборонених плагінів (необов’язково; deny має пріоритет) |
|
||||
| `load.paths` | Додаткові файли/каталоги плагінів |
|
||||
| `slots` | Селектори ексклюзивних слотів (наприклад, `memory`, `contextEngine`) |
|
||||
| `entries.\<id\>` | Перемикачі та конфігурація для окремого плагіна |
|
||||
| `entries.\<id\>` | Перемикачі й конфігурація для окремого плагіна |
|
||||
|
||||
Зміни конфігурації **потребують перезапуску 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.
|
||||
|
||||
<Accordion title="Стани плагіна: вимкнений, відсутній або некоректний">
|
||||
- **Вимкнений**: плагін існує, але правила ввімкнення його вимкнули. Конфігурація зберігається.
|
||||
@ -182,7 +182,7 @@ hooks немає; перезапустіть процес Gateway, який об
|
||||
|
||||
## Виявлення та пріоритетність
|
||||
|
||||
OpenClaw сканує плагіни в такому порядку (перше співпадіння має пріоритет):
|
||||
OpenClaw сканує плагіни в такому порядку (перше знайдене збігання має пріоритет):
|
||||
|
||||
<Steps>
|
||||
<Step title="Шляхи з конфігурації">
|
||||
@ -198,8 +198,8 @@ OpenClaw сканує плагіни в такому порядку (перше
|
||||
</Step>
|
||||
|
||||
<Step title="Вбудовані плагіни">
|
||||
Постачаються разом з OpenClaw. Багато з них увімкнено за замовчуванням (постачальники моделей, мовлення).
|
||||
Для інших потрібне явне ввімкнення.
|
||||
Постачаються з OpenClaw. Багато з них увімкнені за замовчуванням (постачальники моделей, мовлення).
|
||||
Інші потребують явного ввімкнення.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
@ -209,68 +209,68 @@ OpenClaw сканує плагіни в такому порядку (перше
|
||||
- `plugins.deny` завжди має пріоритет над allow
|
||||
- `plugins.entries.\<id\>.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 <id> --json`, щоб підтвердити реєстрації hooks і
|
||||
діагностику. Невбудовані conversation hooks, такі як `llm_input`,
|
||||
- Використовуйте `openclaw plugins inspect <id> --json`, щоб підтвердити реєстрації хуків і
|
||||
діагностику. Невбудовані хуки розмови, як-от `llm_input`,
|
||||
`llm_output` і `agent_end`, потребують
|
||||
`plugins.entries.<id>.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 <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 <id> # докладна інформація
|
||||
openclaw plugins inspect <id> --json # машиночитаний формат
|
||||
openclaw plugins inspect --all # таблиця для всіх
|
||||
openclaw plugins info <id> # псевдонім для inspect
|
||||
openclaw plugins inspect <id> --json # формат для машинного читання
|
||||
openclaw plugins inspect --all # таблиця для всього набору
|
||||
openclaw plugins info <id> # псевдонім inspect
|
||||
openclaw plugins doctor # діагностика
|
||||
|
||||
openclaw plugins install <package> # встановлення (спочатку ClawHub, потім npm)
|
||||
@ -280,7 +280,7 @@ openclaw plugins install <path> # встановлення з лок
|
||||
openclaw plugins install -l <path> # підключення (без копіювання) для розробки
|
||||
openclaw plugins install <plugin> --marketplace <source>
|
||||
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>
|
||||
openclaw plugins install <spec> --pin # зафіксувати точну розв’язану npm-специфікацію
|
||||
openclaw plugins install <spec> --pin # записати точну визначену специфікацію npm
|
||||
openclaw plugins install <spec> --dangerously-force-unsafe-install
|
||||
openclaw plugins update <id-or-npm-spec> # оновити один плагін
|
||||
openclaw plugins update <id-or-npm-spec> --dangerously-force-unsafe-install
|
||||
@ -294,59 +294,60 @@ openclaw plugins enable <id>
|
||||
openclaw plugins disable <id>
|
||||
```
|
||||
|
||||
Вбудовані плагіни постачаються разом з OpenClaw. Багато з них увімкнено за замовчуванням (наприклад,
|
||||
вбудовані постачальники моделей, вбудовані постачальники мовлення та вбудований
|
||||
browser плагін). Інші вбудовані плагіни все одно потребують `openclaw plugins enable <id>`.
|
||||
Вбудовані плагіни постачаються разом з OpenClaw. Багато з них увімкнені за замовчуванням (наприклад,
|
||||
вбудовані постачальники моделей, вбудовані постачальники мовлення та вбудований плагін
|
||||
браузера). Інші вбудовані плагіни все одно потребують `openclaw plugins enable <id>`.
|
||||
|
||||
`--force` перезаписує наявний встановлений плагін або набір hooks на місці. Використовуйте
|
||||
`openclaw plugins update <id-or-npm-spec>` для звичайних оновлень відстежуваних npm
|
||||
плагінів. Це не підтримується разом із `--link`, який повторно використовує вихідний шлях
|
||||
замість копіювання в кероване місце встановлення.
|
||||
`--force` перезаписує наявний встановлений плагін або пакунок хуків на місці. Використовуйте
|
||||
`openclaw plugins update <id-or-npm-spec>` для звичайних оновлень відстежуваних npm-
|
||||
плагінів. Він не підтримується разом із `--link`, який повторно використовує шлях до джерела
|
||||
замість копіювання в керовану ціль установлення.
|
||||
|
||||
Коли `plugins.allow` уже задано, `openclaw plugins install` додає
|
||||
ідентифікатор встановленого плагіна до цього списку дозволених перед його ввімкненням, щоб установлені плагіни
|
||||
можна було одразу завантажити після перезапуску.
|
||||
Коли `plugins.allow` уже налаштовано, `openclaw plugins install` додає
|
||||
ідентифікатор установленого плагіна до цього списку дозволених перед його ввімкненням, тож установлені плагіни
|
||||
можна відразу завантажувати після перезапуску.
|
||||
|
||||
`openclaw plugins update <id-or-npm-spec>` застосовується до відстежуваних встановлень. Передавання
|
||||
npm-специфікації пакета з dist-tag або точною версією зводить назву пакета
|
||||
назад до запису відстежуваного плагіна та зберігає нову специфікацію для майбутніх оновлень.
|
||||
Передавання назви пакета без версії повертає точно зафіксоване встановлення до
|
||||
типової лінії випусків реєстру. Якщо встановлений npm плагін уже відповідає
|
||||
розв’язаній версії та збереженій ідентичності артефакту, OpenClaw пропускає оновлення
|
||||
без завантаження, перевстановлення або перезапису конфігурації.
|
||||
`openclaw plugins update <id-or-npm-spec>` застосовується до відстежуваних установлень. Передавання
|
||||
специфікації пакета 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 <id>` також повідомляє про виявлені можливості набору, а також
|
||||
підтримувані й непідтримувані записи серверів 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) — сторонні добірки
|
||||
|
||||
Loading…
Reference in New Issue
Block a user