chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-22 07:16:53 +00:00
parent 1e3e42b4a0
commit 8c419dfd57
2 changed files with 126 additions and 46 deletions

View File

@ -2,21 +2,21 @@
read_when:
- Ви хочете зрозуміти, які інструменти надає OpenClaw
- Вам потрібно налаштувати, дозволити або заборонити інструменти
- Ви обираєте між вбудованими інструментами, Skills і плагінами
- 'Ви вирішуєте, що обрати: вбудовані інструменти, Skills чи плагіни'
summary: 'Огляд інструментів і плагінів OpenClaw: що може робити агент і як його розширювати'
title: Інструменти та плагіни
x-i18n:
generated_at: "2026-04-06T01:05:38Z"
generated_at: "2026-04-22T07:16:19Z"
model: gpt-5.4
provider: openai
source_hash: b2371239316997b0fe389bfa2ec38404e1d3e177755ad81ff8035ac583d9adeb
source_hash: 6edb9e13b72e6345554f25c8d8413d167a69501e6626828d9aa3aac6907cd092
source_path: tools/index.md
workflow: 15
---
# Інструменти та плагіни
Усе, що агент робить, окрім генерування тексту, відбувається через **інструменти**.
Усе, що агент робить понад генерування тексту, відбувається через **інструменти**.
Інструменти — це спосіб, у який агент читає файли, запускає команди, переглядає вебсторінки, надсилає
повідомлення та взаємодіє з пристроями.
@ -34,13 +34,13 @@ OpenClaw має три рівні, які працюють разом:
</Step>
<Step title="Skills навчають агента коли і як діяти">
<Step title="Skills навчають агента коли і як">
Skill — це markdown-файл (`SKILL.md`), який вбудовується в системний промпт.
Skills надають агенту контекст, обмеження та покрокові вказівки для
ефективного використання інструментів. Skills зберігаються у вашому робочому просторі, у спільних теках
ефективного використання інструментів. Skills знаходяться у вашому робочому просторі, у спільних теках
або постачаються всередині плагінів.
[Довідка про Skills](/uk/tools/skills) | [Створення Skills](/uk/tools/creating-skills)
[Довідник Skills](/uk/tools/skills) | [Створення Skills](/uk/tools/creating-skills)
</Step>
@ -48,8 +48,8 @@ OpenClaw має три рівні, які працюють разом:
Плагін — це пакет, який може реєструвати будь-яку комбінацію можливостей:
канали, провайдери моделей, інструменти, Skills, мовлення, транскрибування в реальному часі,
голос у реальному часі, розуміння медіа, генерацію зображень, генерацію відео,
отримання вебданих, вебпошук тощо. Деякі плагіни є **core** (постачаються з
OpenClaw), інші — **external** (опубліковані в npm спільнотою).
отримання вебконтенту, вебпошук тощо. Деякі плагіни є **core** (постачаються з
OpenClaw), інші — **external** (опубліковані спільнотою в npm).
[Установлення та налаштування плагінів](/uk/tools/plugin) | [Створіть власний](/uk/plugins/building-plugins)
@ -58,68 +58,69 @@ OpenClaw має три рівні, які працюють разом:
## Вбудовані інструменти
Ці інструменти постачаються з OpenClaw і доступні без встановлення будь-яких плагінів:
Ці інструменти постачаються з OpenClaw і доступні без установлення будь-яких плагінів:
| Інструмент | Що він робить | Сторінка |
| ------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------- |
| `exec` / `process` | Запускає команди оболонки, керує фоновими процесами | [Exec](/uk/tools/exec) |
| `code_execution` | Виконує ізольований віддалений аналіз Python | [Code Execution](/uk/tools/code-execution) |
| `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) |
| `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 | |
| `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) |
| `sessions_*` / `subagents` / `agents_list` | Керування сесіями, статусом і оркестрацією субагентів | [Sub-agents](/uk/tools/subagents) |
| `session_status` | Полегшене зчитування в стилі `/status` та перевизначення моделі для сесії | [Session Tools](/uk/concepts/session-tool) |
Для роботи із зображеннями використовуйте `image` для аналізу і `image_generate` для генерації або редагування. Якщо ви використовуєте `openai/*`, `google/*`, `fal/*` або іншого не стандартного провайдера зображень, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи із зображеннями використовуйте `image` для аналізу та `image_generate` для генерації або редагування. Якщо ви націлюєтеся на `openai/*`, `google/*`, `fal/*` або іншого нестандартного провайдера зображень, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з музикою використовуйте `music_generate`. Якщо ви використовуєте `google/*`, `minimax/*` або іншого не стандартного музичного провайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з музикою використовуйте `music_generate`. Якщо ви націлюєтеся на `google/*`, `minimax/*` або іншого нестандартного музичного провайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з відео використовуйте `video_generate`. Якщо ви використовуєте `qwen/*` або іншого не стандартного відеопровайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для роботи з відео використовуйте `video_generate`. Якщо ви націлюєтеся на `qwen/*` або іншого нестандартного відеопровайдера, спочатку налаштуйте автентифікацію/API-ключ цього провайдера.
Для генерації аудіо на основі робочих процесів використовуйте `music_generate`, коли його реєструє
плагін на кшталт ComfyUI. Це окремо від `tts`, який є перетворенням тексту на мовлення.
плагін, такий як ComfyUI. Це окремо від `tts`, який є перетворенням тексту на мовлення.
`session_status` — це полегшений інструмент статусу/зчитування в групі сесій.
Він відповідає на запитання у стилі `/status` про поточну сесію і може
за бажанням встановити перевизначення моделі для окремої сесії; `model=default` скасовує це
перевизначення. Як і `/status`, він може заповнювати відсутні лічильники токенів/кешу та
мітку активної моделі середовища виконання з останнього запису про використання в транскрипті.
Він відповідає на запитання в стилі `/status` про поточну сесію та може
за потреби встановлювати перевизначення моделі для окремої сесії; `model=default` очищає це
перевизначення. Як і `/status`, він може дозаповнювати відсутні лічильники токенів/кешу та
мітку активної моделі середовища виконання з останнього запису використання в транскрипті.
`gateway` — це інструмент середовища виконання лише для власника для операцій gateway:
`gateway` — це інструмент середовища виконання лише для власника для операцій Gateway:
- `config.schema.lookup` для однієї підгілки конфігурації за шляхом перед редагуванням
- `config.get` для поточного знімка конфігурації + хешу
- `config.schema.lookup` для одного піддерева конфігурації з обмеженням шляхом перед редагуванням
- `config.get` для поточного знімка конфігурації + гешу
- `config.patch` для часткових оновлень конфігурації з перезапуском
- `config.apply` лише для повної заміни конфігурації
- `update.run` для явного самооновлення + перезапуску
Для часткових змін віддавайте перевагу `config.schema.lookup`, а потім `config.patch`. Використовуйте
`config.apply` лише тоді, коли ви свідомо замінюєте всю конфігурацію.
Для часткових змін надавайте перевагу `config.schema.lookup`, а потім `config.patch`. Використовуйте
`config.apply` лише тоді, коли ви навмисно замінюєте всю конфігурацію.
Інструмент також відмовляється змінювати `tools.exec.ask` або `tools.exec.security`;
застарілі псевдоніми `tools.bash.*` нормалізуються до тих самих захищених шляхів exec.
### Інструменти, надані плагінами
Плагіни можуть реєструвати додаткові інструменти. Декілька прикладів:
Плагіни можуть реєструвати додаткові інструменти. Деякі приклади:
- [Lobster](/uk/tools/lobster) — типізоване середовище виконання робочих процесів із відновлюваними погодженнями
- [LLM Task](/uk/tools/llm-task) — крок LLM лише з JSON для структурованого виводу
- [Music Generation](/uk/tools/music-generation) — спільний інструмент `music_generate` із провайдерами на основі робочих процесів
- [Diffs](/uk/tools/diffs) — переглядач і рендерер diff
- [OpenProse](/uk/prose) — оркестрація робочих процесів із пріоритетом markdown
- [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`
## Налаштування інструментів
### Списки дозволів і заборон
### Списки дозволу та заборони
Керуйте тим, які інструменти агент може викликати, через `tools.allow` / `tools.deny` у
конфігурації. Заборона завжди має пріоритет над дозволом.
@ -147,7 +148,7 @@ OpenClaw має три рівні, які працюють разом:
### Групи інструментів
Використовуйте скорочення `group:*` у списках дозволів/заборон:
Використовуйте скорочення `group:*` у списках дозволу/заборони:
| Група | Інструменти |
| ------------------ | --------------------------------------------------------------------------------------------------------- |
@ -162,21 +163,21 @@ OpenClaw має три рівні, які працюють разом:
| `group:nodes` | nodes |
| `group:agents` | agents_list |
| `group:media` | image, image_generate, music_generate, video_generate, tts |
| `group:openclaw` | Усі вбудовані інструменти OpenClaw (крім інструментів плагінів) |
| `group:openclaw` | Усі вбудовані інструменти OpenClaw (без інструментів плагінів) |
`sessions_history` повертає обмежене, відфільтроване з погляду безпеки представлення для пригадування. Він прибирає
теги thinking, каркас `<relevant-memories>`, XML-навантаження викликів інструментів у простому тексті
`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/повноширинних токенів керування
моделлю та некоректний XML викликів інструментів MiniMax з тексту асистента, а потім застосовує
редагування/усікання та, за потреби, заповнювачі для надто великих рядків замість того, щоб діяти
як сирий дамп транскрипту.
### Обмеження для конкретних провайдерів
Використовуйте `tools.byProvider`, щоб обмежувати інструменти для певних провайдерів без
Використовуйте `tools.byProvider`, щоб обмежувати інструменти для конкретних провайдерів без
зміни глобальних значень за замовчуванням:
```json5

View File

@ -0,0 +1,79 @@
---
read_when:
- Ви хочете коротші результати інструментів `exec` або `bash` в OpenClaw
- Ви хочете ввімкнути комплектний plugin tokenjuice
- Вам потрібно зрозуміти, що tokenjuice змінює, а що залишає без обробки
summary: Стискайте зашумлені результати інструментів exec і bash за допомогою необов’язкового комплектного plugin
title: Tokenjuice
x-i18n:
generated_at: "2026-04-22T07:16:24Z"
model: gpt-5.4
provider: openai
source_hash: 9b9a1054c9b1cc62e43ac6d5904c7790f9b27d8e0d0700c9da6e287c00e91783
source_path: tools/tokenjuice.md
workflow: 15
---
# Tokenjuice
`tokenjuice` — це необов’язковий комплектний plugin, який стискає зашумлені результати інструментів `exec` і `bash` після того, як команда вже виконалася.
Він змінює повернений `tool_result`, а не саму команду. Tokenjuice не переписує введення shell, не перезапускає команди й не змінює коди виходу.
Наразі це застосовується до вбудованих запусків Pi, де tokenjuice підключається до шляху вбудованого `tool_result` і скорочує вивід, який повертається в сесію.
## Увімкнути plugin
Швидкий спосіб:
```bash
openclaw config set plugins.entries.tokenjuice.enabled true
```
Еквівалент:
```bash
openclaw plugins enable tokenjuice
```
OpenClaw уже постачається з цим plugin. Окремий крок `plugins install` або `tokenjuice install openclaw` не потрібен.
Якщо ви надаєте перевагу прямому редагуванню конфігурації:
```json5
{
plugins: {
entries: {
tokenjuice: {
enabled: true,
},
},
},
}
```
## Що змінює tokenjuice
- Стискає зашумлені результати `exec` і `bash` перед тим, як вони повертаються в сесію.
- Залишає фактичне виконання команди без змін.
- Зберігає точні читання вмісту файлів та інші команди, які tokenjuice має залишати без обробки.
- Працює лише за явного ввімкнення: вимкніть plugin, якщо хочете всюди бачити дослівний вивід.
## Перевірити, що це працює
1. Увімкніть plugin.
2. Запустіть сесію, яка може викликати `exec`.
3. Виконайте зашумлену команду, наприклад `git status`.
4. Переконайтеся, що повернений результат інструмента коротший і структурованіший, ніж сирий вивід shell.
## Вимкнути plugin
```bash
openclaw config set plugins.entries.tokenjuice.enabled false
```
Або:
```bash
openclaw plugins disable tokenjuice
```