From 10529b2fbd337cf202f0085f973a61af5b143bfa Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Tue, 21 Apr 2026 22:19:42 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/plugins/sdk-entrypoints.md | 180 +++++++++++++----------- docs/uk/tools/clawhub.md | 214 +++++++++++++++-------------- 2 files changed, 208 insertions(+), 186 deletions(-) diff --git a/docs/uk/plugins/sdk-entrypoints.md b/docs/uk/plugins/sdk-entrypoints.md index 9f696ba35..ce597e7a0 100644 --- a/docs/uk/plugins/sdk-entrypoints.md +++ b/docs/uk/plugins/sdk-entrypoints.md @@ -1,25 +1,42 @@ --- read_when: - - Вам потрібен точний сигнатурний тип `definePluginEntry` або `defineChannelPluginEntry` - - Ви хочете зрозуміти режим реєстрації (`full` проти `setup` проти метаданих CLI) + - Вам потрібен точний сигнатурний тип definePluginEntry або defineChannelPluginEntry + - Ви хочете зрозуміти режим реєстрації (повний vs setup vs метадані CLI) - Ви шукаєте параметри точки входу sidebarTitle: Entry Points -summary: Довідник для definePluginEntry, defineChannelPluginEntry та defineSetupPluginEntry +summary: Довідка для definePluginEntry, defineChannelPluginEntry і defineSetupPluginEntry title: Точки входу Plugin x-i18n: - generated_at: "2026-04-15T16:36:52Z" + generated_at: "2026-04-21T22:18:59Z" model: gpt-5.4 provider: openai - source_hash: aabca25bc9b8ff1b5bb4852bafe83640ffeba006ea6b6a8eff4e2c37a10f1fe4 + source_hash: 304501849aa835b775f9b7b85c507aaeb532f90bf6473d7644f0e41144d9a914 source_path: plugins/sdk-entrypoints.md workflow: 15 --- # Точки входу Plugin -Кожен plugin експортує типовий об’єкт точки входу. SDK надає три хелпери для +Кожен plugin експортує типовий об’єкт точки входу. SDK надає три допоміжні функції для їх створення. +Для встановлених plugin-ів `package.json` має спрямовувати завантаження під час виконання на зібраний +JavaScript, коли він доступний: + +```json +{ + "openclaw": { + "extensions": ["./src/index.ts"], + "runtimeExtensions": ["./dist/index.js"], + "setupEntry": "./src/setup-entry.ts", + "runtimeSetupEntry": "./dist/setup-entry.js" + } +} +``` + +`extensions` і `setupEntry` залишаються чинними записами вихідного коду для розробки у workspace та git +checkout. `runtimeExtensions` і `runtimeSetupEntry` мають пріоритет, коли OpenClaw завантажує встановлений package, і дають змогу npm package-ам уникати компіляції TypeScript під час виконання. Якщо встановлений package оголошує лише запис вихідного коду TypeScript, OpenClaw використає відповідний зібраний `dist/*.js` peer, якщо він існує, а потім повернеться до вихідного коду TypeScript. + **Шукаєте покрокове пояснення?** Дивіться [Channel Plugins](/uk/plugins/sdk-channel-plugins) або [Provider Plugins](/uk/plugins/sdk-provider-plugins) для покрокових інструкцій. @@ -29,7 +46,7 @@ x-i18n: **Імпорт:** `openclaw/plugin-sdk/plugin-entry` -Для provider plugins, tool plugins, hook plugins і всього, що **не** є +Для plugin-ів провайдерів, plugin-ів інструментів, plugin-ів хуків і всього, що **не є** каналом обміну повідомленнями. ```typescript @@ -50,7 +67,7 @@ export default definePluginEntry({ }); ``` -| Поле | Тип | Обов’язково | Типово | +| Поле | Тип | Обов’язкове | Типове значення | | -------------- | ---------------------------------------------------------------- | ----------- | ------------------- | | `id` | `string` | Так | — | | `name` | `string` | Так | — | @@ -60,18 +77,18 @@ export default definePluginEntry({ | `register` | `(api: OpenClawPluginApi) => void` | Так | — | - `id` має збігатися з вашим маніфестом `openclaw.plugin.json`. -- `kind` призначений для ексклюзивних слотів: `"memory"` або `"context-engine"`. +- `kind` призначене для ексклюзивних слотів: `"memory"` або `"context-engine"`. - `configSchema` може бути функцією для лінивого обчислення. -- OpenClaw розв’язує та мемоїзує цю схему під час першого доступу, тож затратні - побудовники схем запускаються лише один раз. +- OpenClaw розв’язує та мемоізує цю схему під час першого доступу, тому дорогі + побудовники схем виконуються лише один раз. ## `defineChannelPluginEntry` **Імпорт:** `openclaw/plugin-sdk/channel-core` -Обгортає `definePluginEntry` логікою, специфічною для каналу. Автоматично викликає -`api.registerChannel({ plugin })`, відкриває необов’язковий шов метаданих CLI -для кореневої довідки та керує `registerFull` залежно від режиму реєстрації. +Обгортає `definePluginEntry` логікою, специфічною для каналів. Автоматично викликає +`api.registerChannel({ plugin })`, надає необов’язковий seam метаданих CLI для кореневої довідки та +обмежує `registerFull` відповідно до режиму реєстрації. ```typescript import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core"; @@ -91,7 +108,7 @@ export default defineChannelPluginEntry({ }); ``` -| Поле | Тип | Обов’язково | Типово | +| Поле | Тип | Обов’язкове | Типове значення | | --------------------- | ---------------------------------------------------------------- | ----------- | ------------------- | | `id` | `string` | Так | — | | `name` | `string` | Так | — | @@ -102,33 +119,33 @@ export default defineChannelPluginEntry({ | `registerCliMetadata` | `(api: OpenClawPluginApi) => void` | Ні | — | | `registerFull` | `(api: OpenClawPluginApi) => void` | Ні | — | -- `setRuntime` викликається під час реєстрації, щоб ви могли зберегти посилання - на runtime (зазвичай через `createPluginRuntimeStore`). Воно пропускається під час - захоплення метаданих CLI. -- `registerCliMetadata` виконується і під час `api.registrationMode === "cli-metadata"`, - і під час `api.registrationMode === "full"`. - Використовуйте його як канонічне місце для дескрипторів CLI, що належать каналу, - щоб коренева довідка не активувала plugin, а звичайна реєстрація команд CLI - залишалася сумісною з повним завантаженням plugin. +- `setRuntime` викликається під час реєстрації, тож ви можете зберегти посилання на runtime + (зазвичай через `createPluginRuntimeStore`). Воно пропускається під час захоплення + метаданих CLI. +- `registerCliMetadata` виконується як під час `api.registrationMode === "cli-metadata"`, + так і під час `api.registrationMode === "full"`. + Використовуйте його як канонічне місце для дескрипторів CLI, що належать каналу, щоб + коренева довідка залишалася без активації, а звичайна реєстрація команд CLI залишалася сумісною + з повним завантаженням plugin-ів. - `registerFull` виконується лише коли `api.registrationMode === "full"`. Воно пропускається - під час завантаження лише для налаштування. -- Як і в `definePluginEntry`, `configSchema` може бути лінивою фабрикою, а OpenClaw - мемоїзує розв’язану схему під час першого доступу. -- Для кореневих команд CLI, що належать plugin, віддавайте перевагу `api.registerCli(..., { descriptors: [...] })`, - коли хочете, щоб команда лишалася ліниво завантажуваною, але не зникала з - дерева розбору кореневого CLI. Для channel plugins краще реєструвати ці дескриптори - з `registerCliMetadata(...)`, а `registerFull(...)` залишати для суто runtime-роботи. -- Якщо `registerFull(...)` також реєструє методи Gateway RPC, тримайте їх у - префіксі, специфічному для plugin. Зарезервовані простори назв адміністрування ядра (`config.*`, - `exec.approvals.*`, `wizard.*`, `update.*`) завжди примусово переводяться до + під час завантаження лише для setup. +- Як і у `definePluginEntry`, `configSchema` може бути лінивою фабрикою, а OpenClaw + мемоізує розв’язану схему під час першого доступу. +- Для кореневих команд CLI, що належать plugin-у, віддавайте перевагу `api.registerCli(..., { descriptors: [...] })`, + якщо хочете, щоб команда залишалася ліниво завантажуваною без зникнення з + дерева розбору кореневого CLI. Для channel plugin-ів краще реєструвати ці дескриптори + з `registerCliMetadata(...)`, а `registerFull(...)` зосередити на роботі, потрібній лише під час виконання. +- Якщо `registerFull(...)` також реєструє методи Gateway RPC, залишайте їх на + префіксі, специфічному для plugin-а. Зарезервовані простори імен core admin (`config.*`, + `exec.approvals.*`, `wizard.*`, `update.*`) завжди примусово приводяться до `operator.admin`. ## `defineSetupPluginEntry` **Імпорт:** `openclaw/plugin-sdk/channel-core` -Для полегшеного файла `setup-entry.ts`. Повертає лише `{ plugin }` без -runtime або логіки CLI. +Для полегшеного файлу `setup-entry.ts`. Повертає лише `{ plugin }` без +логіки runtime або CLI. ```typescript import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core"; @@ -136,28 +153,27 @@ import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core"; export default defineSetupPluginEntry(myChannelPlugin); ``` -OpenClaw завантажує це замість повної точки входу, коли канал вимкнений, -не налаштований або коли ввімкнене відкладене завантаження. Дивіться -[Налаштування та конфігурація](/uk/plugins/sdk-setup#setup-entry), щоб зрозуміти, -коли це має значення. +OpenClaw завантажує це замість повної точки входу, коли канал вимкнено, +не налаштовано або коли ввімкнено відкладене завантаження. Див. +[Setup and Config](/uk/plugins/sdk-setup#setup-entry), щоб зрозуміти, коли це має значення. На практиці поєднуйте `defineSetupPluginEntry(...)` із вузькими сімействами -хелперів для налаштування: +допоміжних функцій setup: -- `openclaw/plugin-sdk/setup-runtime` для безпечних для runtime хелперів налаштування, таких як - безпечні для імпорту адаптери setup patch, виведення приміток пошуку, - `promptResolvedAllowFrom`, `splitSetupEntries` і делеговані проксі налаштування -- `openclaw/plugin-sdk/channel-setup` для поверхонь налаштування з необов’язковим встановленням -- `openclaw/plugin-sdk/setup-tools` для хелперів CLI/архіву/документації для налаштування/встановлення +- `openclaw/plugin-sdk/setup-runtime` для безпечних для runtime допоміжних функцій setup, таких як + import-safe адаптери патчів setup, вивід lookup-note, + `promptResolvedAllowFrom`, `splitSetupEntries` і делеговані проксі setup +- `openclaw/plugin-sdk/channel-setup` для поверхонь setup з необов’язковим встановленням +- `openclaw/plugin-sdk/setup-tools` для допоміжних функцій setup/install CLI/archive/docs Тримайте важкі SDK, реєстрацію CLI та довгоживучі runtime-сервіси в повній точці входу. -Вбудовані workspace channels, які розділяють поверхні налаштування та runtime, -можуть натомість використовувати `defineBundledChannelSetupEntry(...)` з -`openclaw/plugin-sdk/channel-entry-contract`. Цей контракт дозволяє точці входу -налаштування зберігати безпечні для setup експорти plugin/secrets і водночас -відкривати setter для runtime: +Вбудовані workspace-канали, які розділяють поверхні setup і runtime, можуть +замість цього використовувати `defineBundledChannelSetupEntry(...)` з +`openclaw/plugin-sdk/channel-entry-contract`. Цей контракт дає змогу +точці входу setup зберігати безпечні для setup експорти plugin/secrets, водночас надаючи +setter runtime: ```typescript import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entry-contract"; @@ -175,22 +191,22 @@ export default defineBundledChannelSetupEntry({ }); ``` -Використовуйте цей вбудований контракт лише тоді, коли потокам налаштування -справді потрібен полегшений setter runtime до завантаження повної точки входу каналу. +Використовуйте цей вбудований контракт лише тоді, коли потокам setup справді потрібен полегшений +setter runtime до завантаження повної точки входу каналу. ## Режим реєстрації -`api.registrationMode` повідомляє вашому plugin, як саме його було завантажено: +`api.registrationMode` повідомляє вашому plugin-у, як саме його було завантажено: -| Режим | Коли | Що реєструвати | -| ----------------- | --------------------------------- | --------------------------------------------------------------------------------------- | -| `"full"` | Звичайний запуск Gateway | Усе | -| `"setup-only"` | Вимкнений/неналаштований канал | Лише реєстрацію каналу | -| `"setup-runtime"` | Потік налаштування з доступним runtime | Реєстрацію каналу плюс лише полегшений runtime, потрібний до завантаження повної точки входу | -| `"cli-metadata"` | Коренева довідка / захоплення метаданих CLI | Лише дескриптори CLI | +| Режим | Коли | Що реєструвати | +| ---------------- | --------------------------------- | --------------------------------------------------------------------------------------- | +| `"full"` | Звичайний запуск Gateway | Усе | +| `"setup-only"` | Вимкнений/неналаштований канал | Лише реєстрацію каналу | +| `"setup-runtime"`| Потік setup із доступним runtime | Реєстрацію каналу плюс лише полегшений runtime, потрібний до завантаження повної точки входу | +| `"cli-metadata"` | Коренева довідка / захоплення метаданих CLI | Лише дескриптори CLI | -`defineChannelPluginEntry` обробляє цей поділ автоматично. Якщо ви використовуєте -`definePluginEntry` напряму для каналу, перевіряйте режим самостійно: +`defineChannelPluginEntry` обробляє це розділення автоматично. Якщо ви використовуєте +`definePluginEntry` безпосередньо для каналу, перевіряйте режим самостійно: ```typescript register(api) { @@ -202,42 +218,42 @@ register(api) { api.registerChannel({ plugin: myPlugin }); if (api.registrationMode !== "full") return; - // Важкі реєстрації лише для runtime + // Heavy runtime-only registrations api.registerService(/* ... */); } ``` -Сприймайте `"setup-runtime"` як вікно, у якому поверхні запуску лише для налаштування -мають існувати без повторного входу в повний runtime вбудованого каналу. Добре -підходять реєстрація каналу, безпечні для setup HTTP-маршрути, безпечні для setup -методи Gateway і делеговані хелпери налаштування. Важкі фонові сервіси, реєстратори CLI -та ініціалізація provider/client SDK усе ще мають належати до `"full"`. +Розглядайте `"setup-runtime"` як вікно, у якому поверхні запуску лише для setup +мають існувати без повторного входу в повний вбудований runtime каналу. Добре підходять +реєстрація каналу, безпечні для setup HTTP-маршрути, безпечні для setup методи Gateway і +делеговані допоміжні функції setup. Важкі фонові сервіси, реєстратори CLI та +завантаження SDK провайдерів/клієнтів, як і раніше, мають належати `"full"`. Зокрема для реєстраторів CLI: - використовуйте `descriptors`, коли реєстратор володіє однією або кількома кореневими командами і ви хочете, щоб OpenClaw ліниво завантажував справжній модуль CLI під час першого виклику -- переконайтеся, що ці дескриптори охоплюють кожен корінь команди верхнього рівня, який відкриває +- переконайтеся, що ці дескриптори охоплюють кожний корінь команди верхнього рівня, який відкриває реєстратор -- використовуйте лише `commands` тільки для eager-шляхів сумісності +- використовуйте лише `commands` тільки для шляхів сумісності з eager-завантаженням -## Форми plugin +## Форми plugin-ів -OpenClaw класифікує завантажені plugins за їхньою поведінкою під час реєстрації: +OpenClaw класифікує завантажені plugin-и за їхньою поведінкою під час реєстрації: -| Форма | Опис | -| --------------------- | -------------------------------------------------- | -| **plain-capability** | Один тип capability (наприклад, лише provider) | +| Форма | Опис | +| --------------------- | ------------------------------------------------- | +| **plain-capability** | Один тип capability (наприклад, лише provider) | | **hybrid-capability** | Кілька типів capability (наприклад, provider + speech) | -| **hook-only** | Лише hooks, без capability | -| **non-capability** | Tools/commands/services, але без capability | +| **hook-only** | Лише hooks, без capabilities | +| **non-capability** | Tools/commands/services, але без capabilities | -Використовуйте `openclaw plugins inspect `, щоб побачити форму plugin. +Використовуйте `openclaw plugins inspect `, щоб побачити форму plugin-а. -## Пов’язані матеріали +## Пов’язане -- [Огляд SDK](/uk/plugins/sdk-overview) — API реєстрації та довідник за subpath -- [Хелпери runtime](/uk/plugins/sdk-runtime) — `api.runtime` і `createPluginRuntimeStore` -- [Налаштування та конфігурація](/uk/plugins/sdk-setup) — маніфест, точка входу налаштування, відкладене завантаження +- [SDK Overview](/uk/plugins/sdk-overview) — API реєстрації та довідка щодо subpath +- [Runtime Helpers](/uk/plugins/sdk-runtime) — `api.runtime` і `createPluginRuntimeStore` +- [Setup and Config](/uk/plugins/sdk-setup) — маніфест, точка входу setup, відкладене завантаження - [Channel Plugins](/uk/plugins/sdk-channel-plugins) — побудова об’єкта `ChannelPlugin` -- [Provider Plugins](/uk/plugins/sdk-provider-plugins) — реєстрація provider та hooks +- [Provider Plugins](/uk/plugins/sdk-provider-plugins) — реєстрація провайдерів і hooks diff --git a/docs/uk/tools/clawhub.md b/docs/uk/tools/clawhub.md index 6d7b23a8f..8be992df4 100644 --- a/docs/uk/tools/clawhub.md +++ b/docs/uk/tools/clawhub.md @@ -1,27 +1,27 @@ --- read_when: - Представлення ClawHub новим користувачам - - Установлення, пошук або публікація Skills чи plugins - - Пояснення прапорців ClawHub CLI і поведінки sync -summary: 'Посібник з ClawHub: публічний реєстр, нативні сценарії встановлення OpenClaw і робочі процеси ClawHub CLI' + - Встановлення, пошук або публікація Skills чи plugin-ів + - Пояснення прапорців CLI ClawHub і поведінки синхронізації +summary: 'Посібник ClawHub: публічний реєстр, нативні сценарії встановлення OpenClaw і робочі процеси CLI ClawHub' title: ClawHub x-i18n: - generated_at: "2026-04-05T18:19:30Z" + generated_at: "2026-04-21T22:18:59Z" model: gpt-5.4 provider: openai - source_hash: e65b3fd770ca96a5dd828dce2dee4ef127268f4884180a912f43d7744bc5706f + source_hash: 88980eb2f48c5298aec5b697e8e50762c3df5a4114f567e69424a1cb36e5102e source_path: tools/clawhub.md workflow: 15 --- # ClawHub -ClawHub — це публічний реєстр для **Skills і plugins OpenClaw**. +ClawHub — це публічний реєстр для **Skills і plugin-ів OpenClaw**. - Використовуйте нативні команди `openclaw` для пошуку/встановлення/оновлення Skills і встановлення - plugins з ClawHub. -- Використовуйте окремий CLI `clawhub`, коли потрібні автентифікація реєстру, публікація, видалення, - відновлення або робочі процеси sync. + plugin-ів із ClawHub. +- Використовуйте окремий CLI `clawhub`, коли вам потрібні автентифікація реєстру, публікація, видалення, + відновлення або робочі процеси синхронізації. Сайт: [clawhub.ai](https://clawhub.ai) @@ -42,7 +42,7 @@ openclaw plugins install clawhub: openclaw plugins update --all ``` -Специфікації plugins у простому npm-safe форматі також перевіряються в ClawHub перед npm: +Специфікації plugin-ів у простому форматі, безпечному для npm, також перевіряються в ClawHub перед npm: ```bash openclaw plugins install openclaw-codex-app-server @@ -51,57 +51,57 @@ openclaw plugins install openclaw-codex-app-server Нативні команди `openclaw` встановлюють у ваш активний workspace і зберігають метадані джерела, щоб подальші виклики `update` могли залишатися в ClawHub. -Під час установлення plugins перевіряється сумісність заявлених `pluginApi` і `minGatewayVersion` -ще до запуску встановлення архіву, тому несумісні хости рано завершуються у безпечний спосіб -замість часткового встановлення пакета. +Встановлення plugin-ів перевіряє заявлену сумісність `pluginApi` і `minGatewayVersion` +до запуску встановлення архіву, тож несумісні хости рано завершуються в безпечному режимі, +замість часткового встановлення пакунка. -`openclaw plugins install clawhub:...` приймає лише сімейства plugins, які можна встановити. -Якщо пакет ClawHub насправді є skill, OpenClaw зупиняється і натомість вказує вам на -`openclaw skills install `. +`openclaw plugins install clawhub:...` приймає лише сімейства plugin-ів, які можна встановити. +Якщо пакунок ClawHub насправді є skill, OpenClaw зупиниться й натомість вкаже вам +на `openclaw skills install `. ## Що таке ClawHub -- Публічний реєстр для Skills і plugins OpenClaw. -- Версіоноване сховище пакетів skills і метаданих. +- Публічний реєстр для Skills і plugin-ів OpenClaw. +- Версійне сховище bundle-ів Skills і метаданих. - Поверхня виявлення для пошуку, тегів і сигналів використання. ## Як це працює -1. Користувач публікує пакет skill (файли + метадані). -2. ClawHub зберігає пакет, аналізує метадані та призначає версію. +1. Користувач публікує bundle skill-а (файли + метадані). +2. ClawHub зберігає bundle, розбирає метадані й призначає версію. 3. Реєстр індексує skill для пошуку й виявлення. 4. Користувачі переглядають, завантажують і встановлюють Skills в OpenClaw. -## Що можна робити +## Що ви можете робити - Публікувати нові Skills і нові версії наявних Skills. -- Знаходити Skills за назвою, тегами або пошуком. -- Завантажувати пакети skills і переглядати їхні файли. -- Повідомляти про Skills, які є шкідливими або небезпечними. +- Знаходити Skills за назвою, тегами або через пошук. +- Завантажувати bundle-и Skills і переглядати їхні файли. +- Повідомляти про Skills, які є зловмисними або небезпечними. - Якщо ви модератор, приховувати, показувати, видаляти або банити. -## Для кого це призначено (зручно для початківців) +## Для кого це (дружньо до початківців) -Якщо ви хочете додати нові можливості своєму агенту OpenClaw, ClawHub — найпростіший спосіб знайти та встановити Skills. Вам не потрібно знати, як працює бекенд. Ви можете: +Якщо ви хочете додати нові можливості до свого агента OpenClaw, ClawHub — це найпростіший спосіб знайти й установити Skills. Вам не потрібно знати, як працює бекенд. Ви можете: - Шукати Skills звичайною мовою. -- Установлювати skill у свій workspace. +- Установити skill у свій workspace. - Пізніше оновлювати Skills однією командою. -- Робити резервні копії власних Skills через публікацію. +- Робити резервні копії власних Skills, публікуючи їх. -## Швидкий старт (без технічних деталей) +## Швидкий старт (нетехнічний) 1. Знайдіть те, що вам потрібно: - `openclaw skills search "calendar"` 2. Установіть skill: - `openclaw skills install ` 3. Запустіть нову сесію OpenClaw, щоб він підхопив новий skill. -4. Якщо ви хочете публікувати або керувати автентифікацією реєстру, також установіть окремий - CLI `clawhub`. +4. Якщо ви хочете публікувати або керувати автентифікацією реєстру, також установіть + окремий CLI `clawhub`. -## Установлення ClawHub CLI +## Установлення CLI ClawHub -Він потрібен лише для робочих процесів з автентифікацією реєстру, таких як publish/sync: +Це потрібно лише для робочих процесів з автентифікацією реєстру, таких як publish/sync: ```bash npm i -g clawhub @@ -115,87 +115,87 @@ pnpm add -g clawhub Нативна команда `openclaw skills install` встановлює в каталог `skills/` активного workspace. `openclaw plugins install clawhub:...` записує звичайне кероване -встановлення plugin плюс метадані джерела ClawHub для оновлень. +встановлення plugin-а разом із метаданими джерела ClawHub для оновлень. -Анонімні встановлення plugins з ClawHub також безпечно завершуються для приватних пакетів. -Спільнота або інші неофіційні канали все ще можуть виконати встановлення, але OpenClaw попереджає, -щоб оператори могли перевірити джерело й валідацію перед увімкненням. +Анонімні встановлення plugin-ів із ClawHub також безпечно завершуються помилкою для приватних пакунків. +Plugin-и спільноти або інших неофіційних каналів усе ще можна встановити, але OpenClaw попереджає, +щоб оператори могли перевірити джерело та верифікацію перед увімкненням. Окремий CLI `clawhub` також установлює Skills у `./skills` у вашому поточному робочому каталозі. Якщо налаштовано workspace OpenClaw, `clawhub` перемикається на цей workspace, якщо ви не перевизначите `--workdir` (або -`CLAWHUB_WORKDIR`). OpenClaw завантажує Skills workspace з `/skills` -і підхоплює їх у **наступній** сесії. Якщо ви вже використовуєте +`CLAWHUB_WORKDIR`). OpenClaw завантажує Skills workspace із `/skills` +і підхопить їх у **наступній** сесії. Якщо ви вже використовуєте `~/.openclaw/skills` або вбудовані Skills, Skills workspace мають пріоритет. Докладніше про те, як Skills завантажуються, спільно використовуються й обмежуються, див. -у [Skills](/tools/skills). +[Skills](/uk/tools/skills). ## Огляд системи Skills -Skill — це версіонований пакет файлів, який навчає OpenClaw виконувати +Skill — це bundle файлів із версіями, який навчає OpenClaw виконувати певне завдання. Кожна публікація створює нову версію, а реєстр зберігає історію версій, щоб користувачі могли перевіряти зміни. Типовий skill містить: - Файл `SKILL.md` з основним описом і використанням. -- Необов’язкові конфігурації, scripts або допоміжні файли, які використовує skill. -- Метадані, такі як теги, summary і вимоги до встановлення. +- Необов’язкові конфігурації, скрипти або допоміжні файли, які використовує skill. +- Метадані, як-от теги, стислий опис і вимоги до встановлення. -ClawHub використовує метадані для покращення виявлення та безпечного відкриття можливостей Skills. -Реєстр також відстежує сигнали використання (наприклад, stars і downloads), щоб покращувати +ClawHub використовує метадані для виявлення й безпечного показу можливостей skill-а. +Реєстр також відстежує сигнали використання (наприклад, зірки та завантаження), щоб покращувати ранжування та видимість. ## Що надає сервіс (можливості) - **Публічний перегляд** Skills та їхнього вмісту `SKILL.md`. - **Пошук** на основі embeddings (векторний пошук), а не лише ключових слів. -- **Контроль версій** із semver, changelog-ами й тегами (включно з `latest`). +- **Керування версіями** із semver, changelog-ами й тегами (включно з `latest`). - **Завантаження** як zip для кожної версії. -- **Stars і comments** для зворотного зв’язку спільноти. -- **Гачки moderation** для схвалень і аудитів. -- **CLI-friendly API** для автоматизації та сценаріїв. +- **Зірки та коментарі** для зворотного зв’язку від спільноти. +- **Механізми модерації** для схвалень і аудитів. +- **CLI-дружній API** для автоматизації та скриптів. -## Безпека та moderation +## Безпека й модерація -ClawHub за замовчуванням відкритий. Завантажувати Skills може будь-хто, але для -публікації обліковий запис GitHub має існувати щонайменше один тиждень. Це допомагає стримувати -зловживання, не блокуючи легітимних учасників. +ClawHub відкритий за замовчуванням. Будь-хто може завантажувати Skills, але для публікації +обліковому запису GitHub має бути щонайменше один тиждень. Це допомагає стримувати зловживання, +не блокуючи добросовісних учасників. -Скарги й moderation: +Скарги й модерація: -- Будь-який користувач, який увійшов у систему, може поскаржитися на skill. +- Будь-який користувач, що ввійшов у систему, може поскаржитися на skill. - Причини скарги є обов’язковими та записуються. -- Кожен користувач може мати не більше 20 активних скарг одночасно. -- Skills із понад 3 унікальними скаргами типово приховуються автоматично. -- Модератори можуть переглядати приховані Skills, показувати їх знову, видаляти або банити користувачів. -- Зловживання функцією скарг може призвести до бану облікового запису. +- Кожен користувач може мати до 20 активних скарг одночасно. +- Skills із понад 3 унікальними скаргами автоматично приховуються за замовчуванням. +- Модератори можуть переглядати приховані Skills, показувати їх, видаляти або банити користувачів. +- Зловживання функцією скарг може призвести до блокування облікового запису. -Хочете стати модератором? Запитайте в Discord OpenClaw і зв’яжіться з -модератором або супровідником. +Цікавитеся роллю модератора? Запитайте в Discord OpenClaw і зв’яжіться з +модератором або супроводжувачем. -## Команди CLI і параметри +## Команди й параметри CLI Глобальні параметри (застосовуються до всіх команд): -- `--workdir `: Робочий каталог (типово: поточний каталог; якщо можливо, використовується workspace OpenClaw). -- `--dir `: Каталог Skills відносно workdir (типово: `skills`). +- `--workdir `: Робочий каталог (типово: поточний каталог; із переходом до workspace OpenClaw). +- `--dir `: Каталог Skills, відносний до workdir (типово: `skills`). - `--site `: Базова URL-адреса сайту (вхід через браузер). - `--registry `: Базова URL-адреса API реєстру. -- `--no-input`: Вимкнути prompts (неінтерактивний режим). +- `--no-input`: Вимкнути запити (неінтерактивний режим). - `-V, --cli-version`: Вивести версію CLI. Автентифікація: -- `clawhub login` (потік через браузер) або `clawhub login --token ` +- `clawhub login` (сценарій через браузер) або `clawhub login --token ` - `clawhub logout` - `clawhub whoami` Параметри: -- `--token `: Вставити API token. -- `--label