diff --git a/docs/uk/tools/index.md b/docs/uk/tools/index.md index e259f7152..8ec011be7 100644 --- a/docs/uk/tools/index.md +++ b/docs/uk/tools/index.md @@ -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 має три рівні, які працюють разом: - + 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) @@ -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, каркас ``, XML-навантаження викликів інструментів у простому тексті +`sessions_history` повертає обмежене, відфільтроване з погляду безпеки подання для згадування. Воно видаляє +теги thinking, каркас ``, XML-корисні навантаження викликів інструментів у звичайному тексті (зокрема `...`, `...`, `...`, -`...` і усічені блоки викликів інструментів), -понижений каркас викликів інструментів, витеклі ASCII/повноширинні токени -керування моделлю та некоректний XML викликів інструментів MiniMax із тексту помічника, а потім застосовує -редагування/усічення та, за потреби, заповнювачі для надто великих рядків замість того, щоб працювати -як необроблений дамп транскрипту. +`...` і обрізані блоки викликів інструментів), +каркас викликів інструментів після деградації, витоки ASCII/повноширинних токенів керування +моделлю та некоректний XML викликів інструментів MiniMax з тексту асистента, а потім застосовує +редагування/усікання та, за потреби, заповнювачі для надто великих рядків замість того, щоб діяти +як сирий дамп транскрипту. ### Обмеження для конкретних провайдерів -Використовуйте `tools.byProvider`, щоб обмежувати інструменти для певних провайдерів без +Використовуйте `tools.byProvider`, щоб обмежувати інструменти для конкретних провайдерів без зміни глобальних значень за замовчуванням: ```json5 diff --git a/docs/uk/tools/tokenjuice.md b/docs/uk/tools/tokenjuice.md new file mode 100644 index 000000000..c909c9d17 --- /dev/null +++ b/docs/uk/tools/tokenjuice.md @@ -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 +```