diff --git a/docs/uk/plugins/sdk-migration.md b/docs/uk/plugins/sdk-migration.md
index 0f06895c8..4ae62bc64 100644
--- a/docs/uk/plugins/sdk-migration.md
+++ b/docs/uk/plugins/sdk-migration.md
@@ -2,141 +2,103 @@
read_when:
- Ви бачите попередження OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED
- Ви бачите попередження OPENCLAW_EXTENSION_API_DEPRECATED
- - Ви оновлюєте плагін до сучасної архітектури плагінів
- - Ви підтримуєте зовнішній плагін OpenClaw
+ - Ви оновлюєте Plugin до сучасної архітектури плагінів
+ - Ви підтримуєте зовнішній Plugin OpenClaw
sidebarTitle: Migrate to SDK
-summary: Перейдіть зі застарілого шару зворотної сумісності на сучасний SDK плагінів
-title: Міграція SDK плагінів
+summary: Перейдіть із застарілого шару зворотної сумісності на сучасний Plugin SDK
+title: Міграція Plugin SDK
x-i18n:
- generated_at: "2026-04-09T00:38:49Z"
+ generated_at: "2026-04-17T02:05:21Z"
model: gpt-5.4
provider: openai
- source_hash: 60cbb6c8be30d17770887d490c14e3a4538563339a5206fb419e51e0558bbc07
+ source_hash: f0283f949eec358a12a0709db846cde2a1509f28e5c60db6e563cb8a540b979d
source_path: plugins/sdk-migration.md
workflow: 15
---
-# Міграція SDK плагінів
+# Міграція Plugin SDK
-OpenClaw перейшов від широкого шару зворотної сумісності до сучасної
-архітектури плагінів із цільовими документованими імпортами. Якщо ваш плагін
-було створено до появи нової архітектури, цей посібник допоможе вам
-виконати міграцію.
+OpenClaw перейшов від широкого шару зворотної сумісності до сучасної архітектури плагінів із цілеспрямованими, задокументованими імпортами. Якщо ваш Plugin було створено до появи нової архітектури, цей посібник допоможе вам виконати міграцію.
## Що змінюється
-Стара система плагінів надавала дві надто широкі поверхні, які дозволяли
-плагінам імпортувати будь-що потрібне з однієї точки входу:
+Стара система плагінів надавала дві надто широкі поверхні, які дозволяли плагінам імпортувати все необхідне з однієї точки входу:
-- **`openclaw/plugin-sdk/compat`** — один імпорт, який повторно експортував
- десятки допоміжних функцій. Його було запроваджено, щоб старіші плагіни на
- основі hooks продовжували працювати, поки будувалася нова архітектура
- плагінів.
-- **`openclaw/extension-api`** — міст, який надавав плагінам прямий доступ до
- допоміжних засобів на боці хоста, наприклад до вбудованого запускальника
- агента.
+- **`openclaw/plugin-sdk/compat`** — один імпорт, який реекспортував десятки допоміжних засобів. Його було запроваджено, щоб підтримувати роботу старіших плагінів на основі хуків, поки будувалася нова архітектура плагінів.
+- **`openclaw/extension-api`** — міст, який надавав плагінам прямий доступ до допоміжних засобів на боці хоста, таких як вбудований запускальник агентів.
-Обидві поверхні тепер **застарілі**. Вони все ще працюють під час виконання,
-але нові плагіни не повинні їх використовувати, а наявні плагіни мають
-перейти до наступного мажорного релізу, перш ніж їх буде вилучено.
+Обидві ці поверхні тепер **застарілі**. Вони все ще працюють під час виконання, але нові плагіни не повинні їх використовувати, а наявні плагіни слід мігрувати до того, як у наступному мажорному випуску їх буде видалено.
- Шар зворотної сумісності буде вилучено в одному з майбутніх мажорних
- релізів. Плагіни, які й надалі імпортують із цих поверхонь, перестануть
- працювати, коли це станеться.
+ Шар зворотної сумісності буде видалено в одному з майбутніх мажорних випусків.
+ Плагіни, які все ще імпортують із цих поверхонь, перестануть працювати, коли це станеться.
## Чому це змінилося
Старий підхід спричиняв проблеми:
-- **Повільний запуск** — імпорт однієї допоміжної функції завантажував десятки
- не пов’язаних між собою модулів
-- **Циклічні залежності** — широкі повторні експорти спрощували створення
- циклів імпорту
-- **Нечітка поверхня API** — не було способу визначити, які експорти є
- стабільними, а які внутрішніми
+- **Повільний запуск** — імпорт одного допоміжного засобу завантажував десятки не пов’язаних між собою модулів
+- **Циклічні залежності** — широкі реекспорти спрощували створення циклів імпорту
+- **Нечітка поверхня API** — не було способу зрозуміти, які експорти є стабільними, а які внутрішніми
-Сучасний SDK плагінів виправляє це: кожен шлях імпорту (`openclaw/plugin-sdk/\`)
-є невеликим самодостатнім модулем із чіткою метою та документованим контрактом.
+Сучасний Plugin SDK це виправляє: кожен шлях імпорту (`openclaw/plugin-sdk/\`) — це невеликий самодостатній модуль із чітким призначенням і задокументованим контрактом.
-Застарілі зручні seams провайдерів для вбудованих каналів також зникли.
-Імпорти на кшталт `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
-`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
-канальні branded helper seams та
-`openclaw/plugin-sdk/telegram-core` були приватними скороченнями монорепозиторію,
-а не стабільними контрактами плагінів. Натомість використовуйте вузькі
-загальні підшляхи SDK. Усередині робочого простору вбудованих плагінів
-залишайте допоміжні засоби, що належать провайдеру, у власному
-`api.ts` або `runtime-api.ts` цього плагіна.
+Застарілі зручні поверхні провайдерів для вбудованих каналів також зникли. Імпорти на кшталт `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, фірмові допоміжні поверхні каналів і `openclaw/plugin-sdk/telegram-core` були приватними скороченнями монорепозиторію, а не стабільними контрактами плагінів. Натомість використовуйте вузькі загальні підшляхи SDK. Усередині робочого простору вбудованих плагінів тримайте допоміжні засоби, що належать провайдеру, у власному `api.ts` або `runtime-api.ts` цього плагіна.
Поточні приклади вбудованих провайдерів:
-- Anthropic зберігає специфічні для Claude допоміжні засоби потоків у власному
- seam `api.ts` / `contract-api.ts`
-- OpenAI зберігає builder-и провайдерів, допоміжні засоби моделей за
- замовчуванням і builder-и realtime-провайдерів у власному `api.ts`
-- OpenRouter зберігає builder провайдера та допоміжні засоби
- онбордингу/конфігурації у власному `api.ts`
+- Anthropic зберігає допоміжні засоби потоків, специфічні для Claude, у власній поверхні `api.ts` / `contract-api.ts`
+- OpenAI зберігає конструктори провайдерів, допоміжні засоби для моделей за замовчуванням і конструктори realtime-провайдерів у власному `api.ts`
+- OpenRouter зберігає конструктор провайдера та допоміжні засоби для онбордингу/конфігурації у власному `api.ts`
## Як виконати міграцію
-
- Плагіни каналів із підтримкою схвалення тепер надають нативну поведінку
- схвалення через `approvalCapability.nativeRuntime` разом зі спільним
- реєстром контексту runtime.
+
+ Плагіни каналів із підтримкою затвердження тепер надають нативну поведінку затвердження через
+ `approvalCapability.nativeRuntime` разом зі спільним реєстром runtime-контексту.
- Основні зміни:
+ Ключові зміни:
- Замініть `approvalCapability.handler.loadRuntime(...)` на
`approvalCapability.nativeRuntime`
- - Перенесіть специфічні для схвалення auth/доставку зі застарілої
- прив’язки `plugin.auth` / `plugin.approvals` на `approvalCapability`
- - `ChannelPlugin.approvals` вилучено з публічного контракту channel-plugin;
- перемістіть поля delivery/native/render до `approvalCapability`
- - `plugin.auth` залишається лише для потоків входу/виходу каналу; hooks
- auth для схвалення там більше не зчитуються ядром
- - Реєструйте об’єкти runtime, що належать каналу, такі як клієнти, токени
- або застосунки Bolt, через `openclaw/plugin-sdk/channel-runtime-context`
- - Не надсилайте сповіщення про перенаправлення, що належать плагіну, з
- нативних обробників схвалення; ядро тепер саме володіє сповіщеннями
- про доставку в інше місце на основі фактичних результатів доставки
- - Під час передавання `channelRuntime` до `createChannelManager(...)`
- надавайте справжню поверхню `createPluginRuntime().channel`.
- Часткові заглушки відхиляються.
+ - Перенесіть авторизацію/доставку, специфічні для затверджень, зі застарілої зв’язки `plugin.auth` /
+ `plugin.approvals` на `approvalCapability`
+ - `ChannelPlugin.approvals` було видалено з публічного контракту плагіна каналу; перенесіть поля delivery/native/render до `approvalCapability`
+ - `plugin.auth` залишається лише для потоків входу/виходу каналу; хуки авторизації для затверджень там більше не зчитуються ядром
+ - Реєструйте об’єкти runtime, що належать каналу, як-от клієнти, токени або застосунки Bolt, через `openclaw/plugin-sdk/channel-runtime-context`
+ - Не надсилайте сповіщення про перенаправлення, що належать плагіну, з нативних обробників затвердження; тепер ядро саме відповідає за сповіщення про доставку в інше місце на основі фактичних результатів доставки
+ - Під час передавання `channelRuntime` до `createChannelManager(...)` надавайте реальну поверхню `createPluginRuntime().channel`. Часткові заглушки відхиляються.
- Актуальну структуру можливостей схвалення дивіться в
- `/plugins/sdk-channel-plugins`.
+ Актуальну структуру можливостей затвердження див. у `/plugins/sdk-channel-plugins`.
- Якщо ваш плагін використовує `openclaw/plugin-sdk/windows-spawn`, нерозв’язані
- wrapper-и Windows `.cmd`/`.bat` тепер завершуються із закритою відмовою,
- якщо ви явно не передасте `allowShellFallback: true`.
+ Якщо ваш Plugin використовує `openclaw/plugin-sdk/windows-spawn`, нерозпізнані Windows-обгортки `.cmd`/`.bat` тепер за замовчуванням завершуються без резервного сценарію, якщо ви явно не передасте
+ `allowShellFallback: true`.
```typescript
- // До
+ // Before
const program = applyWindowsSpawnProgramPolicy({ candidate });
- // Після
+ // After
const program = applyWindowsSpawnProgramPolicy({
candidate,
- // Установлюйте це лише для довірених сумісних викликів, які свідомо
- // допускають резервний перехід через shell.
+ // Only set this for trusted compatibility callers that intentionally
+ // accept shell-mediated fallback.
allowShellFallback: true,
});
```
- Якщо ваш виклик не покладається навмисно на резервний перехід через shell,
- не встановлюйте `allowShellFallback` і натомість обробляйте викинуту
- помилку.
+ Якщо ваш код навмисно не покладається на резервний сценарій через оболонку, не встановлюйте
+ `allowShellFallback`, а натомість обробляйте згенеровану помилку.
- Пошукайте у своєму плагіні імпорти з будь-якої із застарілих поверхонь:
+ Знайдіть у своєму Plugin імпорти з будь-якої із застарілих поверхонь:
```bash
grep -r "plugin-sdk/compat" my-plugin/
@@ -145,38 +107,35 @@ OpenClaw перейшов від широкого шару зворотної с
-
- Кожен експорт зі старої поверхні відповідає конкретному сучасному шляху
- імпорту:
+
+ Кожен експорт зі старої поверхні відповідає конкретному сучасному шляху імпорту:
```typescript
- // До (застарілий шар зворотної сумісності)
+ // Before (deprecated backwards-compatibility layer)
import {
createChannelReplyPipeline,
createPluginRuntimeStore,
resolveControlCommandGate,
} from "openclaw/plugin-sdk/compat";
- // Після (сучасні цільові імпорти)
+ // After (modern focused imports)
import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
```
- Для допоміжних засобів на боці хоста використовуйте впроваджений runtime
- плагіна замість прямого імпорту:
+ Для допоміжних засобів на боці хоста використовуйте впроваджений runtime плагіна замість прямого імпорту:
```typescript
- // До (застарілий міст extension-api)
+ // Before (deprecated extension-api bridge)
import { runEmbeddedPiAgent } from "openclaw/extension-api";
const result = await runEmbeddedPiAgent({ sessionId, prompt });
- // Після (впроваджений runtime)
+ // After (injected runtime)
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
```
- Той самий шаблон застосовується і до інших застарілих допоміжних засобів
- моста:
+ Той самий шаблон застосовується й до інших застарілих допоміжних засобів моста:
| Старий імпорт | Сучасний еквівалент |
| --- | --- |
@@ -200,63 +159,63 @@ OpenClaw перейшов від широкого шару зворотної с
## Довідник шляхів імпорту
-
+
| Шлях імпорту | Призначення | Ключові експорти |
| --- | --- | --- |
- | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб точки входу плагіна | `definePluginEntry` |
- | `plugin-sdk/core` | Застарілий umbrella re-export для визначень/builder-ів входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` |
+ | `plugin-sdk/plugin-entry` | Канонічний допоміжний засіб точки входу Plugin | `definePluginEntry` |
+ | `plugin-sdk/core` | Застарілий узагальнений реекспорт для визначень/конструкторів точок входу каналів | `defineChannelPluginEntry`, `createChatChannelPlugin` |
| `plugin-sdk/config-schema` | Експорт кореневої схеми конфігурації | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | Допоміжний засіб точки входу для одного провайдера | `defineSingleProviderPluginEntry` |
- | `plugin-sdk/channel-core` | Цільові визначення та builder-и входу каналів | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
- | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Запити allowlist, builder-и стану налаштування |
- | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime під час налаштування | Безпечні для імпорту setup patch adapters, допоміжні засоби приміток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, проксі делегованого налаштування |
- | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби adapter налаштування | `createEnvPatchedAccountSetupAdapter` |
+ | `plugin-sdk/channel-core` | Цілеспрямовані визначення та конструктори точок входу каналів | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
+ | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування | Запити allowlist, конструктори статусу налаштування |
+ | `plugin-sdk/setup-runtime` | Допоміжні засоби runtime для етапу налаштування | Безпечні для імпорту адаптери patch для налаштування, допоміжні засоби приміток пошуку, `promptResolvedAllowFrom`, `splitSetupEntries`, делеговані проксі налаштування |
+ | `plugin-sdk/setup-adapter-runtime` | Допоміжні засоби адаптера налаштування | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | Допоміжні засоби інструментів налаштування | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби списків/config/action-gate облікових записів |
- | `plugin-sdk/account-id` | Допоміжні засоби account-id | `DEFAULT_ACCOUNT_ID`, нормалізація account-id |
- | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікових записів | Допоміжні засоби пошуку облікових записів + fallback за замовчуванням |
- | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для облікових записів | Допоміжні засоби списку облікових записів/дій з обліковими записами |
+ | `plugin-sdk/account-core` | Допоміжні засоби для кількох облікових записів | Допоміжні засоби для списку/конфігурації/шлюзу дій облікових записів |
+ | `plugin-sdk/account-id` | Допоміжні засоби для ідентифікатора облікового запису | `DEFAULT_ACCOUNT_ID`, нормалізація ідентифікатора облікового запису |
+ | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису | Допоміжні засоби пошуку облікового запису + резервного вибору за замовчуванням |
+ | `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для облікових записів | Допоміжні засоби для списку облікових записів/дій із ними |
| `plugin-sdk/channel-setup` | Адаптери майстра налаштування | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
- | `plugin-sdk/channel-pairing` | Примітиви DM-поєднання | `createChannelPairingController` |
- | `plugin-sdk/channel-reply-pipeline` | Префікс відповіді + прив’язка typing | `createChannelReplyPipeline` |
+ | `plugin-sdk/channel-pairing` | Примітиви DM-парування | `createChannelPairingController` |
+ | `plugin-sdk/channel-reply-pipeline` | Префікс відповіді + зв’язування набору тексту | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | Фабрики адаптерів конфігурації | `createHybridChannelConfigAdapter` |
- | `plugin-sdk/channel-config-schema` | Builder-и схем конфігурації | Типи схем конфігурації каналів |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби конфігурації команд Telegram | Нормалізація назв команд, обрізання описів, валідація дублікатів/конфліктів |
+ | `plugin-sdk/channel-config-schema` | Конструктори схем конфігурації | Типи схем конфігурації каналу |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби конфігурації команд Telegram | Нормалізація назв команд, обрізання описів, перевірка дублікатів/конфліктів |
| `plugin-sdk/channel-policy` | Визначення політики груп/DM | `resolveChannelGroupRequireMention` |
- | `plugin-sdk/channel-lifecycle` | Відстеження стану облікових записів | `createAccountStatusSink` |
- | `plugin-sdk/inbound-envelope` | Допоміжні засоби вхідних envelope | Спільні допоміжні засоби route + builder-ів envelope |
- | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби вхідних відповідей | Спільні допоміжні засоби запису та dispatch |
- | `plugin-sdk/messaging-targets` | Розбір цілей повідомлень | Допоміжні засоби розбору/зіставлення цілей |
+ | `plugin-sdk/channel-lifecycle` | Відстеження статусу облікового запису | `createAccountStatusSink` |
+ | `plugin-sdk/inbound-envelope` | Допоміжні засоби вхідного конверта | Спільні допоміжні засоби маршрутизації та побудови конверта |
+ | `plugin-sdk/inbound-reply-dispatch` | Допоміжні засоби вхідної відповіді | Спільні допоміжні засоби запису та диспетчеризації |
+ | `plugin-sdk/messaging-targets` | Аналіз цілей повідомлень | Допоміжні засоби аналізу/зіставлення цілей |
| `plugin-sdk/outbound-media` | Допоміжні засоби вихідних медіа | Спільне завантаження вихідних медіа |
- | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідного runtime | Допоміжні засоби outbound identity/send delegate |
- | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби прив’язок потоків | Допоміжні засоби життєвого циклу прив’язок потоків та adapter |
- | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби media payload | Builder agent media payload для застарілих макетів полів |
- | `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти channel runtime |
- | `plugin-sdk/channel-send-result` | Типи результатів надсилання | Типи результатів відповідей |
- | `plugin-sdk/runtime-store` | Постійне сховище плагінів | `createPluginRuntimeStore` |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/logging/backup/встановлення плагінів |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env | Logger/runtime env, допоміжні засоби timeout, retry та backoff |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime плагінів | Допоміжні засоби команд/hooks/http/interactive плагіна |
- | `plugin-sdk/hook-runtime` | Допоміжні засоби pipeline hooks | Спільні допоміжні засоби pipeline webhook/internal hook |
- | `plugin-sdk/lazy-runtime` | Допоміжні засоби ледачого runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
+ | `plugin-sdk/outbound-runtime` | Допоміжні засоби вихідного runtime | Допоміжні засоби для вихідної ідентичності/делегатів надсилання |
+ | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби прив’язки потоків | Допоміжні засоби життєвого циклу та адаптерів прив’язки потоків |
+ | `plugin-sdk/agent-media-payload` | Застарілі допоміжні засоби payload медіа агента | Конструктор payload медіа агента для застарілих схем полів |
+ | `plugin-sdk/channel-runtime` | Застарілий shim сумісності | Лише застарілі утиліти runtime каналу |
+ | `plugin-sdk/channel-send-result` | Типи результатів надсилання | Типи результатів відповіді |
+ | `plugin-sdk/runtime-store` | Постійне сховище Plugin | `createPluginRuntimeStore` |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime | Допоміжні засоби runtime/логування/резервного копіювання/встановлення плагінів |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби середовища runtime | Допоміжні засоби логера/середовища runtime, timeout, retry та backoff |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби runtime Plugin | Допоміжні засоби команд/хуків/http/інтерактивності плагіна |
+ | `plugin-sdk/hook-runtime` | Допоміжні засоби конвеєра хуків | Спільні допоміжні засоби конвеєра Webhook/внутрішніх хуків |
+ | `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Допоміжні засоби процесів | Спільні допоміжні засоби exec |
| `plugin-sdk/cli-runtime` | Допоміжні засоби CLI runtime | Форматування команд, очікування, допоміжні засоби версій |
- | `plugin-sdk/gateway-runtime` | Допоміжні засоби gateway | Допоміжні засоби клієнта gateway і patch-ів стану каналів |
+ | `plugin-sdk/gateway-runtime` | Допоміжні засоби Gateway | Клієнт Gateway і допоміжні засоби patch статусу каналу |
| `plugin-sdk/config-runtime` | Допоміжні засоби конфігурації | Допоміжні засоби завантаження/запису конфігурації |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Допоміжні засоби валідації команд Telegram зі стабільним fallback, коли поверхня контракту вбудованого Telegram недоступна |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби запитів схвалення | Payload схвалення exec/plugin, допоміжні засоби capability/profile схвалення, допоміжні засоби маршрутизації/runtime нативного схвалення |
- | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби auth схвалення | Визначення approver, auth дій у тому самому чаті |
- | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта схвалення | Допоміжні засоби profile/filter нативного exec-схвалення |
- | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки схвалення | Адаптери можливостей/доставки нативного схвалення |
- | `plugin-sdk/approval-gateway-runtime` | Допоміжні засоби gateway схвалення | Спільний допоміжний засіб визначення gateway схвалення |
- | `plugin-sdk/approval-handler-adapter-runtime` | Допоміжні засоби adapter схвалення | Полегшені допоміжні засоби завантаження adapter-ів нативного схвалення для гарячих точок входу каналів |
- | `plugin-sdk/approval-handler-runtime` | Допоміжні засоби обробників схвалення | Ширші допоміжні засоби runtime обробників схвалення; віддавайте перевагу вужчим seams adapter/gateway, коли їх достатньо |
- | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілей схвалення | Допоміжні засоби нативної прив’язки цілі/облікового запису схвалення |
- | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби відповідей на схвалення | Допоміжні засоби payload відповіді для exec/plugin схвалення |
- | `plugin-sdk/channel-runtime-context` | Допоміжні засоби контексту runtime каналу | Узагальнені допоміжні засоби register/get/watch для контексту runtime каналу |
- | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту та збирання секретів |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби команд Telegram | Допоміжні засоби перевірки команд Telegram зі стабільним резервним механізмом, коли поверхня контракту вбудованого Telegram недоступна |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби запитів на затвердження | Payload затвердження exec/Plugin, допоміжні засоби можливостей/профілів затвердження, нативні допоміжні засоби маршрутизації/runtime затвердження |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби авторизації затвердження | Визначення затверджувача, авторизація дій у тому самому чаті |
+ | `plugin-sdk/approval-client-runtime` | Допоміжні засоби клієнта затвердження | Допоміжні засоби профілю/фільтра нативного затвердження exec |
+ | `plugin-sdk/approval-delivery-runtime` | Допоміжні засоби доставки затвердження | Адаптери можливостей/доставки нативного затвердження |
+ | `plugin-sdk/approval-gateway-runtime` | Допоміжні засоби Gateway затвердження | Спільний допоміжний засіб визначення Gateway затвердження |
+ | `plugin-sdk/approval-handler-adapter-runtime` | Допоміжні засоби адаптера затвердження | Полегшені допоміжні засоби завантаження адаптера нативного затвердження для гарячих точок входу каналу |
+ | `plugin-sdk/approval-handler-runtime` | Допоміжні засоби обробника затвердження | Ширші допоміжні засоби runtime обробника затвердження; віддавайте перевагу вужчим поверхням adapter/gateway, коли їх достатньо |
+ | `plugin-sdk/approval-native-runtime` | Допоміжні засоби цілі затвердження | Допоміжні засоби нативного затвердження для прив’язки цілі/облікового запису |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби відповіді на затвердження | Допоміжні засоби payload відповіді на затвердження exec/Plugin |
+ | `plugin-sdk/channel-runtime-context` | Допоміжні засоби runtime-context каналу | Загальні допоміжні засоби register/get/watch для runtime-context каналу |
+ | `plugin-sdk/security-runtime` | Допоміжні засоби безпеки | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту та збору секретів |
| `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF | Допоміжні засоби allowlist хостів і політики приватної мережі |
- | `plugin-sdk/ssrf-runtime` | Допоміжні засоби SSRF runtime | Pinned-dispatcher, guarded fetch, допоміжні засоби політики SSRF |
+ | `plugin-sdk/ssrf-runtime` | Допоміжні засоби SSRF runtime | Допоміжні засоби pinned-dispatcher, guarded fetch, політики SSRF |
| `plugin-sdk/collection-runtime` | Допоміжні засоби обмеженого кешу | `pruneMapToMaxSize` |
| `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичного gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
| `plugin-sdk/error-runtime` | Допоміжні засоби форматування помилок | `formatUncaughtError`, `isApprovalNotFoundError`, допоміжні засоби графа помилок |
@@ -264,121 +223,119 @@ OpenClaw перейшов від широкого шару зворотної с
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації хоста | `normalizeHostname`, `normalizeScpRemoteHost` |
| `plugin-sdk/retry-runtime` | Допоміжні засоби retry | `RetryConfig`, `retryAsync`, виконавці політик |
| `plugin-sdk/allow-from` | Форматування allowlist | `formatAllowFromLowercase` |
- | `plugin-sdk/allowlist-resolution` | Мапування вводу allowlist | `mapAllowlistResolutionInputs` |
- | `plugin-sdk/command-auth` | Допоміжні засоби gating команд і поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд |
- | `plugin-sdk/command-status` | Рендерери стану/довідки команд | `buildCommandsMessage`, `buildCommandsMessagePaginated`, `buildHelpMessage` |
- | `plugin-sdk/secret-input` | Розбір вводу секретів | Допоміжні засоби вводу секретів |
- | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів webhook | Утиліти цілей webhook |
- | `plugin-sdk/webhook-request-guards` | Допоміжні засоби guards для тіла webhook | Допоміжні засоби читання/обмеження тіла запиту |
- | `plugin-sdk/reply-runtime` | Спільний runtime відповідей | Вхідний dispatch, heartbeat, планувальник відповідей, chunking |
- | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch відповідей | Допоміжні засоби finalize + dispatch провайдера |
+ | `plugin-sdk/allowlist-resolution` | Мапування вхідних даних allowlist | `mapAllowlistResolutionInputs` |
+ | `plugin-sdk/command-auth` | Gating команд і допоміжні засоби поверхні команд | `resolveControlCommandGate`, допоміжні засоби авторизації відправника, допоміжні засоби реєстру команд |
+ | `plugin-sdk/command-status` | Рендерери статусу/довідки команд | `buildCommandsMessage`, `buildCommandsMessagePaginated`, `buildHelpMessage` |
+ | `plugin-sdk/secret-input` | Аналіз введення секретів | Допоміжні засоби введення секретів |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів Webhook | Утиліти цілей Webhook |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби захисту тіла запиту Webhook | Допоміжні засоби читання/обмеження тіла запиту |
+ | `plugin-sdk/reply-runtime` | Спільний runtime відповіді | Вхідна диспетчеризація, Heartbeat, планувальник відповіді, chunking |
+ | `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби диспетчеризації відповіді | Допоміжні засоби фіналізації + диспетчеризації провайдера |
| `plugin-sdk/reply-history` | Допоміжні засоби історії відповідей | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
- | `plugin-sdk/reply-reference` | Планування посилань у відповідях | `createReplyReferencePlanner` |
- | `plugin-sdk/reply-chunking` | Допоміжні засоби chunk відповідей | Допоміжні засоби chunking тексту/markdown |
+ | `plugin-sdk/reply-reference` | Планування посилань на відповіді | `createReplyReferencePlanner` |
+ | `plugin-sdk/reply-chunking` | Допоміжні засоби chunk відповіді | Допоміжні засоби chunking тексту/markdown |
| `plugin-sdk/session-store-runtime` | Допоміжні засоби сховища сесій | Допоміжні засоби шляху сховища + updated-at |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів стану та OAuth |
- | `plugin-sdk/routing` | Допоміжні засоби маршрутизації/ключів сесій | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації ключів сесій |
- | `plugin-sdk/status-helpers` | Допоміжні засоби стану каналів | Builder-и зведення стану каналів/облікових записів, значення runtime-state за замовчуванням, допоміжні засоби метаданих проблем |
- | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби визначення цілей | Спільні допоміжні засоби target resolver |
+ | `plugin-sdk/state-paths` | Допоміжні засоби шляхів стану | Допоміжні засоби каталогів стану й OAuth |
+ | `plugin-sdk/routing` | Допоміжні засоби маршрутизації/ключа сесії | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, допоміжні засоби нормалізації ключа сесії |
+ | `plugin-sdk/status-helpers` | Допоміжні засоби статусу каналу | Конструктори підсумків статусу каналу/облікового запису, значення за замовчуванням для runtime-стану, допоміжні засоби метаданих проблем |
+ | `plugin-sdk/target-resolver-runtime` | Допоміжні засоби визначення цілі | Спільні допоміжні засоби визначення цілі |
| `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації рядків | Допоміжні засоби нормалізації slug/рядків |
- | `plugin-sdk/request-url` | Допоміжні засоби URL запитів | Витяг рядкових URL із вхідних даних, схожих на запит |
+ | `plugin-sdk/request-url` | Допоміжні засоби URL запиту | Витягування рядкових URL із вхідних даних, подібних до request |
| `plugin-sdk/run-command` | Допоміжні засоби команд із таймером | Виконавець команд із нормалізованими stdout/stderr |
| `plugin-sdk/param-readers` | Зчитувачі параметрів | Поширені зчитувачі параметрів інструментів/CLI |
- | `plugin-sdk/tool-payload` | Витяг payload інструментів | Витяг нормалізованих payload із об’єктів результатів інструментів |
- | `plugin-sdk/tool-send` | Витяг надсилання інструментів | Витяг канонічних полів цілі надсилання з аргументів інструментів |
- | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби шляхів тимчасових завантажень |
- | `plugin-sdk/logging-core` | Допоміжні засоби логування | Логер підсистеми та допоміжні засоби редагування чутливих даних |
- | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби таблиць markdown | Допоміжні засоби режиму таблиць markdown |
- | `plugin-sdk/reply-payload` | Типи відповідей повідомлень | Типи payload відповідей |
+ | `plugin-sdk/tool-payload` | Витягування payload інструмента | Витягування нормалізованих payload з об’єктів результатів інструментів |
+ | `plugin-sdk/tool-send` | Витягування надсилання інструмента | Витягування канонічних полів цілі надсилання з аргументів інструмента |
+ | `plugin-sdk/temp-path` | Допоміжні засоби тимчасових шляхів | Спільні допоміжні засоби шляхів тимчасового завантаження |
+ | `plugin-sdk/logging-core` | Допоміжні засоби логування | Допоміжні засоби логера підсистеми та редагування чутливих даних |
+ | `plugin-sdk/markdown-table-runtime` | Допоміжні засоби markdown-таблиць | Допоміжні засоби режиму markdown-таблиць |
+ | `plugin-sdk/reply-payload` | Типи відповідей повідомлень | Типи payload відповіді |
| `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів | Допоміжні засоби виявлення/конфігурації self-hosted провайдерів |
- | `plugin-sdk/self-hosted-provider-setup` | Цільові допоміжні засоби налаштування OpenAI-compatible self-hosted провайдерів | Ті самі допоміжні засоби виявлення/конфігурації self-hosted провайдерів |
- | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби runtime auth провайдерів | Допоміжні засоби визначення API-ключів під час виконання |
- | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-ключів провайдера | Допоміжні засоби онбордингу/запису профілю API-ключів |
- | `plugin-sdk/provider-auth-result` | Допоміжні засоби результатів auth провайдера | Стандартний builder auth-result для OAuth |
+ | `plugin-sdk/self-hosted-provider-setup` | Цілеспрямовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI | Ті самі допоміжні засоби виявлення/конфігурації self-hosted провайдерів |
+ | `plugin-sdk/provider-auth-runtime` | Допоміжні засоби runtime-авторизації провайдера | Допоміжні засоби визначення API-ключа під час runtime |
+ | `plugin-sdk/provider-auth-api-key` | Допоміжні засоби налаштування API-ключа провайдера | Допоміжні засоби онбордингу/запису профілю API-ключа |
+ | `plugin-sdk/provider-auth-result` | Допоміжні засоби результату авторизації провайдера | Стандартний конструктор результату OAuth-авторизації |
| `plugin-sdk/provider-auth-login` | Допоміжні засоби інтерактивного входу провайдера | Спільні допоміжні засоби інтерактивного входу |
- | `plugin-sdk/provider-env-vars` | Допоміжні засоби env vars провайдерів | Допоміжні засоби пошуку env vars auth провайдера |
- | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделей/replay провайдерів | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні builder-и політик replay, допоміжні засоби endpoint провайдера та нормалізації model-id |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби env vars провайдера | Допоміжні засоби пошуку env vars авторизації провайдера |
+ | `plugin-sdk/provider-model-shared` | Спільні допоміжні засоби моделей/повторного відтворення провайдера | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політики повторного відтворення, допоміжні засоби endpoint провайдера та нормалізації model-id |
| `plugin-sdk/provider-catalog-shared` | Спільні допоміжні засоби каталогу провайдерів | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-onboard` | Патчі онбордингу провайдерів | Допоміжні засоби конфігурації онбордингу |
- | `plugin-sdk/provider-http` | Допоміжні засоби HTTP провайдерів | Загальні допоміжні засоби HTTP/можливостей endpoint провайдерів |
- | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch провайдерів | Допоміжні засоби реєстрації/кешу провайдерів web-fetch |
- | `plugin-sdk/provider-web-search-config-contract` | Допоміжні засоби конфігурації веб-пошуку провайдерів | Вузькі допоміжні засоби конфігурації/облікових даних веб-пошуку для провайдерів, яким не потрібна прив’язка ввімкнення плагіна |
- | `plugin-sdk/provider-web-search-contract` | Допоміжні засоби контракту веб-пошуку провайдерів | Вузькі допоміжні засоби контракту конфігурації/облікових даних веб-пошуку, як-от `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setter/getter-и облікових даних |
- | `plugin-sdk/provider-web-search` | Допоміжні засоби веб-пошуку провайдерів | Допоміжні засоби реєстрації/кешу/runtime провайдерів веб-пошуку |
- | `plugin-sdk/provider-tools` | Допоміжні засоби сумісності інструментів/схем провайдерів | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні засоби сумісності xAI, як-от `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
- | `plugin-sdk/provider-usage` | Допоміжні засоби використання провайдерів | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання провайдерів |
- | `plugin-sdk/provider-stream` | Допоміжні засоби обгорток потоків провайдерів | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
- | `plugin-sdk/keyed-async-queue` | Впорядкована async-черга | `KeyedAsyncQueue` |
- | `plugin-sdk/media-runtime` | Спільні допоміжні засоби медіа | Допоміжні засоби fetch/transform/store медіа, а також builder-и media payload |
- | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації медіа | Спільні допоміжні засоби failover, вибору кандидатів і повідомлень про відсутні моделі для генерації зображень/відео/музики |
- | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи провайдерів media-understanding, а також provider-facing експорти допоміжних засобів зображень/аудіо |
- | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту | Видалення тексту, видимого асистенту, допоміжні засоби render/chunking/table markdown, редагування чутливих даних, допоміжні засоби тегів директив, безпечного тексту та пов’язані допоміжні засоби тексту/логування |
+ | `plugin-sdk/provider-onboard` | Патчі онбордингу провайдера | Допоміжні засоби конфігурації онбордингу |
+ | `plugin-sdk/provider-http` | Допоміжні засоби HTTP провайдера | Загальні допоміжні засоби HTTP/можливостей endpoint провайдера |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби web-fetch провайдера | Допоміжні засоби реєстрації/кешу провайдера web-fetch |
+ | `plugin-sdk/provider-web-search-config-contract` | Допоміжні засоби конфігурації web-search провайдера | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне зв’язування ввімкнення плагіна |
+ | `plugin-sdk/provider-web-search-contract` | Допоміжні засоби контракту web-search провайдера | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped-сетери/гетери облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби web-search провайдера | Допоміжні засоби реєстрації/кешу/runtime провайдера web-search |
+ | `plugin-sdk/provider-tools` | Допоміжні засоби compat для інструментів/схем провайдера | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні засоби compat для xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-usage` | Допоміжні засоби використання провайдера | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` та інші допоміжні засоби використання провайдера |
+ | `plugin-sdk/provider-stream` | Допоміжні засоби обгортки потоку провайдера | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/keyed-async-queue` | Упорядкована асинхронна черга | `KeyedAsyncQueue` |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби медіа | Допоміжні засоби отримання/перетворення/зберігання медіа, а також конструктори payload медіа |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби генерації медіа | Спільні допоміжні засоби failover, вибору кандидатів і повідомлень про відсутню модель для генерації зображень/відео/музики |
+ | `plugin-sdk/media-understanding` | Допоміжні засоби media-understanding | Типи провайдерів media understanding, а також експорти допоміжних засобів зображення/аудіо для провайдерів |
+ | `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту | Видалення видимого для помічника тексту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування чутливих даних, допоміжні засоби тегів директив, утиліти безпечного тексту та пов’язані допоміжні засоби тексту/логування |
| `plugin-sdk/text-chunking` | Допоміжні засоби chunking тексту | Допоміжний засіб chunking вихідного тексту |
- | `plugin-sdk/speech` | Допоміжні засоби мовлення | Типи speech-провайдерів, а також provider-facing допоміжні засоби директив, реєстру та валідації |
- | `plugin-sdk/speech-core` | Спільне ядро мовлення | Типи speech-провайдерів, реєстр, директиви, нормалізація |
- | `plugin-sdk/realtime-transcription` | Допоміжні засоби realtime transcription | Типи провайдерів і допоміжні засоби реєстру |
- | `plugin-sdk/realtime-voice` | Допоміжні засоби realtime voice | Типи провайдерів і допоміжні засоби реєстру |
- | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Типи генерації зображень, failover, auth і допоміжні засоби реєстру |
- | `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи провайдерів/запитів/результатів генерації музики |
- | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, пошуку провайдерів і розбору model-ref |
- | `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи провайдерів/запитів/результатів генерації відео |
- | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, пошуку провайдерів і розбору model-ref |
- | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивних відповідей | Нормалізація/зведення payload інтерактивних відповідей |
- | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналів | Вузькі примітиви channel config-schema |
- | `plugin-sdk/channel-config-writes` | Допоміжні засоби запису конфігурації каналів | Допоміжні засоби авторизації запису конфігурації каналів |
- | `plugin-sdk/channel-plugin-common` | Спільна преамбула каналів | Експорти спільної преамбули плагінів каналів |
- | `plugin-sdk/channel-status` | Допоміжні засоби стану каналів | Спільні допоміжні засоби snapshot/summary стану каналів |
+ | `plugin-sdk/speech` | Допоміжні засоби мовлення | Типи провайдерів мовлення, а також допоміжні засоби директив, реєстру та валідації для провайдерів |
+ | `plugin-sdk/speech-core` | Спільне ядро мовлення | Типи провайдерів мовлення, реєстр, директиви, нормалізація |
+ | `plugin-sdk/realtime-transcription` | Допоміжні засоби транскрипції в реальному часі | Типи провайдерів і допоміжні засоби реєстру |
+ | `plugin-sdk/realtime-voice` | Допоміжні засоби голосу в реальному часі | Типи провайдерів і допоміжні засоби реєстру |
+ | `plugin-sdk/image-generation-core` | Спільне ядро генерації зображень | Типи генерації зображень, допоміжні засоби failover, авторизації та реєстру |
+ | `plugin-sdk/music-generation` | Допоміжні засоби генерації музики | Типи провайдера/запиту/результату генерації музики |
+ | `plugin-sdk/music-generation-core` | Спільне ядро генерації музики | Типи генерації музики, допоміжні засоби failover, пошук провайдера та розбір model-ref |
+ | `plugin-sdk/video-generation` | Допоміжні засоби генерації відео | Типи провайдера/запиту/результату генерації відео |
+ | `plugin-sdk/video-generation-core` | Спільне ядро генерації відео | Типи генерації відео, допоміжні засоби failover, пошук провайдера та розбір model-ref |
+ | `plugin-sdk/interactive-runtime` | Допоміжні засоби інтерактивної відповіді | Нормалізація/зведення payload інтерактивної відповіді |
+ | `plugin-sdk/channel-config-primitives` | Примітиви конфігурації каналу | Вузькі примітиви config-schema каналу |
+ | `plugin-sdk/channel-config-writes` | Допоміжні засоби запису конфігурації каналу | Допоміжні засоби авторизації запису конфігурації каналу |
+ | `plugin-sdk/channel-plugin-common` | Спільна преамбула каналу | Спільні експорти преамбули плагіна каналу |
+ | `plugin-sdk/channel-status` | Допоміжні засоби статусу каналу | Спільні допоміжні засоби snapshot/summary статусу каналу |
| `plugin-sdk/allowlist-config-edit` | Допоміжні засоби конфігурації allowlist | Допоміжні засоби редагування/читання конфігурації allowlist |
- | `plugin-sdk/group-access` | Допоміжні засоби доступу до груп | Спільні допоміжні засоби рішень щодо group-access |
- | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби auth/guard для direct-DM |
- | `plugin-sdk/extension-shared` | Спільні допоміжні засоби розширень | Примітиви пасивних каналів/стану та ambient proxy helper |
- | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей webhook | Реєстр цілей webhook і допоміжні засоби встановлення маршрутів |
- | `plugin-sdk/webhook-path` | Допоміжні засоби шляхів webhook | Допоміжні засоби нормалізації шляхів webhook |
+ | `plugin-sdk/group-access` | Допоміжні засоби доступу до груп | Спільні допоміжні засоби визначення доступу до груп |
+ | `plugin-sdk/direct-dm` | Допоміжні засоби direct-DM | Спільні допоміжні засоби авторизації/захисту direct-DM |
+ | `plugin-sdk/extension-shared` | Спільні допоміжні засоби розширень | Примітиви допоміжних засобів passive-channel/status і ambient proxy |
+ | `plugin-sdk/webhook-targets` | Допоміжні засоби цілей Webhook | Реєстр цілей Webhook і допоміжні засоби встановлення маршрутів |
+ | `plugin-sdk/webhook-path` | Допоміжні засоби шляху Webhook | Допоміжні засоби нормалізації шляху Webhook |
| `plugin-sdk/web-media` | Спільні допоміжні засоби вебмедіа | Допоміжні засоби завантаження віддалених/локальних медіа |
- | `plugin-sdk/zod` | Повторний експорт Zod | Повторно експортований `zod` для споживачів SDK плагінів |
- | `plugin-sdk/memory-core` | Допоміжні засоби вбудованого memory-core | Поверхня допоміжних засобів memory manager/config/file/CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія пам’яті | Фасад runtime індексу/пошуку пам’яті |
- | `plugin-sdk/memory-core-host-engine-foundation` | Foundation engine хоста пам’яті | Експорти foundation engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Embedding engine хоста пам’яті | Експорти embedding engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-qmd` | QMD engine хоста пам’яті | Експорти QMD engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-storage` | Storage engine хоста пам’яті | Експорти storage engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста пам’яті | Допоміжні засоби multimodal хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query хоста пам’яті | Допоміжні засоби query хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті | Допоміжні засоби secret хоста пам’яті |
- | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті | Допоміжні засоби журналу подій хоста пам’яті |
- | `plugin-sdk/memory-core-host-status` | Допоміжні засоби стану хоста пам’яті | Допоміжні засоби стану хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime хоста пам’яті | Допоміжні засоби CLI runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-core` | Core runtime хоста пам’яті | Допоміжні засоби core runtime хоста пам’яті |
- | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті | Допоміжні засоби файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Псевдонім core runtime хоста пам’яті | Вендорно-нейтральний псевдонім для допоміжних засобів core runtime хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Псевдонім журналу подій хоста пам’яті | Вендорно-нейтральний псевдонім для допоміжних засобів журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime хоста пам’яті | Вендорно-нейтральний псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого markdown | Спільні допоміжні засоби керованого markdown для суміжних із пам’яттю плагінів |
- | `plugin-sdk/memory-host-search` | Фасад пошуку активної пам’яті | Ледачий фасад runtime менеджера пошуку активної пам’яті |
- | `plugin-sdk/memory-host-status` | Псевдонім стану хоста пам’яті | Вендорно-нейтральний псевдонім для допоміжних засобів стану хоста пам’яті |
- | `plugin-sdk/memory-lancedb` | Допоміжні засоби вбудованого memory-lancedb | Поверхня допоміжних засобів memory-lancedb |
+ | `plugin-sdk/zod` | Реекспорт zod | Реекспортований `zod` для споживачів Plugin SDK |
+ | `plugin-sdk/memory-core` | Вбудовані допоміжні засоби memory-core | Поверхня допоміжних засобів менеджера memory/config/file/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime рушія memory | Фасад runtime індексації/пошуку memory |
+ | `plugin-sdk/memory-core-host-engine-foundation` | Базовий рушій хоста memory | Експорти базового рушія хоста memory |
+ | `plugin-sdk/memory-core-host-engine-embeddings` | Рушій embedding хоста memory | Контракти embedding memory, доступ до реєстру, локальний провайдер і загальні допоміжні засоби batch/remote; конкретні remote-провайдери знаходяться у своїх відповідних плагінах |
+ | `plugin-sdk/memory-core-host-engine-qmd` | Рушій QMD хоста memory | Експорти рушія QMD хоста memory |
+ | `plugin-sdk/memory-core-host-engine-storage` | Рушій сховища хоста memory | Експорти рушія сховища хоста memory |
+ | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні допоміжні засоби хоста memory | Мультимодальні допоміжні засоби хоста memory |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста memory | Допоміжні засоби запитів хоста memory |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста memory | Допоміжні засоби секретів хоста memory |
+ | `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста memory | Допоміжні засоби журналу подій хоста memory |
+ | `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста memory | Допоміжні засоби статусу хоста memory |
+ | `plugin-sdk/memory-core-host-runtime-cli` | CLI runtime хоста memory | Допоміжні засоби CLI runtime хоста memory |
+ | `plugin-sdk/memory-core-host-runtime-core` | Основний runtime хоста memory | Допоміжні засоби основного runtime хоста memory |
+ | `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста memory | Допоміжні засоби файлів/runtime хоста memory |
+ | `plugin-sdk/memory-host-core` | Псевдонім основного runtime хоста memory | Нейтральний до постачальника псевдонім для допоміжних засобів основного runtime хоста memory |
+ | `plugin-sdk/memory-host-events` | Псевдонім журналу подій хоста memory | Нейтральний до постачальника псевдонім для допоміжних засобів журналу подій хоста memory |
+ | `plugin-sdk/memory-host-files` | Псевдонім файлів/runtime хоста memory | Нейтральний до постачальника псевдонім для допоміжних засобів файлів/runtime хоста memory |
+ | `plugin-sdk/memory-host-markdown` | Допоміжні засоби керованого markdown | Спільні допоміжні засоби керованого markdown для плагінів, суміжних із memory |
+ | `plugin-sdk/memory-host-search` | Фасад пошуку Active Memory | Лінивий фасад runtime менеджера пошуку active-memory |
+ | `plugin-sdk/memory-host-status` | Псевдонім статусу хоста memory | Нейтральний до постачальника псевдонім для допоміжних засобів статусу хоста memory |
+ | `plugin-sdk/memory-lancedb` | Вбудовані допоміжні засоби memory-lancedb | Поверхня допоміжних засобів memory-lancedb |
| `plugin-sdk/testing` | Утиліти тестування | Допоміжні засоби тестування та mock-об’єкти |
-Ця таблиця навмисно охоплює лише поширену підмножину для міграції, а не всю
-поверхню SDK. Повний список із понад 200 точок входу міститься у
+Ця таблиця навмисно є поширеною підмножиною для міграції, а не повною
+поверхнею SDK. Повний список із понад 200 точок входу міститься в
`scripts/lib/plugin-sdk-entrypoints.json`.
-Цей список усе ще містить деякі seams допоміжних засобів вбудованих плагінів,
-такі як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
-`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й надалі експортуються
-для підтримки вбудованих плагінів і сумісності, але навмисно не включені до
-таблиці поширеної міграції та не є рекомендованою ціллю для нового коду
-плагінів.
+Цей список усе ще включає деякі допоміжні поверхні вбудованих плагінів, як-от
+`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
+`plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Вони й надалі експортуються для
+підтримки вбудованих плагінів і сумісності, але навмисно опущені з таблиці
+поширеної міграції та не є рекомендованою ціллю для нового коду плагінів.
-Те саме правило стосується й інших сімейств вбудованих допоміжних засобів,
-таких як:
+Те саме правило застосовується до інших сімейств вбудованих допоміжних засобів, таких як:
- допоміжні засоби підтримки браузера: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
- Matrix: `plugin-sdk/matrix*`
- LINE: `plugin-sdk/line*`
- IRC: `plugin-sdk/irc*`
-- поверхні вбудованих helper/plugin, такі як `plugin-sdk/googlechat`,
+- вбудовані допоміжні поверхні/поверхні плагінів, як-от `plugin-sdk/googlechat`,
`plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`,
`plugin-sdk/mattermost*`, `plugin-sdk/msteams`,
`plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`,
@@ -387,22 +344,22 @@ OpenClaw перейшов від широкого шару зворотної с
`plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`,
`plugin-sdk/thread-ownership` і `plugin-sdk/voice-call`
-`plugin-sdk/github-copilot-token` наразі надає вузьку поверхню допоміжних
-засобів токена `DEFAULT_COPILOT_API_BASE_URL`,
+`plugin-sdk/github-copilot-token` наразі надає вузьку
+поверхню допоміжних засобів токенів `DEFAULT_COPILOT_API_BASE_URL`,
`deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken`.
-Використовуйте найвужчий імпорт, який відповідає вашому завданню. Якщо ви не
-можете знайти експорт, перегляньте джерело в `src/plugin-sdk/` або запитайте в Discord.
+Використовуйте найвужчий імпорт, який відповідає вашому завданню. Якщо ви не можете знайти експорт,
+перевірте джерело в `src/plugin-sdk/` або запитайте в Discord.
-## Хронологія вилучення
+## Хронологія видалення
| Коли | Що відбувається |
| ---------------------- | ----------------------------------------------------------------------- |
-| **Зараз** | Застарілі поверхні надсилають попередження під час виконання |
-| **Наступний мажорний реліз** | Застарілі поверхні буде вилучено; плагіни, які все ще їх використовують, перестануть працювати |
+| **Зараз** | Застарілі поверхні видають попередження під час виконання |
+| **Наступний мажорний випуск** | Застарілі поверхні буде видалено; плагіни, які все ще їх використовують, перестануть працювати |
-Усі основні плагіни вже перенесено. Зовнішні плагіни мають виконати міграцію
-до наступного мажорного релізу.
+Усі основні плагіни вже мігровано. Зовнішнім плагінам слід виконати
+міграцію до наступного мажорного випуску.
## Тимчасове приглушення попереджень
@@ -413,13 +370,13 @@ OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
```
-Це тимчасовий обхідний механізм, а не постійне рішення.
+Це тимчасовий обхідний шлях, а не постійне рішення.
## Пов’язане
-- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший плагін
+- [Початок роботи](/uk/plugins/building-plugins) — створіть свій перший Plugin
- [Огляд SDK](/uk/plugins/sdk-overview) — повний довідник імпорту підшляхів
- [Плагіни каналів](/uk/plugins/sdk-channel-plugins) — створення плагінів каналів
- [Плагіни провайдерів](/uk/plugins/sdk-provider-plugins) — створення плагінів провайдерів
-- [Внутрішня будова плагінів](/uk/plugins/architecture) — глибокий огляд архітектури
-- [Маніфест плагіна](/uk/plugins/manifest) — довідник схеми маніфесту
+- [Внутрішня будова Plugin](/uk/plugins/architecture) — глибокий огляд архітектури
+- [Маніфест Plugin](/uk/plugins/manifest) — довідник схеми маніфесту
diff --git a/docs/uk/plugins/sdk-overview.md b/docs/uk/plugins/sdk-overview.md
index 13b0f10ef..1e05dfa7d 100644
--- a/docs/uk/plugins/sdk-overview.md
+++ b/docs/uk/plugins/sdk-overview.md
@@ -4,27 +4,27 @@ read_when:
- Вам потрібен довідник для всіх методів реєстрації в OpenClawPluginApi
- Ви шукаєте конкретний експорт SDK
sidebarTitle: SDK Overview
-summary: Карта імпорту, довідник з API реєстрації та архітектура SDK
+summary: Карта імпортів, довідник API реєстрації та архітектура SDK
title: Огляд Plugin SDK
x-i18n:
- generated_at: "2026-04-10T20:23:45Z"
+ generated_at: "2026-04-17T02:05:24Z"
model: gpt-5.4
provider: openai
- source_hash: 4bfeb5896f68e3e4ee8cf434d43a019e0d1fe5af57f5bf7a5172847c476def0c
+ source_hash: b177fdb6830f415d998a24812bc2c7db8124d3ba77b0174c9a67ac7d747f7e5a
source_path: plugins/sdk-overview.md
workflow: 15
---
# Огляд Plugin SDK
-Plugin SDK — це типізований контракт між плагінами та core. Ця сторінка є
-довідником для **того, що імпортувати** і **що можна реєструвати**.
+Plugin SDK — це типізований контракт між плагінами та ядром. Ця сторінка —
+довідник щодо **що імпортувати** і **що можна зареєструвати**.
- **Шукаєте практичний посібник?**
- - Перший плагін? Почніть із [Getting Started](/uk/plugins/building-plugins)
- - Плагін каналу? Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins)
- - Плагін провайдера? Дивіться [Provider Plugins](/uk/plugins/sdk-provider-plugins)
+ **Шукаєте покроковий посібник?**
+ - Перший плагін? Почніть із [Початок роботи](/uk/plugins/building-plugins)
+ - Плагін каналу? Дивіться [Плагіни каналів](/uk/plugins/sdk-channel-plugins)
+ - Плагін провайдера? Дивіться [Плагіни провайдерів](/uk/plugins/sdk-provider-plugins)
## Угода щодо імпорту
@@ -37,43 +37,45 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
```
Кожен підшлях — це невеликий самодостатній модуль. Це забезпечує швидкий
-запуск і запобігає проблемам із циклічними залежностями. Для специфічних для каналу
-допоміжних засобів entry/build віддавайте перевагу `openclaw/plugin-sdk/channel-core`; залишайте `openclaw/plugin-sdk/core` для
-ширшої узагальнювальної поверхні та спільних допоміжних засобів, таких як
+запуск і запобігає проблемам із циклічними залежностями. Для специфічних для
+каналів допоміжних засобів entry/build віддавайте перевагу
+`openclaw/plugin-sdk/channel-core`; залишайте `openclaw/plugin-sdk/core` для
+ширшої узагальненої поверхні та спільних допоміжних засобів, таких як
`buildChannelConfigSchema`.
-Не додавайте і не використовуйте зручні шари, названі на честь провайдерів, як-от
+Не додавайте й не використовуйте зручні шви з назвами провайдерів, такі як
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
-`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або
-допоміжні шари з брендуванням каналів. Вбудовані плагіни мають компонувати загальні
-підшляхи SDK у власних barrel-файлах `api.ts` або `runtime-api.ts`, а core
-має або використовувати ці локальні barrel-файли плагінів, або додавати вузький загальний SDK
-контракт, коли потреба справді є міжканальною.
+`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, або допоміжні
+шви з брендуванням каналів. Вбудовані плагіни мають компонувати узагальнені
+підшляхи SDK у власних barrel-модулях `api.ts` або `runtime-api.ts`, а ядро
+має або використовувати ці локальні barrel-модулі плагіна, або додавати вузький
+узагальнений контракт SDK, коли потреба справді є міжканальною.
-Згенерована карта експортів усе ще містить невеликий набір допоміжних шарів
-для вбудованих плагінів, як-от `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
+Згенерована карта експортів усе ще містить невеликий набір допоміжних швів
+вбудованих плагінів, таких як `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` і `plugin-sdk/matrix*`. Ці
-підшляхи існують лише для підтримки вбудованих плагінів і сумісності; вони
-навмисно не включені до загальної таблиці нижче і не є рекомендованим
+підшляхи існують лише для підтримки вбудованих плагінів і сумісності; їх
+навмисно не включено до поширеної таблиці нижче, і вони не є рекомендованим
шляхом імпорту для нових сторонніх плагінів.
## Довідник підшляхів
-Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список із
-понад 200 підшляхів міститься в `scripts/lib/plugin-sdk-entrypoints.json`.
+Найуживаніші підшляхи, згруповані за призначенням. Згенерований повний список
+із понад 200 підшляхів міститься у `scripts/lib/plugin-sdk-entrypoints.json`.
-Зарезервовані допоміжні підшляхи для вбудованих плагінів усе ще з’являються в цьому
-згенерованому списку. Розглядайте їх як деталі реалізації/поверхні сумісності,
-якщо лише сторінка документації явно не позначає один із них як публічний.
+Зарезервовані допоміжні підшляхи вбудованих плагінів усе ще з’являються в
+цьому згенерованому списку. Розглядайте їх як деталі реалізації / поверхні
+сумісності, якщо лише сторінка документації явно не просуває якийсь із них як
+публічний.
### Вхідна точка плагіна
| Підшлях | Ключові експорти |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `plugin-sdk/plugin-entry` | `definePluginEntry` |
-| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
-| `plugin-sdk/config-schema` | `OpenClawSchema` |
-| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
+| `plugin-sdk/plugin-entry` | `definePluginEntry` |
+| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
+| `plugin-sdk/config-schema` | `OpenClawSchema` |
+| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
@@ -82,46 +84,46 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
| `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) |
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
- | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, побудовники статусу налаштування |
+ | `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, підказки allowlist, конструктори статусу налаштування |
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
- | `plugin-sdk/account-core` | Допоміжні засоби для конфігурації/контролю дій багатьох облікових записів, допоміжні засоби резервного використання облікового запису за замовчуванням |
- | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
- | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису та резервного використання за замовчуванням |
+ | `plugin-sdk/account-core` | Допоміжні засоби для конфігурації/контролю дій для кількох облікових записів, допоміжні засоби fallback стандартного облікового запису |
+ | `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації ідентифікатора облікового запису |
+ | `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису + fallback стандартного |
| `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для списку облікових записів/дій з обліковими записами |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
- | `plugin-sdk/channel-config-schema` | Типи схеми конфігурації каналу |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із резервною підтримкою вбудованого контракту |
+ | `plugin-sdk/channel-config-schema` | Типи схем конфігурації каналу |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із fallback до вбудованого контракту |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
- | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для route вхідних повідомлень і побудови envelope |
- | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису та dispatch для вхідних повідомлень |
- | `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
+ | `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби побудови вхідних маршрутів + envelope |
+ | `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису й диспетчеризації вхідних даних |
+ | `plugin-sdk/messaging-targets` | Допоміжні засоби парсингу/зіставлення цілей |
| `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
- | `plugin-sdk/outbound-runtime` | Допоміжні засоби для вихідної ідентичності/делегування надсилання |
- | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу thread-binding та адаптерів |
- | `plugin-sdk/agent-media-payload` | Застарілий побудовник agent media payload |
- | `plugin-sdk/conversation-runtime` | Допоміжні засоби для conversation/thread binding, pairing і configured-binding |
- | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб snapshot конфігурації середовища виконання |
- | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення group-policy середовища виконання |
- | `plugin-sdk/channel-status` | Спільні допоміжні засоби snapshot/summary статусу каналу |
+ | `plugin-sdk/outbound-runtime` | Допоміжні засоби делегування вихідної ідентичності/надсилання |
+ | `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу та адаптера прив’язок потоків |
+ | `plugin-sdk/agent-media-payload` | Застарілий конструктор корисного навантаження медіа агента |
+ | `plugin-sdk/conversation-runtime` | Допоміжні засоби прив’язки розмови/потоку, спарювання та налаштованих прив’язок |
+ | `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка конфігурації середовища виконання |
+ | `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення політики груп середовища виконання |
+ | `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/підсумку статусу каналу |
| `plugin-sdk/channel-config-primitives` | Вузькі примітиви схеми конфігурації каналу |
| `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації каналу |
| `plugin-sdk/channel-plugin-common` | Спільні prelude-експорти плагінів каналів |
| `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist |
- | `plugin-sdk/group-access` | Спільні допоміжні засоби ухвалення рішень щодо group-access |
- | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для direct-DM |
- | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/зменшення interactive reply payload |
- | `plugin-sdk/channel-inbound` | Допоміжні засоби debounce вхідних повідомлень, зіставлення згадок, політики згадок та допоміжні засоби envelope |
- | `plugin-sdk/channel-send-result` | Типи результатів reply |
+ | `plugin-sdk/group-access` | Спільні допоміжні засоби прийняття рішень щодо доступу до груп |
+ | `plugin-sdk/direct-dm` | Спільні допоміжні засоби auth/guard для прямих DM |
+ | `plugin-sdk/interactive-runtime` | Допоміжні засоби нормалізації/скорочення корисного навантаження інтерактивних відповідей |
+ | `plugin-sdk/channel-inbound` | Допоміжні засоби debounce вхідних даних, зіставлення згадок, політики згадок і envelope |
+ | `plugin-sdk/channel-send-result` | Типи результатів відповіді |
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
- | `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
- | `plugin-sdk/channel-contract` | Типи контракту каналу |
- | `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби секретного контракту, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей секретів |
+ | `plugin-sdk/channel-targets` | Допоміжні засоби парсингу/зіставлення цілей |
+ | `plugin-sdk/channel-contract` | Типи контрактів каналів |
+ | `plugin-sdk/channel-feedback` | Підключення відгуків/реакцій |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби контрактів секретів, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей секретів |
@@ -130,195 +132,195 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
| `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів |
| `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI |
- | `plugin-sdk/cli-backend` | Значення за замовчуванням для бекенда CLI та константи watchdog |
+ | `plugin-sdk/cli-backend` | Стандартні значення backend CLI + константи watchdog |
| `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключів під час виконання для плагінів провайдерів |
| `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-ключів, такі як `upsertApiKeyProfile` |
- | `plugin-sdk/provider-auth-result` | Стандартний побудовник результатів OAuth auth |
- | `plugin-sdk/provider-auth-login` | Спільні інтерактивні допоміжні засоби входу для плагінів провайдерів |
- | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку змінних середовища auth провайдерів |
+ | `plugin-sdk/provider-auth-result` | Стандартний конструктор результату OAuth auth |
+ | `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для плагінів провайдерів |
+ | `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку env var auth провайдерів |
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
- | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, допоміжні засоби endpoint провайдерів і допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
+ | `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні конструктори політик replay, допоміжні засоби endpoint провайдерів і допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
- | `plugin-sdk/provider-http` | Загальні допоміжні засоби HTTP/можливостей endpoint провайдерів |
- | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контракту конфігурації/вибору web-fetch, такі як `enablePluginInConfig` і `WebFetchProviderPlugin` |
- | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування провайдерів web-fetch |
- | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення увімкнення плагіна |
- | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контракту конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setters/getters для облікових даних |
- | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/виконання провайдерів web-search |
- | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схем Gemini + діагностика, а також допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
+ | `plugin-sdk/provider-http` | Узагальнені допоміжні засоби можливостей HTTP/endpoint провайдерів |
+ | `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контрактів конфігурації/вибору web-fetch, такі як `enablePluginInConfig` і `WebFetchProviderPlugin` |
+ | `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешу web-fetch провайдерів |
+ | `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення активації плагіна |
+ | `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контрактів конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setter/getter для облікових даних |
+ | `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешу/середовища виконання web-search провайдерів |
+ | `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика та допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
| `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібні |
- | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи stream wrapper та спільні допоміжні засоби wrapper для Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
- | `plugin-sdk/provider-onboard` | Допоміжні засоби виправлення конфігурації онбордингу |
- | `plugin-sdk/global-singleton` | Допоміжні засоби для локальних у межах процесу singleton/map/cache |
+ | `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток для Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
+ | `plugin-sdk/provider-onboard` | Допоміжні засоби патчів конфігурації онбордингу |
+ | `plugin-sdk/global-singleton` | Допоміжні засоби локальних для процесу singleton/map/cache |
- | Підшлях | Ключові експорти |
+ | Subpath | Key exports |
| --- | --- |
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, допоміжні засоби авторизації відправника |
- | `plugin-sdk/command-status` | Побудовники повідомлень команд/довідки, такі як `buildCommandsMessagePaginated` і `buildHelpMessage` |
- | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення approver і auth дій у тому самому чаті |
+ | `plugin-sdk/command-status` | Конструктори повідомлень команд/довідки, такі як `buildCommandsMessagePaginated` і `buildHelpMessage` |
+ | `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення затверджувача та auth дій у межах того самого чату |
| `plugin-sdk/approval-client-runtime` | Допоміжні засоби профілю/фільтра native exec approval |
| `plugin-sdk/approval-delivery-runtime` | Адаптери можливостей/доставки native approval |
| `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення approval gateway |
- | `plugin-sdk/approval-handler-adapter-runtime` | Полегшені допоміжні засоби завантаження адаптера native approval для гарячих entrypoint каналів |
- | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime для approval handler; віддавайте перевагу вужчим adapter/gateway seams, коли їх достатньо |
- | `plugin-sdk/approval-native-runtime` | Допоміжні засоби для native approval target і account-binding |
- | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді exec/plugin approval |
- | `plugin-sdk/command-auth-native` | Native command auth і допоміжні засоби native session-target |
+ | `plugin-sdk/approval-handler-adapter-runtime` | Полегшені допоміжні засоби завантаження native approval adapter для гарячих entrypoint каналів |
+ | `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime для approval handler; віддавайте перевагу вужчим швам adapter/gateway, коли їх достатньо |
+ | `plugin-sdk/approval-native-runtime` | Допоміжні засоби native approval target + прив’язки облікового запису |
+ | `plugin-sdk/approval-reply-runtime` | Допоміжні засоби корисного навантаження відповідей exec/plugin approval |
+ | `plugin-sdk/command-auth-native` | Допоміжні засоби native command auth + native session-target |
| `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
- | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації command-body і command-surface |
+ | `plugin-sdk/command-surface` | Допоміжні засоби нормалізації тіла команди та command-surface |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
- | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання секретного контракту для поверхонь секретів каналів/плагінів |
- | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для розбору секретного контракту/конфігурації |
- | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, DM gating, зовнішнього вмісту та збирання секретів |
+ | `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь secret каналів/плагінів |
+ | `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для парсингу secret-contract/config |
+ | `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, обмеження DM, зовнішнього вмісту та збирання секретів |
| `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF для allowlist хостів і приватних мереж |
| `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом SSRF і політики SSRF |
- | `plugin-sdk/secret-input` | Допоміжні засоби розбору secret input |
- | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів/цілей webhook |
- | `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру body запиту/timeout |
+ | `plugin-sdk/secret-input` | Допоміжні засоби парсингу секретних входів |
+ | `plugin-sdk/webhook-ingress` | Допоміжні засоби запитів/цілей Webhook |
+ | `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру тіла запиту/таймауту |
- | Підшлях | Ключові експорти |
+ | Subpath | Key exports |
| --- | --- |
- | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/plugin-install |
- | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env, logger, timeout, retry і backoff |
- | `plugin-sdk/channel-runtime-context` | Загальні допоміжні засоби реєстрації та пошуку channel runtime-context |
+ | `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/logging/backup/встановлення плагінів |
+ | `plugin-sdk/runtime-env` | Вузькі допоміжні засоби env runtime, logger, timeout, retry і backoff |
+ | `plugin-sdk/channel-runtime-context` | Узагальнені допоміжні засоби реєстрації та пошуку channel runtime-context |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
- | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/хуків/http/interactive для плагінів |
- | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби pipeline для webhook/internal hook |
- | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy runtime import/binding, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
- | `plugin-sdk/process-runtime` | Допоміжні засоби виконання процесів |
- | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування і версії |
- | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта gateway і patch статусу каналу |
+ | `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби plugin command/hook/http/interactive |
+ | `plugin-sdk/hook-runtime` | Спільні допоміжні засоби pipeline webhook/internal hook |
+ | `plugin-sdk/lazy-runtime` | Допоміжні засоби lazy імпорту/прив’язки runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
+ | `plugin-sdk/process-runtime` | Допоміжні засоби exec процесів |
+ | `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування та версій |
+ | `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway і patch статусу каналу |
| `plugin-sdk/config-runtime` | Допоміжні засоби завантаження/запису конфігурації |
- | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня контракту вбудованого Telegram недоступна |
- | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, побудовники approval-capability, допоміжні засоби auth/profile, native routing/runtime |
- | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для inbound/reply, chunking, dispatch, heartbeat, planner відповіді |
+ | `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня вбудованого контракту Telegram недоступна |
+ | `plugin-sdk/approval-runtime` | Допоміжні засоби exec/plugin approval, конструктори можливостей approval, допоміжні засоби auth/profile, native routing/runtime |
+ | `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для вхідних даних/відповідей, chunking, dispatch, Heartbeat, planner відповіді |
| `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповіді |
- | `plugin-sdk/reply-history` | Спільні допоміжні засоби short-window reply-history, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
+ | `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії відповідей, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
| `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/markdown |
- | `plugin-sdk/session-store-runtime` | Допоміжні засоби для шляху сховища сесій і updated-at |
- | `plugin-sdk/state-paths` | Допоміжні засоби шляхів до каталогів state/OAuth |
- | `plugin-sdk/routing` | Допоміжні засоби route/session-key/account binding, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
- | `plugin-sdk/status-helpers` | Спільні допоміжні засоби summary статусу каналу/облікового запису, значення runtime-state за замовчуванням і допоміжні засоби метаданих проблем |
- | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби target resolver |
+ | `plugin-sdk/session-store-runtime` | Допоміжні засоби шляху сховища сесій + `updated-at` |
+ | `plugin-sdk/state-paths` | Допоміжні засоби шляхів каталогів state/OAuth |
+ | `plugin-sdk/routing` | Допоміжні засоби route/session-key/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
+ | `plugin-sdk/status-helpers` | Спільні допоміжні засоби підсумку статусу каналу/облікового запису, стандартні значення стану runtime та допоміжні засоби метаданих проблем |
+ | `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби визначення цілей |
| `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків |
- | `plugin-sdk/request-url` | Витягання рядкових URL із fetch/request-подібних входів |
- | `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr |
- | `plugin-sdk/param-readers` | Поширені зчитувачі параметрів tool/CLI |
- | `plugin-sdk/tool-payload` | Витягання нормалізованих payload із об’єктів результатів tool |
- | `plugin-sdk/tool-send` | Витягання канонічних полів цілі надсилання з аргументів tool |
- | `plugin-sdk/temp-path` | Спільні допоміжні засоби для шляхів тимчасового завантаження |
- | `plugin-sdk/logging-core` | Допоміжні засоби для logger підсистеми та редагування |
+ | `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних входів |
+ | `plugin-sdk/run-command` | Виконавець команд із таймінгом і нормалізованими результатами stdout/stderr |
+ | `plugin-sdk/param-readers` | Типові читачі параметрів tool/CLI |
+ | `plugin-sdk/tool-payload` | Витягування нормалізованих payload із об’єктів результатів tool |
+ | `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів tool |
+ | `plugin-sdk/temp-path` | Спільні допоміжні засоби шляхів тимчасових завантажень |
+ | `plugin-sdk/logging-core` | Допоміжні засоби logger підсистеми та редагування |
| `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму таблиць Markdown |
- | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису JSON state |
- | `plugin-sdk/file-lock` | Допоміжні засоби повторно-вхідного file-lock |
- | `plugin-sdk/persistent-dedupe` | Допоміжні засоби dedupe cache з дисковим збереженням |
+ | `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
+ | `plugin-sdk/file-lock` | Допоміжні засоби повторно вхідного file-lock |
+ | `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу dedupe на диску |
| `plugin-sdk/acp-runtime` | Допоміжні засоби ACP runtime/session і reply-dispatch |
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви схеми конфігурації runtime агента |
- | `plugin-sdk/boolean-param` | Гнучкий зчитувач булевих параметрів |
- | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів для небезпечних назв |
- | `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою і pairing token |
+ | `plugin-sdk/boolean-param` | Читач нестрогих булевих параметрів |
+ | `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів небезпечних назв |
+ | `plugin-sdk/device-bootstrap` | Допоміжні засоби початкового налаштування пристрою та токенів pairing |
| `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status і ambient proxy |
- | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді для команди `/models` і провайдерів |
- | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби для списку команд Skills |
- | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/побудови/серіалізації native command |
- | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих agent harness: типи harness, допоміжні засоби steer/abort для активного запуску, допоміжні засоби bridge інструментів OpenClaw і утиліти результатів спроб |
+ | `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповіді команди `/models`/провайдера |
+ | `plugin-sdk/skill-commands-runtime` | Допоміжні засоби списку команд Skills |
+ | `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/build/serialize native команд |
+ | `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих harness агента: типи harness, допоміжні засоби steer/abort активного запуску, допоміжні засоби мосту інструментів OpenClaw і утиліти результатів спроб |
| `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.A.I |
- | `plugin-sdk/infra-runtime` | Допоміжні засоби системних подій/heartbeat |
+ | `plugin-sdk/infra-runtime` | Допоміжні засоби системних подій/Heartbeat |
| `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
- | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби прапорців і подій діагностики |
+ | `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців і подій |
| `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
- | `plugin-sdk/fetch-runtime` | Обгорнутий fetch, proxy і допоміжні засоби pinned lookup |
+ | `plugin-sdk/fetch-runtime` | Обгорнуті допоміжні засоби fetch, proxy і pinned lookup |
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
| `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і виконавця retry |
- | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/workspace агента |
- | `plugin-sdk/directory-runtime` | Запит/dedup каталогів із підтримкою конфігурації |
+ | `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/робочого простору агента |
+ | `plugin-sdk/directory-runtime` | Запит/dedupe каталогів на основі конфігурації |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
- | Підшлях | Ключові експорти |
+ | Subpath | Key exports |
| --- | --- |
- | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store для медіа, а також побудовники media payload |
- | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover для генерації медіа, вибір кандидатів і повідомлення про відсутні моделі |
- | `plugin-sdk/media-understanding` | Типи провайдерів media understanding, а також орієнтовані на провайдерів експорти допоміжних засобів для зображень/аудіо |
- | `plugin-sdk/text-runtime` | Спільні допоміжні засоби для тексту/markdown/logging, такі як видалення тексту, видимого асистенту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування, допоміжні засоби тегів директив і утиліти безпечного тексту |
+ | `plugin-sdk/media-runtime` | Спільні допоміжні засоби fetch/transform/store медіа, а також конструктори payload медіа |
+ | `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover генерації медіа, вибору кандидатів і повідомлень про відсутні моделі |
+ | `plugin-sdk/media-understanding` | Типи провайдерів розуміння медіа, а також експорти допоміжних засобів зображень/аудіо для провайдерів |
+ | `plugin-sdk/text-runtime` | Спільні допоміжні засоби text/markdown/logging, такі як видалення видимого для асистента тексту, допоміжні засоби render/chunking/table для markdown, допоміжні засоби редагування, допоміжні засоби тегів директив і утиліти безпечного тексту |
| `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту |
- | `plugin-sdk/speech` | Типи провайдерів speech, а також орієнтовані на провайдерів допоміжні засоби для директив, реєстру і валідації |
- | `plugin-sdk/speech-core` | Спільні допоміжні засоби типів провайдерів speech, реєстру, директив і нормалізації |
- | `plugin-sdk/realtime-transcription` | Типи провайдерів realtime transcription і допоміжні засоби реєстру |
- | `plugin-sdk/realtime-voice` | Типи провайдерів realtime voice і допоміжні засоби реєстру |
+ | `plugin-sdk/speech` | Типи speech-провайдерів, а також допоміжні засоби директив, реєстру та валідації для провайдерів |
+ | `plugin-sdk/speech-core` | Спільні допоміжні засоби типів, реєстру, директив і нормалізації speech-провайдерів |
+ | `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі та допоміжні засоби реєстру |
+ | `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та допоміжні засоби реєстру |
| `plugin-sdk/image-generation` | Типи провайдерів генерації зображень |
- | `plugin-sdk/image-generation-core` | Спільні допоміжні засоби типів генерації зображень, failover, auth і реєстру |
+ | `plugin-sdk/image-generation-core` | Спільні допоміжні засоби типів, failover, auth і реєстру генерації зображень |
| `plugin-sdk/music-generation` | Типи провайдерів/запитів/результатів генерації музики |
- | `plugin-sdk/music-generation-core` | Спільні допоміжні засоби типів генерації музики, failover, пошуку провайдерів і розбору model-ref |
+ | `plugin-sdk/music-generation-core` | Спільні допоміжні засоби типів генерації музики, failover, пошуку провайдерів і парсингу model-ref |
| `plugin-sdk/video-generation` | Типи провайдерів/запитів/результатів генерації відео |
- | `plugin-sdk/video-generation-core` | Спільні допоміжні засоби типів генерації відео, failover, пошуку провайдерів і розбору model-ref |
- | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру webhook target і встановлення route |
- | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху webhook |
+ | `plugin-sdk/video-generation-core` | Спільні допоміжні засоби типів генерації відео, failover, пошуку провайдерів і парсингу model-ref |
+ | `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей Webhook та встановлення маршрутів |
+ | `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook |
| `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
- | `plugin-sdk/zod` | Повторно експортований `zod` для користувачів Plugin SDK |
+ | `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK |
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
- | Підшлях | Ключові експорти |
+ | Subpath | Key exports |
| --- | --- |
- | `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для manager/config/file/CLI |
- | `plugin-sdk/memory-core-engine-runtime` | Runtime facade для індексу/пошуку пам’яті |
+ | `plugin-sdk/memory-core` | Поверхня допоміжних засобів вбудованого memory-core для менеджера/конфігурації/файлів/CLI |
+ | `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексу/пошуку пам’яті |
| `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-engine-embeddings` | Експорти embedding engine хоста пам’яті |
+ | `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і узагальнені допоміжні засоби batch/remote |
| `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
| `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
- | `plugin-sdk/memory-core-host-multimodal` | Допоміжні засоби multimodal хоста пам’яті |
- | `plugin-sdk/memory-core-host-query` | Допоміжні засоби query хоста пам’яті |
- | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби secret хоста пам’яті |
+ | `plugin-sdk/memory-core-host-multimodal` | Мультимодальні допоміжні засоби хоста пам’яті |
+ | `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
+ | `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
| `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
| `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби CLI runtime хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-core` | Допоміжні засоби core runtime хоста пам’яті |
| `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-core` | Нейтральний щодо вендора псевдонім для допоміжних засобів core runtime хоста пам’яті |
- | `plugin-sdk/memory-host-events` | Нейтральний щодо вендора псевдонім для допоміжних засобів журналу подій хоста пам’яті |
- | `plugin-sdk/memory-host-files` | Нейтральний щодо вендора псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
- | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби managed-markdown для плагінів, суміжних із пам’яттю |
- | `plugin-sdk/memory-host-search` | Активна runtime facade пам’яті для доступу до search-manager |
- | `plugin-sdk/memory-host-status` | Нейтральний щодо вендора псевдонім для допоміжних засобів статусу хоста пам’яті |
- | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів bundled memory-lancedb |
+ | `plugin-sdk/memory-host-core` | Нейтральний до постачальника псевдонім для допоміжних засобів core runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-events` | Нейтральний до постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
+ | `plugin-sdk/memory-host-files` | Нейтральний до постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
+ | `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби керованого markdown для плагінів, суміжних із пам’яттю |
+ | `plugin-sdk/memory-host-search` | Фасад runtime Active Memory для доступу до менеджера пошуку |
+ | `plugin-sdk/memory-host-status` | Нейтральний до постачальника псевдонім для допоміжних засобів статусу хоста пам’яті |
+ | `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів вбудованого memory-lancedb |
-
- | Сімейство | Поточні підшляхи | Призначене використання |
+
+ | Family | Current subpaths | Intended use |
| --- | --- | --- |
- | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin (`browser-support` залишається barrel-файлом сумісності) |
- | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Допоміжна/runtime поверхня вбудованого Matrix |
- | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Допоміжна/runtime поверхня вбудованого LINE |
- | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Допоміжна поверхня вбудованого IRC |
- | Допоміжні засоби, специфічні для каналів | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Шари сумісності/допоміжні засоби для вбудованих каналів |
- | Допоміжні засоби, специфічні для auth/плагінів | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шари допоміжних засобів для вбудованих можливостей/плагінів; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
+ | Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки вбудованого browser plugin (`browser-support` залишається barrel-модулем сумісності) |
+ | Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня helper/runtime вбудованого Matrix |
+ | Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper/runtime вбудованого LINE |
+ | IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня helper-модулів вбудованого IRC |
+ | Channel-specific helpers | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Шви сумісності/helper-модулі вбудованих каналів |
+ | Auth/plugin-specific helpers | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Шви helper-модулів для вбудованих функцій/плагінів; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
## API реєстрації
-Зворотний виклик `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
+Колбек `register(api)` отримує об’єкт `OpenClawPluginApi` з такими
методами:
### Реєстрація можливостей
-| Метод | Що він реєструє |
+| Method | What it registers |
| ------------------------------------------------ | ------------------------------------- |
-| `api.registerProvider(...)` | Текстовий inference (LLM) |
+| `api.registerProvider(...)` | Текстове виведення (LLM) |
| `api.registerAgentHarness(...)` | Експериментальний низькорівневий виконавець агента |
-| `api.registerCliBackend(...)` | Локальний inference-бекенд CLI |
+| `api.registerCliBackend(...)` | Локальний backend виведення CLI |
| `api.registerChannel(...)` | Канал обміну повідомленнями |
| `api.registerSpeechProvider(...)` | Синтез text-to-speech / STT |
| `api.registerRealtimeTranscriptionProvider(...)` | Потокова транскрипція в реальному часі |
-| `api.registerRealtimeVoiceProvider(...)` | Дуплексні голосові сесії в реальному часі |
+| `api.registerRealtimeVoiceProvider(...)` | Двобічні голосові сесії в реальному часі |
| `api.registerMediaUnderstandingProvider(...)` | Аналіз зображень/аудіо/відео |
| `api.registerImageGenerationProvider(...)` | Генерація зображень |
| `api.registerMusicGenerationProvider(...)` | Генерація музики |
@@ -328,40 +330,40 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
### Інструменти та команди
-| Метод | Що він реєструє |
+| Method | What it registers |
| ------------------------------- | --------------------------------------------- |
| `api.registerTool(tool, opts?)` | Інструмент агента (обов’язковий або `{ optional: true }`) |
-| `api.registerCommand(def)` | Користувацька команда (оминає LLM) |
+| `api.registerCommand(def)` | Власна команда (обходить LLM) |
### Інфраструктура
-| Метод | Що він реєструє |
-| ---------------------------------------------- | ---------------------------------- |
-| `api.registerHook(events, handler, opts?)` | Хук події |
-| `api.registerHttpRoute(params)` | HTTP endpoint gateway |
-| `api.registerGatewayMethod(name, handler)` | RPC-метод gateway |
-| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
-| `api.registerService(service)` | Фонова служба |
-| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник |
-| `api.registerMemoryPromptSupplement(builder)` | Адитивний розділ prompt, суміжний із пам’яттю |
-| `api.registerMemoryCorpusSupplement(adapter)` | Адитивний корпус пошуку/читання пам’яті |
+| Method | What it registers |
+| ---------------------------------------------- | --------------------------------------- |
+| `api.registerHook(events, handler, opts?)` | Хук події |
+| `api.registerHttpRoute(params)` | HTTP-ендпоїнт Gateway |
+| `api.registerGatewayMethod(name, handler)` | RPC-метод Gateway |
+| `api.registerCli(registrar, opts?)` | Підкоманда CLI |
+| `api.registerService(service)` | Фонова служба |
+| `api.registerInteractiveHandler(registration)` | Інтерактивний обробник |
+| `api.registerMemoryPromptSupplement(builder)` | Додатковий розділ prompt, суміжний із пам’яттю |
+| `api.registerMemoryCorpusSupplement(adapter)` | Додатковий корпус пошуку/читання пам’яті |
Зарезервовані простори імен core admin (`config.*`, `exec.approvals.*`, `wizard.*`,
`update.*`) завжди залишаються `operator.admin`, навіть якщо плагін намагається призначити
-вужчу область видимості для методу gateway. Для методів, що належать плагіну,
+вужчу область видимості методу Gateway. Для методів, що належать плагіну,
віддавайте перевагу префіксам, специфічним для плагіна.
### Метадані реєстрації CLI
`api.registerCli(registrar, opts?)` приймає два типи метаданих верхнього рівня:
-- `commands`: явні корені команд, що належать реєстратору
-- `descriptors`: дескриптори команд на етапі розбору, які використовуються для кореневої довідки CLI,
+- `commands`: явні корені команд, якими володіє registrar
+- `descriptors`: дескриптори команд на етапі парсингу, що використовуються для кореневої довідки CLI,
маршрутизації та лінивої реєстрації CLI плагіна
-Якщо ви хочете, щоб команда плагіна залишалася ліниво завантажуваною у звичайному кореневому шляху CLI,
-надайте `descriptors`, які охоплюють кожен корінь команди верхнього рівня, що експонується цим
-реєстратором.
+Якщо ви хочете, щоб команда плагіна залишалася з лінивим завантаженням у
+звичайному шляху кореневого CLI, надайте `descriptors`, які охоплюють кожен
+корінь команди верхнього рівня, що експонується цим registrar.
```typescript
api.registerCli(
@@ -373,7 +375,7 @@ api.registerCli(
descriptors: [
{
name: "matrix",
- description: "Керування обліковими записами Matrix, верифікацією, пристроями та станом профілю",
+ description: "Manage Matrix accounts, verification, devices, and profile state",
hasSubcommands: true,
},
],
@@ -381,72 +383,71 @@ api.registerCli(
);
```
-Використовуйте лише `commands`, якщо вам не потрібна лінива реєстрація кореневого CLI.
-Цей eager-шлях сумісності все ще підтримується, але він не встановлює
-заповнювачі на основі дескрипторів для лінивого завантаження на етапі розбору.
+Використовуйте лише `commands`, тільки якщо вам не потрібна лінива реєстрація
+кореневого CLI. Цей eager-шлях сумісності залишається підтримуваним, але він не
+встановлює placeholders на основі descriptor для лінивого завантаження під час парсингу.
-### Реєстрація CLI-бекенда
+### Реєстрація backend CLI
-`api.registerCliBackend(...)` дає змогу плагіну володіти конфігурацією за замовчуванням для локального
-AI CLI-бекенда, такого як `codex-cli`.
+`api.registerCliBackend(...)` дає змогу плагіну володіти стандартною конфігурацією для
+локального AI CLI backend, такого як `codex-cli`.
-- `id` бекенда стає префіксом провайдера в model ref, наприклад `codex-cli/gpt-5`.
-- `config` бекенда використовує ту саму форму, що й `agents.defaults.cliBackends.`.
-- Конфігурація користувача все одно має пріоритет. OpenClaw об’єднує `agents.defaults.cliBackends.` поверх
- значення плагіна за замовчуванням перед запуском CLI.
-- Використовуйте `normalizeConfig`, коли бекенду потрібні переписування для сумісності після об’єднання
- (наприклад, нормалізація старих форм прапорців).
+- `id` backend стає префіксом провайдера в посиланнях на моделі, наприклад `codex-cli/gpt-5`.
+- `config` backend використовує ту саму форму, що й `agents.defaults.cliBackends.`.
+- Конфігурація користувача все одно має пріоритет. OpenClaw зливає `agents.defaults.cliBackends.` поверх
+ стандартної конфігурації плагіна перед запуском CLI.
+- Використовуйте `normalizeConfig`, коли backend потребує переписування для сумісності після злиття
+ (наприклад, нормалізації старих форм прапорців).
### Ексклюзивні слоти
-| Метод | Що він реєструє |
+| Method | What it registers |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `api.registerContextEngine(id, factory)` | Рушій контексту (одночасно активним може бути лише один). Зворотний виклик `assemble()` отримує `availableTools` і `citationsMode`, щоб рушій міг адаптувати доповнення prompt. |
-| `api.registerMemoryCapability(capability)` | Єдину можливість пам’яті |
-| `api.registerMemoryPromptSection(builder)` | Побудовник розділу prompt пам’яті |
-| `api.registerMemoryFlushPlan(resolver)` | Резолвер плану скидання пам’яті |
+| `api.registerContextEngine(id, factory)` | Context engine (одночасно активний лише один). Колбек `assemble()` отримує `availableTools` і `citationsMode`, щоб engine міг налаштувати додавання до prompt. |
+| `api.registerMemoryCapability(capability)` | Уніфікована можливість пам’яті |
+| `api.registerMemoryPromptSection(builder)` | Конструктор розділу prompt для пам’яті |
+| `api.registerMemoryFlushPlan(resolver)` | Резолвер плану flush пам’яті |
| `api.registerMemoryRuntime(runtime)` | Адаптер runtime пам’яті |
-### Адаптери embeddings пам’яті
+### Адаптери embedding пам’яті
-| Метод | Що він реєструє |
-| ---------------------------------------------- | ----------------------------------------- |
-| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embeddings пам’яті для активного плагіна |
+| Method | What it registers |
+| ---------------------------------------------- | ---------------------------------------------- |
+| `api.registerMemoryEmbeddingProvider(adapter)` | Адаптер embedding пам’яті для активного плагіна |
-- `registerMemoryCapability` — це рекомендований API ексклюзивного memory-plugin.
-- `registerMemoryCapability` також може експортувати `publicArtifacts.listArtifacts(...)`,
- щоб companion plugins могли використовувати експортовані артефакти пам’яті через
- `openclaw/plugin-sdk/memory-host-core` замість звернення до приватної структури
- конкретного memory plugin.
+- `registerMemoryCapability` — це бажаний API ексклюзивного memory-plugin.
+- `registerMemoryCapability` також може експонувати `publicArtifacts.listArtifacts(...)`,
+ щоб супутні плагіни могли споживати експортовані артефакти пам’яті через
+ `openclaw/plugin-sdk/memory-host-core` замість звернення до приватного
+ розміщення конкретного memory plugin.
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` і
- `registerMemoryRuntime` — це сумісні зі старими версіями API ексклюзивних memory-plugin.
+ `registerMemoryRuntime` — це застарілі, але сумісні API ексклюзивного memory-plugin.
- `registerMemoryEmbeddingProvider` дає змогу активному memory plugin зареєструвати один
- або кілька ідентифікаторів adapter embeddings (наприклад, `openai`, `gemini` або
- користувацький id, визначений плагіном).
+ або кілька ідентифікаторів адаптерів embedding (наприклад, `openai`, `gemini` або власний id, визначений плагіном).
- Конфігурація користувача, така як `agents.defaults.memorySearch.provider` і
`agents.defaults.memorySearch.fallback`, визначається відносно цих зареєстрованих
- id adapter.
+ id адаптерів.
### Події та життєвий цикл
-| Метод | Що він робить |
-| -------------------------------------------- | ---------------------------- |
-| `api.on(hookName, handler, opts?)` | Типізований lifecycle hook |
-| `api.onConversationBindingResolved(handler)` | Зворотний виклик binding розмови |
+| Method | What it does |
+| -------------------------------------------- | ----------------------------- |
+| `api.on(hookName, handler, opts?)` | Типізований хук життєвого циклу |
+| `api.onConversationBindingResolved(handler)` | Колбек прив’язки розмови |
-### Семантика рішень для хуків
+### Семантика рішень хука
-- `before_tool_call`: повернення `{ block: true }` є остаточним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `before_tool_call`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `before_install`: повернення `{ block: true }` є остаточним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `before_install`: повернення `{ block: false }` вважається відсутністю рішення (так само, як пропуск `block`), а не перевизначенням.
-- `reply_dispatch`: повернення `{ handled: true, ... }` є остаточним. Щойно будь-який обробник бере на себе dispatch, обробники з нижчим пріоритетом і стандартний шлях dispatch моделі пропускаються.
-- `message_sending`: повернення `{ cancel: true }` є остаточним. Щойно будь-який обробник встановлює це значення, обробники з нижчим пріоритетом пропускаються.
-- `message_sending`: повернення `{ cancel: false }` вважається відсутністю рішення (так само, як пропуск `cancel`), а не перевизначенням.
+- `before_tool_call`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник установлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `before_tool_call`: повернення `{ block: false }` розглядається як відсутність рішення (так само, як і пропуск `block`), а не як перевизначення.
+- `before_install`: повернення `{ block: true }` є термінальним. Щойно будь-який обробник установлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `before_install`: повернення `{ block: false }` розглядається як відсутність рішення (так само, як і пропуск `block`), а не як перевизначення.
+- `reply_dispatch`: повернення `{ handled: true, ... }` є термінальним. Щойно будь-який обробник бере на себе диспетчеризацію, обробники з нижчим пріоритетом і стандартний шлях диспетчеризації моделі пропускаються.
+- `message_sending`: повернення `{ cancel: true }` є термінальним. Щойно будь-який обробник установлює це значення, обробники з нижчим пріоритетом пропускаються.
+- `message_sending`: повернення `{ cancel: false }` розглядається як відсутність рішення (так само, як і пропуск `cancel`), а не як перевизначення.
### Поля об’єкта API
-| Поле | Тип | Опис |
+| Field | Type | Description |
| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------- |
| `api.id` | `string` | Ідентифікатор плагіна |
| `api.name` | `string` | Відображувана назва |
@@ -454,61 +455,63 @@ AI CLI-бекенда, такого як `codex-cli`.
| `api.description` | `string?` | Опис плагіна (необов’язково) |
| `api.source` | `string` | Шлях до джерела плагіна |
| `api.rootDir` | `string?` | Кореневий каталог плагіна (необов’язково) |
-| `api.config` | `OpenClawConfig` | Поточний snapshot конфігурації (активний snapshot runtime в пам’яті, якщо доступний) |
-| `api.pluginConfig` | `Record` | Конфігурація, специфічна для плагіна, з `plugins.entries..config` |
+| `api.config` | `OpenClawConfig` | Поточний знімок конфігурації (активний знімок runtime у пам’яті, якщо доступний) |
+| `api.pluginConfig` | `Record` | Конфігурація плагіна з `plugins.entries..config` |
| `api.runtime` | `PluginRuntime` | [Допоміжні засоби runtime](/uk/plugins/sdk-runtime) |
-| `api.logger` | `PluginLogger` | Logger з обмеженою областю (`debug`, `info`, `warn`, `error`) |
+| `api.logger` | `PluginLogger` | Logger з областю видимості (`debug`, `info`, `warn`, `error`) |
| `api.registrationMode` | `PluginRegistrationMode` | Поточний режим завантаження; `"setup-runtime"` — це полегшене вікно запуску/налаштування до повного entry |
-| `api.resolvePath(input)` | `(string) => string` | Визначити шлях відносно кореня плагіна |
+| `api.resolvePath(input)` | `(string) => string` | Визначення шляху відносно кореня плагіна |
## Угода щодо внутрішніх модулів
-Усередині вашого плагіна використовуйте локальні barrel-файли для внутрішніх імпортів:
+У межах вашого плагіна використовуйте локальні barrel-файли для внутрішніх імпортів:
```
my-plugin/
api.ts # Публічні експорти для зовнішніх споживачів
runtime-api.ts # Експорти runtime лише для внутрішнього використання
index.ts # Точка входу плагіна
- setup-entry.ts # Полегшений entry лише для налаштування (необов’язково)
+ setup-entry.ts # Полегшена точка входу лише для налаштування (необов’язково)
```
Ніколи не імпортуйте власний плагін через `openclaw/plugin-sdk/`
- з production-коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
+ із production-коду. Спрямовуйте внутрішні імпорти через `./api.ts` або
`./runtime-api.ts`. Шлях SDK — це лише зовнішній контракт.
-Фасадно-завантажувані публічні поверхні вбудованих плагінів (`api.ts`, `runtime-api.ts`,
-`index.ts`, `setup-entry.ts` та подібні публічні entry-файли) тепер віддають перевагу
-активному snapshot конфігурації runtime, коли OpenClaw уже запущено. Якщо snapshot runtime
-ще не існує, вони повертаються до визначеного файлу конфігурації на диску.
+Фасадно завантажувані публічні поверхні вбудованих плагінів (`api.ts`, `runtime-api.ts`,
+`index.ts`, `setup-entry.ts` та подібні публічні entry-файли) тепер віддають
+перевагу активному знімку конфігурації runtime, коли OpenClaw уже запущений.
+Якщо знімок runtime ще не існує, вони повертаються до визначеного файлу
+конфігурації на диску.
-Плагіни провайдерів також можуть експонувати вузький локальний контрактний barrel плагіна, коли
-допоміжний засіб навмисно є специфічним для провайдера і ще не належить до загального підшляху SDK.
-Поточний вбудований приклад: провайдер Anthropic зберігає свої допоміжні засоби потоків Claude
-у власному публічному seam `api.ts` / `contract-api.ts` замість того, щоб просувати логіку
-Anthropic beta-header і `service_tier` у загальний контракт `plugin-sdk/*`.
+Плагіни провайдерів також можуть експонувати вузький локальний barrel-контракт
+плагіна, коли helper навмисно є специфічним для провайдера і ще не належить до
+узагальненого підшляху SDK. Поточний вбудований приклад: провайдер Anthropic
+зберігає свої helper-модулі потоку Claude у власному публічному шві `api.ts` / `contract-api.ts`
+замість просування логіки Anthropic beta-header і `service_tier` до узагальненого
+контракту `plugin-sdk/*`.
Інші поточні вбудовані приклади:
-- `@openclaw/openai-provider`: `api.ts` експортує побудовники провайдерів,
- допоміжні засоби моделей за замовчуванням і побудовники realtime-провайдерів
-- `@openclaw/openrouter-provider`: `api.ts` експортує побудовник провайдера, а також
- допоміжні засоби онбордингу/конфігурації
+- `@openclaw/openai-provider`: `api.ts` експортує конструктори провайдерів,
+ helper-модулі стандартних моделей і конструктори провайдерів реального часу
+- `@openclaw/openrouter-provider`: `api.ts` експортує конструктор провайдера, а також
+ helper-модулі онбордингу/конфігурації
Production-код розширень також має уникати імпортів `openclaw/plugin-sdk/`.
- Якщо допоміжний засіб справді є спільним, винесіть його в нейтральний підшлях SDK,
- такий як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншу
- поверхню, орієнтовану на можливість, замість жорсткого зв’язування двох плагінів.
+ Якщо helper справді є спільним, перенесіть його до нейтрального підшляху SDK,
+ такого як `openclaw/plugin-sdk/speech`, `.../provider-model-shared` або іншої
+ поверхні, орієнтованої на можливості, замість жорсткого зв’язування двох плагінів.
-## Пов’язані матеріали
+## Пов’язане
- [Точки входу](/uk/plugins/sdk-entrypoints) — параметри `definePluginEntry` і `defineChannelPluginEntry`
- [Допоміжні засоби runtime](/uk/plugins/sdk-runtime) — повний довідник простору імен `api.runtime`
-- [Налаштування і конфігурація](/uk/plugins/sdk-setup) — пакування, маніфести, схеми конфігурації
+- [Налаштування та конфігурація](/uk/plugins/sdk-setup) — пакування, маніфести, схеми конфігурації
- [Тестування](/uk/plugins/sdk-testing) — утиліти тестування та правила lint
-- [Міграція SDK](/uk/plugins/sdk-migration) — міграція з застарілих поверхонь
-- [Внутрішня будова плагінів](/uk/plugins/architecture) — детальна архітектура і модель можливостей
+- [Міграція SDK](/uk/plugins/sdk-migration) — міграція зі застарілих поверхонь
+- [Внутрішня будова плагінів](/uk/plugins/architecture) — детальна архітектура та модель можливостей