chore(i18n): refresh uk translations
This commit is contained in:
parent
1e3e42b4a0
commit
8c419dfd57
@ -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
|
||||
|
||||
79
docs/uk/tools/tokenjuice.md
Normal file
79
docs/uk/tools/tokenjuice.md
Normal 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
|
||||
```
|
||||
Loading…
Reference in New Issue
Block a user