openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-22 23:53:14 +00:00
parent 488a849ce6
commit c42f8afccc
3 changed files with 632 additions and 594 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

872
docs/uk/help/testing.md
View File

File diff suppressed because it is too large Load Diff

177
docs/uk/plugins/bundles.md
View File

@ -3,33 +3,41 @@ read_when:
- Ви хочете встановити пакет, сумісний із Codex, Claude або Cursor
- Вам потрібно зрозуміти, як OpenClaw зіставляє вміст пакета з нативними можливостями
- Ви налагоджуєте виявлення пакета або відсутні можливості
summary: Установлення та використання пакетів Codex, Claude і Cursor як плагінів OpenClaw
title: Пакети плагінів
summary: Встановлюйте та використовуйте пакети Codex, Claude і Cursor як плагіни OpenClaw
title: Набори плагінів
x-i18n:
generated_at: "2026-04-05T18:11:52Z"
generated_at: "2026-04-22T23:49:19Z"
model: gpt-5.4
provider: openai
source_hash: a8b1eb4633bdff75425d8c2e29be352e11a4cdad7f420c0c66ae5ef07bf9bdcc
source_hash: 91fec13cb1f807231c706318f3e81e27b350d5a0266821cb96c8494c45f01de0
source_path: plugins/bundles.md
workflow: 15
---
# Пакети плагінів
# Набори плагінів
OpenClaw може встановлювати плагіни з трьох зовнішніх екосистем: **Codex**, **Claude** і **Cursor**. Вони називаються **пакетами** — наборами вмісту та метаданих, які OpenClaw зіставляє з нативними можливостями, як-от Skills, hooks і інструменти MCP.
OpenClaw може встановлювати плагіни з трьох зовнішніх екосистем: **Codex**, **Claude**
і **Cursor**. Вони називаються **пакетами** — наборами вмісту та метаданих, які
OpenClaw зіставляє з нативними можливостями, як-от Skills, хуки та інструменти MCP.
<Info>
Пакети **не** є тим самим, що й нативні плагіни OpenClaw. Нативні плагіни працюють у процесі й можуть реєструвати будь-які можливості. Пакети є наборами вмісту з вибірковим зіставленням можливостей і вужчою межею довіри.
Пакети **не** є тим самим, що й нативні плагіни OpenClaw. Нативні плагіни працюють
у межах процесу та можуть реєструвати будь-яку можливість. Пакети — це набори
вмісту з вибірковим зіставленням можливостей і вужчою межею довіри.
</Info>
## Навіщо існують пакети
Багато корисних плагінів публікуються у форматах Codex, Claude або Cursor. Замість того щоб змушувати авторів переписувати їх як нативні плагіни OpenClaw, OpenClaw виявляє ці формати й зіставляє підтримуваний у них вміст із нативним набором можливостей. Це означає, що ви можете встановити набір команд Claude або пакет Skills Codex і відразу почати ним користуватися.
Багато корисних плагінів публікуються у форматі Codex, Claude або Cursor. Замість
того щоб змушувати авторів переписувати їх як нативні плагіни OpenClaw, OpenClaw
виявляє ці формати та зіставляє підтримуваний у них вміст із нативним набором
можливостей. Це означає, що ви можете встановити пакет команд Claude або пакет
Skills для Codex і одразу почати ним користуватися.
## Установлення пакета
## Встановлення пакета
<Steps>
<Step title="Установлення з каталогу, архіву або marketplace">
<Step title="Встановіть із каталогу, архіву або marketplace">
```bash
# Локальний каталог
openclaw plugins install ./my-bundle
@ -37,14 +45,14 @@ OpenClaw може встановлювати плагіни з трьох зов
# Архів
openclaw plugins install ./my-bundle.tgz
# Marketplace Claude
# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>
```
</Step>
<Step title="Перевірка виявлення">
<Step title="Перевірте виявлення">
```bash
openclaw plugins list
openclaw plugins inspect <id>
@ -54,52 +62,62 @@ OpenClaw може встановлювати плагіни з трьох зов
</Step>
<Step title="Перезапуск і використання">
<Step title="Перезапустіть і використовуйте">
```bash
openclaw gateway restart
```
Зіставлені можливості (Skills, hooks, інструменти MCP, типові значення LSP) будуть доступні в наступному сеансі.
Зіставлені можливості (Skills, хуки, інструменти MCP, типові налаштування LSP) будуть доступні в наступному сеансі.
</Step>
</Steps>
## Що OpenClaw зіставляє з пакетів
Не всі можливості пакетів сьогодні виконуються в OpenClaw. Нижче наведено, що працює, а що виявляється, але ще не підключене.
Сьогодні в OpenClaw працюють не всі можливості пакетів. Нижче наведено, що
працює, а що виявляється, але ще не підключене.
### Підтримується зараз
| Можливість | Як зіставляється | Застосовується до |
| ------------- | ------------------------------------------------------------------------------------------- | -------------- |
| Вміст Skills | Корені Skills пакетів завантажуються як звичайні Skills OpenClaw | Усі формати |
| Команди | `commands/` і `.cursor/commands/` обробляються як корені Skills | Claude, Cursor |
| Пакети hooks | Макети в стилі OpenClaw `HOOK.md` + `handler.ts` | Codex |
| Інструменти MCP | Конфігурація MCP пакета об’єднується з вбудованими налаштуваннями Pi; завантажуються підтримувані сервери stdio і HTTP | Усі формати |
| Сервери LSP | Claude `.lsp.json` і оголошені в маніфесті `lspServers` об’єднуються з типовими значеннями LSP вбудованого Pi | Claude |
| Налаштування | Claude `settings.json` імпортується як типові значення вбудованого Pi | Claude |
| Можливість | Як зіставляється | Застосовується до |
| ------------- | ------------------------------------------------------------------------------------------ | ----------------- |
| Вміст Skills | Кореневі каталоги Skills пакета завантажуються як звичайні Skills OpenClaw | Усі формати |
| Команди | `commands/` і `.cursor/commands/` обробляються як кореневі каталоги Skills | Claude, Cursor |
| Пакети хуків | Макети у стилі OpenClaw з `HOOK.md` + `handler.ts` | Codex |
| Інструменти MCP | Конфігурація MCP пакета об’єднується з вбудованими налаштуваннями Pi; підтримувані сервери stdio та HTTP завантажуються | Усі формати |
| Сервери LSP | Claude `.lsp.json` і оголошені в маніфесті `lspServers` об’єднуються з типовими налаштуваннями LSP вбудованого Pi | Claude |
| Налаштування | Claude `settings.json` імпортується як типові налаштування вбудованого Pi | Claude |
#### Вміст Skills
- корені Skills пакетів завантажуються як звичайні корені Skills OpenClaw
- корені Claude `commands` обробляються як додаткові корені Skills
- корені Cursor `.cursor/commands` обробляються як додаткові корені Skills
- кореневі каталоги Skills пакета завантажуються як звичайні кореневі каталоги Skills OpenClaw
- корені Claude `commands` обробляються як додаткові кореневі каталоги Skills
- корені Cursor `.cursor/commands` обробляються як додаткові кореневі каталоги Skills
Це означає, що markdown-файли команд Claude працюють через звичайний завантажувач Skills OpenClaw. Markdown-команди Cursor працюють через той самий шлях.
Це означає, що markdown-файли команд Claude працюють через звичайний завантажувач
Skills в OpenClaw. Markdown-команди Cursor працюють через той самий шлях.
#### Пакети hooks
#### Пакети хуків
- корені hooks пакета працюють **лише** тоді, коли вони використовують звичайний макет пакета hooks OpenClaw. Сьогодні це переважно випадок сумісності з Codex:
- кореневі каталоги хуків пакета працюють **лише** тоді, коли вони використовують
звичайний макет пакета хуків OpenClaw. Сьогодні це переважно випадок сумісності з Codex:
- `HOOK.md`
- `handler.ts` або `handler.js`
#### MCP для Pi
- увімкнені пакети можуть додавати конфігурацію сервера MCP
- OpenClaw об’єднує конфігурацію MCP пакета в ефективні вбудовані налаштування Pi як `mcpServers`
- OpenClaw надає підтримувані інструменти MCP пакета під час ходів агента вбудованого Pi, запускаючи сервери stdio або підключаючись до HTTP-серверів
- локальні для проєкту налаштування Pi застосовуються після типових значень пакета, тому налаштування робочого простору можуть за потреби перевизначати записи MCP пакета
- каталоги інструментів MCP пакета сортуються детерміновано перед реєстрацією, щоб зміни у порядку `listTools()` на рівні джерела не розхитували блоки інструментів у prompt-cache
- OpenClaw об’єднує конфігурацію MCP пакета з ефективними вбудованими налаштуваннями Pi як
`mcpServers`
- OpenClaw показує підтримувані інструменти MCP пакета під час ходів агента вбудованого Pi,
запускаючи сервери stdio або підключаючись до HTTP-серверів
- профілі інструментів `coding` і `messaging` типово включають інструменти MCP пакета;
використовуйте `tools.deny: ["bundle-mcp"]`, щоб вимкнути їх для агента або Gateway
- локальні налаштування Pi для проєкту все одно застосовуються після типових налаштувань пакета,
тож за потреби налаштування робочого простору можуть перевизначати записи MCP пакета
- каталоги інструментів MCP пакета сортуються детерміновано перед реєстрацією, щоб
зміни у вихідному порядку `listTools()` не спричиняли нестабільність блоків
інструментів prompt-cache
##### Транспорти
@ -121,7 +139,7 @@ OpenClaw може встановлювати плагіни з трьох зов
}
```
**HTTP** підключається до запущеного MCP-сервера через `sse` типово або через `streamable-http`, якщо це запитано:
**HTTP** підключається до вже запущеного сервера MCP через `sse` типово або через `streamable-http`, якщо це запитано:
```json
{
@ -140,27 +158,36 @@ OpenClaw може встановлювати плагіни з трьох зов
}
```
- `transport` можна встановити як `"streamable-http"` або `"sse"`; якщо не вказано, OpenClaw використовує `sse`
- дозволено лише схеми URL `http:` і `https:`
- значення `headers` підтримують інтерполяцію `${ENV_VAR}`
- запис сервера, який містить і `command`, і `url`, відхиляється
- облікові дані URL (userinfo і параметри запиту) редагуються в описах інструментів і журналах
- `connectionTimeoutMs` перевизначає типове 30-секундне обмеження часу підключення як для транспорту stdio, так і для HTTP
- `transport` можна встановити в `"streamable-http"` або `"sse"`; якщо його пропущено, OpenClaw використовує `sse`
- дозволені лише схеми URL `http:` і `https:`
- значення `headers` підтримують підстановку `${ENV_VAR}`
- запис сервера, що містить одночасно `command` і `url`, відхиляється
- облікові дані URL (userinfo і параметри запиту) редагуються в описах інструментів
і журналах
- `connectionTimeoutMs` перевизначає типовий 30-секундний тайм-аут підключення
як для транспортів stdio, так і для HTTP
##### Іменування інструментів
OpenClaw реєструє інструменти MCP пакета з безпечними для провайдера іменами у форматі `serverName__toolName`. Наприклад, сервер із ключем `"vigil-harbor"`, який надає інструмент `memory_search`, реєструється як `vigil-harbor__memory_search`.
OpenClaw реєструє інструменти MCP пакета з безпечними для провайдерів іменами у форматі
`serverName__toolName`. Наприклад, сервер із ключем `"vigil-harbor"`, який надає
інструмент `memory_search`, реєструється як `vigil-harbor__memory_search`.
- символи поза межами `A-Za-z0-9_-` замінюються на `-`
- префікси серверів обмежуються 30 символами
- повні назви інструментів обмежуються 64 символами
- порожні назви серверів замінюються на `mcp`
- конфліктні санітизовані назви розрізняються числовими суфіксами
- остаточний порядок видимих інструментів є детермінованим за безпечною назвою, щоб повторні ходи Pi залишалися стабільними для кешу
- остаточний порядок видимих інструментів є детермінованим за безпечною назвою, щоб
повторні ходи Pi залишалися стабільними для кешу
- фільтрація профілю розглядає всі інструменти з одного MCP-сервера пакета як такі,
що належать плагіну `bundle-mcp`, тому списки дозволів і заборон профілю можуть
містити або окремі видимі назви інструментів, або ключ плагіна `bundle-mcp`
#### Вбудовані налаштування Pi
#### Налаштування вбудованого Pi
- Claude `settings.json` імпортується як типові вбудовані налаштування Pi, коли пакет увімкнено
- Claude `settings.json` імпортується як типові налаштування вбудованого Pi, коли
пакет увімкнено
- OpenClaw санітизує ключі перевизначення оболонки перед застосуванням
Санітизовані ключі:
@ -168,20 +195,21 @@ OpenClaw реєструє інструменти MCP пакета з безпе
- `shellPath`
- `shellCommandPrefix`
#### Вбудований LSP Pi
#### Вбудований Pi LSP
- увімкнені пакети Claude можуть додавати конфігурацію сервера LSP
- OpenClaw завантажує `.lsp.json`, а також будь-які шляхи `lspServers`, оголошені в маніфесті
- конфігурація LSP пакета об’єднується з ефективними типовими значеннями LSP вбудованого Pi
- сьогодні можна запускати лише підтримувані LSP-сервери на основі stdio; непідтримувані транспорти все одно відображаються в `openclaw plugins inspect <id>`
- конфігурація LSP пакета об’єднується з ефективними типовими налаштуваннями LSP вбудованого Pi
- сьогодні можна запускати лише підтримувані LSP-сервери на основі stdio; непідтримувані
транспорти все одно відображаються в `openclaw plugins inspect <id>`
### Виявляється, але не виконується
Ці можливості розпізнаються і показуються в діагностиці, але OpenClaw їх не виконує:
Ці можливості розпізнаються та показуються в діагностиці, але OpenClaw їх не запускає:
- Claude `agents`, автоматизація `hooks.json`, `outputStyles`
- Cursor `.cursor/agents`, `.cursor/hooks.json`, `.cursor/rules`
- Вбудовані/застосункові метадані Codex поза межами звітування про можливості
- вбудовані/застосункові метадані Codex поза межами звітності про можливості
## Формати пакетів
@ -191,7 +219,8 @@ OpenClaw реєструє інструменти MCP пакета з безпе
Необов’язковий вміст: `skills/`, `hooks/`, `.mcp.json`, `.app.json`
Пакети Codex найкраще підходять для OpenClaw, коли вони використовують корені Skills і каталоги пакетів hooks у стилі OpenClaw (`HOOK.md` + `handler.ts`).
Пакети Codex найкраще підходять для OpenClaw, коли використовують кореневі каталоги Skills
та каталоги пакетів хуків у стилі OpenClaw (`HOOK.md` + `handler.ts`).
</Accordion>
@ -204,11 +233,11 @@ OpenClaw реєструє інструменти MCP пакета з безпе
Специфічна поведінка Claude:
- `commands/` обробляється як вміст Skills
- `settings.json` імпортується у вбудовані налаштування Pi (ключі перевизначення оболонки санітизуються)
- `.mcp.json` надає підтримувані інструменти stdio для вбудованого Pi
- `.lsp.json` разом із шляхами `lspServers`, оголошеними в маніфесті, завантажуються у типові значення LSP вбудованого Pi
- `settings.json` імпортується в налаштування вбудованого Pi (ключі перевизначення оболонки санітизуються)
- `.mcp.json` показує підтримувані інструменти stdio для вбудованого Pi
- `.lsp.json` разом із шляхами `lspServers`, оголошеними в маніфесті, завантажується до типових налаштувань LSP вбудованого Pi
- `hooks/hooks.json` виявляється, але не виконується
- користувацькі шляхи компонентів у маніфесті є адитивними (вони розширюють типові значення, а не замінюють їх)
- спеціальні шляхи компонентів у маніфесті є адитивними (вони розширюють типові значення, а не замінюють їх)
</Accordion>
@ -225,46 +254,52 @@ OpenClaw реєструє інструменти MCP пакета з безпе
## Пріоритет виявлення
OpenClaw спочатку перевіряє нативний формат плагіна:
OpenClaw спочатку перевіряє формат нативного плагіна:
1. `openclaw.plugin.json` або коректний `package.json` з `openclaw.extensions` — обробляється як **нативний плагін**
1. `openclaw.plugin.json` або дійсний `package.json` з `openclaw.extensions` — обробляється як **нативний плагін**
2. Маркери пакетів (`.codex-plugin/`, `.claude-plugin/` або типовий макет Claude/Cursor) — обробляються як **пакет**
Якщо каталог містить обидва варіанти, OpenClaw використовує нативний шлях. Це запобігає частковому встановленню пакетів із подвійним форматом як пакетів.
Якщо каталог містить обидва варіанти, OpenClaw використовує нативний шлях. Це запобігає
частковому встановленню пакетів подвійного формату як пакетів.
## Безпека
Пакети мають вужчу межу довіри, ніж нативні плагіни:
- OpenClaw **не** завантажує довільні runtime-модулі пакета в процес
- шляхи Skills і пакетів hooks мають залишатися в межах кореня плагіна (перевірка меж)
- файли налаштувань читаються з тими самими перевірками меж
- підтримувані сервери stdio MCP можуть запускатися як підпроцеси
- OpenClaw **не** завантажує довільні runtime-модулі пакета у межах процесу
- шляхи Skills і пакетів хуків мають залишатися всередині кореня плагіна (із перевіркою меж)
- файли налаштувань читаються з тією самою перевіркою меж
- підтримувані сервери MCP на stdio можуть запускатися як підпроцеси
Це робить пакети безпечнішими типово, але вам усе одно слід вважати сторонні пакети довіреним вмістом для тих можливостей, які вони все ж надають.
Це робить пакети безпечнішими типово, але вам усе одно слід вважати сторонні
пакети довіреним вмістом для тих можливостей, які вони все ж надають.
## Усунення неполадок
## Усунення несправностей
<AccordionGroup>
<Accordion title="Пакет виявляється, але можливості не працюють">
Виконайте `openclaw plugins inspect <id>`. Якщо можливість указано, але позначено як не підключену, це обмеження продукту, а не зламана інсталяція.
Виконайте `openclaw plugins inspect <id>`. Якщо можливість перелічено, але позначено як
не підключену, це обмеження продукту, а не проблема встановлення.
</Accordion>
<Accordion title="Файли команд Claude не з’являються">
Переконайтеся, що пакет увімкнено, а markdown-файли розташовані всередині виявленого кореня `commands/` або `skills/`.
Переконайтеся, що пакет увімкнено, а markdown-файли розташовані всередині
виявленого кореня `commands/` або `skills/`.
</Accordion>
<Accordion title="Налаштування Claude не застосовуються">
Підтримуються лише вбудовані налаштування Pi з `settings.json`. OpenClaw не обробляє налаштування пакета як необроблені патчі конфігурації.
Підтримуються лише налаштування вбудованого Pi із `settings.json`. OpenClaw
не розглядає налаштування пакета як сирі патчі конфігурації.
</Accordion>
<Accordion title="Hooks Claude не виконуються">
`hooks/hooks.json` лише виявляється. Якщо вам потрібні hooks, які можна виконувати, використовуйте макет пакета hooks OpenClaw або постачайте нативний плагін.
<Accordion title="Хуки Claude не виконуються">
`hooks/hooks.json` лише виявляється. Якщо вам потрібні виконувані хуки, використовуйте
макет пакета хуків OpenClaw або постачайте нативний плагін.
</Accordion>
</AccordionGroup>
## Пов’язане
- [Установлення та налаштування плагінів](/tools/plugin)
- [Створення плагінів](/plugins/building-plugins) — створення нативного плагіна
- [Маніфест плагіна](/plugins/manifest) — схема нативного маніфесту
- [Встановлення та налаштування плагінів](/uk/tools/plugin)
- [Створення плагінів](/uk/plugins/building-plugins) — створіть нативний плагін
- [Маніфест плагіна](/uk/plugins/manifest) — схема нативного маніфесту

177
docs/uk/tools/index.md
View File

@ -2,25 +2,25 @@
read_when:
- Ви хочете зрозуміти, які інструменти надає OpenClaw
- Вам потрібно налаштувати, дозволити або заборонити інструменти
- 'Ви вирішуєте, що обрати: вбудовані інструменти, Skills чи плагіни'
summary: 'Огляд інструментів і плагінів OpenClaw: що може робити агент і як його розширювати'
title: Інструменти та плагіни
- Ви обираєте між вбудованими інструментами, Skills і plugin-ами
summary: 'Огляд інструментів і plugin-ів OpenClaw: що може робити агент і як його розширити'
title: Інструменти та plugin-и
x-i18n:
generated_at: "2026-04-22T07:16:19Z"
generated_at: "2026-04-22T23:49:17Z"
model: gpt-5.4
provider: openai
source_hash: 6edb9e13b72e6345554f25c8d8413d167a69501e6626828d9aa3aac6907cd092
source_hash: 1c32414dfa99969372e9b0c846305a1af1ffb18a282e6dfc8a6adabe3fab145a
source_path: tools/index.md
workflow: 15
---
# Інструменти та плагіни
# Інструменти та plugin-и
Усе, що агент робить понад генерування тексту, відбувається через **інструменти**.
Усе, що агент робить понад генерацію тексту, відбувається через **інструменти**.
Інструменти — це спосіб, у який агент читає файли, запускає команди, переглядає вебсторінки, надсилає
повідомлення та взаємодіє з пристроями.
## Інструменти, Skills і плагіни
## Інструменти, Skills і plugin-и
OpenClaw має три рівні, які працюють разом:
@ -28,99 +28,99 @@ OpenClaw має три рівні, які працюють разом:
<Step title="Інструменти — це те, що викликає агент">
Інструмент — це типізована функція, яку агент може викликати (наприклад, `exec`, `browser`,
`web_search`, `message`). OpenClaw постачається з набором **вбудованих інструментів**, а
плагіни можуть реєструвати додаткові.
plugin-и можуть реєструвати додаткові.
Агент бачить інструменти як структуровані визначення функцій, надіслані до API моделі.
</Step>
<Step title="Skills навчають агента коли і як">
Skill — це markdown-файл (`SKILL.md`), який вбудовується в системний промпт.
Skill — це markdown-файл (`SKILL.md`), який вбудовується в системний prompt.
Skills надають агенту контекст, обмеження та покрокові вказівки для
ефективного використання інструментів. Skills знаходяться у вашому робочому просторі, у спільних теках
або постачаються всередині плагінів.
ефективного використання інструментів. Skills зберігаються у вашому робочому просторі, у спільних теках
або постачаються всередині plugin-ів.
[Довідник Skills](/uk/tools/skills) | [Створення Skills](/uk/tools/creating-skills)
[Довідник зі Skills](/uk/tools/skills) | [Створення Skills](/uk/tools/creating-skills)
</Step>
<Step title="Плагіни пакують усе разом">
Плагін — це пакет, який може реєструвати будь-яку комбінацію можливостей:
канали, провайдери моделей, інструменти, Skills, мовлення, транскрибування в реальному часі,
<Step title="Plugin-и об’єднують усе разом">
Plugin — це пакет, який може реєструвати будь-яку комбінацію можливостей:
канали, провайдери моделей, інструменти, Skills, мовлення, транскрипцію в реальному часі,
голос у реальному часі, розуміння медіа, генерацію зображень, генерацію відео,
отримання вебконтенту, вебпошук тощо. Деякі плагіни є **core** (постачаються з
отримання даних з вебу, вебпошук тощо. Деякі plugin-и є **core** (постачаються з
OpenClaw), інші — **external** (опубліковані спільнотою в npm).
[Установлення та налаштування плагінів](/uk/tools/plugin) | [Створіть власний](/uk/plugins/building-plugins)
[Установлення й налаштування plugin-ів](/uk/tools/plugin) | [Створіть власний](/uk/plugins/building-plugins)
</Step>
</Steps>
## Вбудовані інструменти
Ці інструменти постачаються з OpenClaw і доступні без установлення будь-яких плагінів:
Ці інструменти постачаються з OpenClaw і доступні без встановлення будь-яких plugin-ів:
| Інструмент | Що він робить | Сторінка |
| ------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------- |
| `exec` / `process` | Запускає команди оболонки, керує фоновими процесами | [Exec](/uk/tools/exec) |
| `code_execution` | Запускає ізольований віддалений аналіз Python | [Code Execution](/uk/tools/code-execution) |
| `browser` | Керує браузером Chromium (перехід, натискання, знімок екрана) | [Browser](/uk/tools/browser) |
| `web_search` / `x_search` / `web_fetch` | Шукає у вебі, шукає дописи в X, отримує вміст сторінок | [Web](/uk/tools/web) |
| `read` / `write` / `edit` | Операції введення/виведення файлів у робочому просторі | |
| `apply_patch` | Багатофрагментні латки файлів | [Apply Patch](/uk/tools/apply-patch) |
| `message` | Надсилає повідомлення через усі канали | [Agent Send](/uk/tools/agent-send) |
| `canvas` | Керує node Canvas (present, eval, snapshot) | |
| `nodes` | Виявляє та вибирає спарені пристрої | |
| `cron` / `gateway` | Керує запланованими завданнями; переглядає, латає, перезапускає або оновлює Gateway | |
| `image` / `image_generate` | Аналізує або генерує зображення | [Image Generation](/uk/tools/image-generation) |
| `music_generate` | Генерує музичні треки | [Music Generation](/uk/tools/music-generation) |
| `video_generate` | Генерує відео | [Video Generation](/uk/tools/video-generation) |
| `tts` | Одноразове перетворення тексту на мовлення | [TTS](/uk/tools/tts) |
| `sessions_*` / `subagents` / `agents_list` | Керування сесіями, статусом і оркестрацією субагентів | [Sub-agents](/uk/tools/subagents) |
| `session_status` | Полегшене зчитування в стилі `/status` та перевизначення моделі для сесії | [Session Tools](/uk/concepts/session-tool) |
| Інструмент | Що він робить | Сторінка |
| ----------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------- |
| `exec` / `process` | Запускає shell-команди, керує фоновими процесами | [Exec](/uk/tools/exec) |
| `code_execution` | Запускає ізольований віддалений Python-аналіз | [Code Execution](/uk/tools/code-execution) |
| `browser` | Керує браузером Chromium (перехід, натискання, знімок екрана) | [Browser](/uk/tools/browser) |
| `web_search` / `x_search` / `web_fetch` | Шукає у вебі, шукає дописи в X, отримує вміст сторінок | [Веб](/uk/tools/web) |
| `read` / `write` / `edit` | Введення/виведення файлів у робочому просторі | |
| `apply_patch` | Багатофрагментні файлові патчі | [Apply Patch](/uk/tools/apply-patch) |
| `message` | Надсилає повідомлення через усі канали | [Надсилання агентом](/uk/tools/agent-send) |
| `canvas` | Керує node Canvas (present, eval, snapshot) | |
| `nodes` | Виявляє спарені пристрої та працює з ними | |
| `cron` / `gateway` | Керує запланованими завданнями; перевіряє, патчить, перезапускає або оновлює gateway | |
| `image` / `image_generate` | Аналізує або генерує зображення | [Генерація зображень](/uk/tools/image-generation) |
| `music_generate` | Генерує музичні доріжки | [Генерація музики](/uk/tools/music-generation) |
| `video_generate` | Генерує відео | [Генерація відео](/uk/tools/video-generation) |
| `tts` | Одноразове перетворення тексту на мовлення | [TTS](/uk/tools/tts) |
| `sessions_*` / `subagents` / `agents_list` | Керування сесіями, статус і оркестрація субагентів | [Субагенти](/uk/tools/subagents) |
| `session_status` | Легке зчитування у стилі `/status` і перевизначення моделі для сесії | [Інструменти сесії](/uk/concepts/session-tool) |
Для роботи із зображеннями використовуйте `image` для аналізу та `image_generate` для генерації або редагування. Якщо ви націлюєтеся на `openai/*`, `google/*`, `fal/*` або іншого нестандартного провайдера зображень, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з музикою використовуйте `music_generate`. Якщо ви націлюєтеся на `google/*`, `minimax/*` або іншого нестандартного музичного провайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з відео використовуйте `video_generate`. Якщо ви націлюєтеся на `qwen/*` або іншого нестандартного відеопровайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з відео використовуйте `video_generate`. Якщо ви націлюєтеся на `qwen/*` або іншого нестандартного провайдера відео, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для генерації аудіо на основі робочих процесів використовуйте `music_generate`, коли його реєструє
плагін, такий як ComfyUI. Це окремо від `tts`, який є перетворенням тексту на мовлення.
Для генерації аудіо на основі workflow використовуйте `music_generate`, коли plugin, наприклад
ComfyUI, реєструє його. Це окремо від `tts`, який є перетворенням тексту на мовлення.
`session_status` — це полегшений інструмент статусу/зчитування в групі сесій.
Він відповідає на запитання в стилі `/status` про поточну сесію та може
за потреби встановлювати перевизначення моделі для окремої сесії; `model=default` очищає це
перевизначення. Як і `/status`, він може дозаповнювати відсутні лічильники токенів/кешу та
мітку активної моделі середовища виконання з останнього запису використання в транскрипті.
`session_status` — це легкий інструмент статусу/зчитування в групі sessions.
Він відповідає на запитання у стилі `/status` про поточну сесію та може
за потреби встановити перевизначення моделі для окремої сесії; `model=default` скидає це
перевизначення. Як і `/status`, він може дозаповнювати розріджені лічильники токенів/кешу та
мітку активної runtime-моделі з останнього запису використання в транскрипті.
`gateway` — це інструмент середовища виконання лише для власника для операцій Gateway:
`gateway` — це owner-only runtime-інструмент для операцій gateway:
- `config.schema.lookup` для одного піддерева конфігурації з обмеженням шляхом перед редагуванням
- `config.get` для поточного знімка конфігурації + гешу
- `config.schema.lookup` для одного піддерева конфігурації, обмеженого шляхом, перед редагуванням
- `config.get` для поточного знімка конфігурації + хешу
- `config.patch` для часткових оновлень конфігурації з перезапуском
- `config.apply` лише для повної заміни конфігурації
- `update.run` для явного самооновлення + перезапуску
- `update.run` для явного самостійного оновлення + перезапуску
Для часткових змін надавайте перевагу `config.schema.lookup`, а потім `config.patch`. Використовуйте
`config.apply` лише тоді, коли ви навмисно замінюєте всю конфігурацію.
`config.apply` лише тоді, коли ви свідомо замінюєте всю конфігурацію.
Інструмент також відмовляється змінювати `tools.exec.ask` або `tools.exec.security`;
застарілі псевдоніми `tools.bash.*` нормалізуються до тих самих захищених шляхів exec.
### Інструменти, надані плагінами
### Інструменти, надані plugin-ами
Плагіни можуть реєструвати додаткові інструменти. Деякі приклади:
Plugin-и можуть реєструвати додаткові інструменти. Деякі приклади:
- [Diffs](/uk/tools/diffs) — переглядач і рендерер diff
- [Diffs](/uk/tools/diffs) — переглядач і засіб рендерингу diff
- [LLM Task](/uk/tools/llm-task) — крок LLM лише з JSON для структурованого виводу
- [Lobster](/uk/tools/lobster) — типізоване середовище виконання робочих процесів із відновлюваними погодженнями
- [Music Generation](/uk/tools/music-generation) — спільний інструмент `music_generate` із провайдерами на основі робочих процесів
- [OpenProse](/uk/prose) — оркестрація робочих процесів у стилі markdown
- [Tokenjuice](/uk/tools/tokenjuice) — стискає шумні результати інструментів `exec` і `bash`
- [Lobster](/uk/tools/lobster) — типізоване workflow-середовище виконання з відновлюваними погодженнями
- [Music Generation](/uk/tools/music-generation) — спільний інструмент `music_generate` з провайдерами на основі workflow
- [OpenProse](/uk/prose) — оркестрація workflow з пріоритетом markdown
- [Tokenjuice](/uk/tools/tokenjuice) — компактні результати інструментів `exec` і `bash` з шумним виводом
## Налаштування інструментів
### Списки дозволу та заборони
### Списки дозволів і заборон
Керуйте тим, які інструменти агент може викликати, через `tools.allow` / `tools.deny` у
конфігурації. Заборона завжди має пріоритет над дозволом.
@ -136,48 +136,53 @@ OpenClaw має три рівні, які працюють разом:
### Профілі інструментів
`tools.profile` задає базовий список дозволів перед застосуванням `allow`/`deny`.
`tools.profile` встановлює базовий список дозволів перед застосуванням `allow`/`deny`.
Перевизначення для окремого агента: `agents.list[].tools.profile`.
| Профіль | Що він містить |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `full` | Без обмежень (те саме, що не задано) |
| `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `music_generate`, `video_generate` |
| Профіль | Що він включає |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `full` | Без обмежень (те саме, що не встановлено) |
| `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `music_generate`, `video_generate` |
| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` |
| `minimal` | Лише `session_status` |
| `minimal` | Лише `session_status` |
Профілі `coding` і `messaging` також дозволяють налаштовані bundle MCP-інструменти
під ключем plugin-а `bundle-mcp`. Додайте `tools.deny: ["bundle-mcp"]`, якщо ви
хочете, щоб профіль зберіг свої звичайні вбудовані інструменти, але приховав усі налаштовані MCP-інструменти.
Профіль `minimal` не включає bundle MCP-інструменти.
### Групи інструментів
Використовуйте скорочення `group:*` у списках дозволу/заборони:
Використовуйте скорочення `group:*` у списках дозволів/заборон:
| Група | Інструменти |
| ------------------ | --------------------------------------------------------------------------------------------------------- |
| Група | Інструменти |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| `group:runtime` | exec, process, code_execution (`bash` приймається як псевдонім для `exec`) |
| `group:fs` | read, write, edit, apply_patch |
| `group:fs` | read, write, edit, apply_patch |
| `group:sessions` | sessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status |
| `group:memory` | memory_search, memory_get |
| `group:web` | web_search, x_search, web_fetch |
| `group:ui` | browser, canvas |
| `group:automation` | cron, gateway |
| `group:messaging` | message |
| `group:nodes` | nodes |
| `group:agents` | agents_list |
| `group:media` | image, image_generate, music_generate, video_generate, tts |
| `group:openclaw` | Усі вбудовані інструменти OpenClaw (без інструментів плагінів) |
| `group:memory` | memory_search, memory_get |
| `group:web` | web_search, x_search, web_fetch |
| `group:ui` | browser, canvas |
| `group:automation` | cron, gateway |
| `group:messaging` | message |
| `group:nodes` | nodes |
| `group:agents` | agents_list |
| `group:media` | image, image_generate, music_generate, video_generate, tts |
| `group:openclaw` | Усі вбудовані інструменти OpenClaw (не включає інструменти plugin-ів) |
`sessions_history` повертає обмежене, відфільтроване з погляду безпеки подання для згадування. Воно видаляє
теги thinking, каркас `<relevant-memories>`, XML-корисні навантаження викликів інструментів у звичайному тексті
(зокрема `<tool_call>...</tool_call>`,
`sessions_history` повертає обмежений, відфільтрований з погляду безпеки вигляд для пригадування. Він видаляє
теги thinking, каркас `<relevant-memories>`, XML-корисне навантаження викликів інструментів у звичайному тексті
(включно з `<tool_call>...</tool_call>`,
`<function_call>...</function_call>`, `<tool_calls>...</tool_calls>`,
`<function_calls>...</function_calls>` і обрізані блоки викликів інструментів),
каркас викликів інструментів після деградації, витоки ASCII/повноширинних токенів керування
моделлю та некоректний XML викликів інструментів MiniMax з тексту асистента, а потім застосовує
редагування/усікання та, за потреби, заповнювачі для надто великих рядків замість того, щоб діяти
як сирий дамп транскрипту.
`<function_calls>...</function_calls>` і обрізаними блоками викликів інструментів),
понижений до звичайного тексту каркас викликів інструментів, витіклі ASCII/full-width токени
керування моделлю та некоректний XML викликів інструментів MiniMax з тексту асистента, а потім застосовує
редагування/обрізання та, за потреби, заповнювачі надто великих рядків замість того, щоб діяти
як необроблений дамп транскрипту.
### Обмеження для конкретних провайдерів
Використовуйте `tools.byProvider`, щоб обмежувати інструменти для конкретних провайдерів без
Використовуйте `tools.byProvider`, щоб обмежувати інструменти для певних провайдерів без
зміни глобальних значень за замовчуванням:
```json5