From dcba1cf737b169b958dc5943ab547bd8169e0f36 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 3 May 2026 23:09:19 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/lobster.md | 112 +++++++++++++++++++-------------------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/docs/uk/tools/lobster.md b/docs/uk/tools/lobster.md index abd4f7e3a..cbe4c6d40 100644 --- a/docs/uk/tools/lobster.md +++ b/docs/uk/tools/lobster.md @@ -1,52 +1,52 @@ --- read_when: - - Вам потрібні детерміновані багатоетапні робочі процеси з явними затвердженнями - - Потрібно відновити робочий процес, не запускаючи попередні кроки повторно -summary: Типізоване середовище виконання робочих процесів для OpenClaw із відновлюваними шлюзами затвердження. + - Вам потрібні детерміновані багатокрокові робочі процеси з явними затвердженнями + - Потрібно відновити робочий процес без повторного виконання попередніх кроків +summary: Типізоване середовище виконання робочих процесів для OpenClaw з контрольними точками затвердження, які можна відновлювати. title: Омар x-i18n: - generated_at: "2026-05-03T22:56:18Z" + generated_at: "2026-05-03T23:08:35Z" model: gpt-5.5 provider: openai - source_hash: e1a81fddd11fa36f4ce3b3f0bce35f5a7e90300e225027331965bdfdc8919532 + source_hash: 67f5145b11f2d6e07e9d78a44a389ae5f236c85ec8c287ab0f217a18b622ece0 source_path: tools/lobster.md workflow: 16 --- -Lobster — це оболонка робочих процесів, яка дає OpenClaw змогу запускати багатоетапні послідовності інструментів як одну детерміновану операцію з явними контрольними точками затвердження. +Lobster — це оболонка робочих процесів, яка дає OpenClaw змогу виконувати багатокрокові послідовності інструментів як одну детерміновану операцію з явними контрольними точками схвалення. -Lobster — це один авторський шар над від’єднаною фоновою роботою. Про оркестрацію потоків над окремими завданнями див. [TaskFlow](/uk/automation/taskflow) (`openclaw tasks flow`). Про журнал активності завдань див. [`openclaw tasks`](/uk/automation/tasks). +Lobster — це один авторський шар над від’єднаною фоновою роботою. Про оркестрацію потоків над окремими завданнями див. [Потік завдань](/uk/automation/taskflow) (`openclaw tasks flow`). Про журнал активності завдань див. [`openclaw tasks`](/uk/automation/tasks). ## Хук -Ваш асистент може створювати інструменти, які керують ним самим. Попросіть робочий процес, і за 30 хвилин матимете CLI плюс конвеєри, що запускаються одним викликом. Lobster — це відсутня ланка: детерміновані конвеєри, явні затвердження та стан, який можна відновити. +Ваш асистент може створювати інструменти, які керують ним самим. Попросіть робочий процес, і через 30 хвилин матимете CLI плюс конвеєри, що виконуються одним викликом. Lobster — це відсутній елемент: детерміновані конвеєри, явні схвалення та відновлюваний стан. ## Навіщо -Сьогодні складні робочі процеси потребують багатьох взаємних викликів інструментів. Кожен виклик витрачає токени, а LLM має оркеструвати кожен крок. Lobster переносить цю оркестрацію в типізоване середовище виконання: +Сьогодні складні робочі процеси потребують багатьох взаємних викликів інструментів. Кожен виклик коштує токенів, а LLM має оркеструвати кожен крок. Lobster переносить цю оркестрацію в типізоване середовище виконання: - **Один виклик замість багатьох**: OpenClaw виконує один виклик інструмента Lobster і отримує структурований результат. -- **Вбудовані затвердження**: побічні ефекти (надіслати email, опублікувати коментар) зупиняють робочий процес до явного затвердження. -- **Можливість відновлення**: зупинені робочі процеси повертають токен; затвердьте й відновіть без повторного виконання всього процесу. +- **Вбудовані схвалення**: побічні ефекти (надіслати лист, опублікувати коментар) зупиняють робочий процес до явного схвалення. +- **Відновлюваність**: зупинені робочі процеси повертають токен; схваліть і відновіть без повторного виконання всього. -## Навіщо DSL замість звичайних програм? +## Чому DSL, а не звичайні програми? -Lobster навмисно невеликий. Мета — не "нова мова", а передбачувана, зручна для AI специфікація конвеєра з повноцінними затвердженнями й токенами відновлення. +Lobster навмисно малий. Мета не в «новій мові», а в передбачуваній, зручній для ШІ специфікації конвеєра з першокласними схваленнями та токенами відновлення. -- **Затвердження/відновлення вбудовано**: звичайна програма може попросити людину про підтвердження, але не може _призупинитися й відновитися_ зі сталим токеном, якщо ви самі не створите таке середовище виконання. -- **Детермінізм + аудитованість**: конвеєри — це дані, тому їх легко логувати, порівнювати, відтворювати й переглядати. -- **Обмежена поверхня для AI**: крихітна граматика + передавання JSON зменшують кількість “творчих” шляхів коду й роблять валідацію реалістичною. -- **Політика безпеки вбудована**: тайм-аути, обмеження виводу, перевірки пісочниці та allowlist-и застосовуються середовищем виконання, а не кожним скриптом. -- **Водночас програмований**: кожен крок може викликати будь-який CLI або скрипт. Якщо хочете JS/TS, генеруйте файли `.lobster` з коду. +- **Схвалення/відновлення вбудовані**: звичайна програма може запросити людину, але не може _призупинитися й відновитися_ з довговічним токеном без того, щоб ви самі створили таке середовище виконання. +- **Детермінованість + аудитовність**: конвеєри — це дані, тому їх легко журналювати, порівнювати, повторно виконувати й переглядати. +- **Обмежена поверхня для ШІ**: мала граматика + передавання JSON зменшують «креативні» шляхи коду й роблять валідацію реалістичною. +- **Політика безпеки вбудована**: тайм-аути, обмеження виводу, перевірки пісочниці та списки дозволеного застосовуються середовищем виконання, а не кожним скриптом. +- **Все ще програмований**: кожен крок може викликати будь-який CLI або скрипт. Якщо вам потрібен JS/TS, генеруйте файли `.lobster` з коду. ## Як це працює -OpenClaw запускає робочі процеси Lobster **у межах процесу** за допомогою вбудованого раннера. Зовнішній підпроцес CLI не створюється; рушій робочих процесів виконується всередині процесу Gateway і повертає JSON-конверт напряму. -Якщо конвеєр призупиняється для затвердження, інструмент повертає `resumeToken`, щоб ви могли продовжити пізніше. +OpenClaw виконує робочі процеси Lobster **у процесі** за допомогою вбудованого раннера. Зовнішній підпроцес CLI не запускається; рушій робочих процесів виконується всередині процесу Gateway і повертає JSON-конверт напряму. +Якщо конвеєр призупиняється для схвалення, інструмент повертає `resumeToken`, щоб можна було продовжити пізніше. -## Патерн: малий CLI + JSON-канали + затвердження +## Шаблон: малий CLI + JSON-канали + схвалення -Створюйте невеликі команди, які спілкуються JSON, а потім об’єднуйте їх в один виклик Lobster. (Назви прикладних команд нижче — замініть їх на власні.) +Створюйте маленькі команди, що говорять JSON, а потім з’єднуйте їх в один виклик Lobster. (Назви команд нижче наведено як приклад — замініть їх на власні.) ```bash inbox list --json @@ -62,7 +62,7 @@ inbox apply --json } ``` -Якщо конвеєр запитує затвердження, відновіть його з токеном: +Якщо конвеєр запитує схвалення, відновіть його з токеном: ```json { @@ -72,20 +72,20 @@ inbox apply --json } ``` -AI запускає робочий процес; Lobster виконує кроки. Шлюзи затвердження роблять побічні ефекти явними й аудитованими. +ШІ запускає робочий процес; Lobster виконує кроки. Шлюзи схвалення роблять побічні ефекти явними й придатними для аудиту. -Приклад: зіставлення вхідних елементів із викликами інструментів: +Приклад: перетворення вхідних елементів на виклики інструментів: ```bash gog.gmail.search --query 'newer_than:1d' \ | openclaw.invoke --tool message --action send --each --item-key message --args-json '{"provider":"telegram","to":"..."}' ``` -## Кроки LLM лише з JSON (llm-task) +## LLM-кроки лише з JSON (llm-task) -Для робочих процесів, яким потрібен **структурований крок LLM**, увімкніть необов’язковий інструмент plugin +Для робочих процесів, яким потрібен **структурований LLM-крок**, увімкніть необов’язковий інструмент plugin `llm-task` і викликайте його з Lobster. Це зберігає робочий процес -детермінованим, але дає змогу класифікувати, підсумовувати й готувати чернетки за допомогою моделі. +детермінованим, водночас даючи змогу класифікувати/підсумовувати/створювати чернетки за допомогою моделі. Увімкніть інструмент: @@ -100,7 +100,7 @@ gog.gmail.search --query 'newer_than:1d' \ "list": [ { "id": "main", - "tools": { "allow": ["llm-task"] } + "tools": { "alsoAllow": ["llm-task"] } } ] } @@ -126,11 +126,11 @@ openclaw.invoke --tool llm-task --action json --args-json '{ }' ``` -Див. [LLM Task](/uk/tools/llm-task), щоб дізнатися про подробиці й параметри конфігурації. +Докладніше та параметри конфігурації див. у [LLM Task](/uk/tools/llm-task). ## Файли робочих процесів (.lobster) -Lobster може запускати YAML/JSON-файли робочих процесів із полями `name`, `args`, `steps`, `env`, `condition` та `approval`. У викликах інструментів OpenClaw задайте `pipeline` як шлях до файлу. +Lobster може виконувати YAML/JSON-файли робочих процесів із полями `name`, `args`, `steps`, `env`, `condition` і `approval`. У викликах інструментів OpenClaw задайте `pipeline` як шлях до файлу. ```yaml name: inbox-triage @@ -156,17 +156,17 @@ steps: Примітки: - `stdin: $step.stdout` і `stdin: $step.json` передають вивід попереднього кроку. -- `condition` (або `when`) може ставити кроки в залежність від `$step.approved`. +- `condition` (або `when`) може обмежувати виконання кроків за `$step.approved`. ## Встановлення Lobster -Вбудовані робочі процеси Lobster виконуються в межах процесу; окремий бінарний файл `lobster` не потрібен. Вбудований раннер постачається з plugin Lobster. +Вбудовані робочі процеси Lobster виконуються у процесі; окремий бінарний файл `lobster` не потрібен. Вбудований раннер постачається з plugin Lobster. Якщо вам потрібен автономний CLI Lobster для розробки або зовнішніх конвеєрів, установіть його з [репозиторію Lobster](https://github.com/openclaw/lobster) і переконайтеся, що `lobster` є в `PATH`. ## Увімкнення інструмента -Lobster — це **необов’язковий** інструмент plugin (не ввімкнений за замовчуванням). +Lobster — **необов’язковий** інструмент plugin (типово не ввімкнений). Рекомендовано (адитивно, безпечно): @@ -195,10 +195,10 @@ Lobster — це **необов’язковий** інструмент plugin ( } ``` -Уникайте використання `tools.allow: ["lobster"]`, якщо не маєте наміру працювати в обмежувальному режимі allowlist. +Уникайте використання `tools.allow: ["lobster"]`, якщо ви не маєте наміру працювати в обмежувальному режимі списку дозволеного. -Allowlists вмикаються за бажанням для необов’язкових plugins. `alsoAllow` вмикає лише названі необов’язкові інструменти plugin, зберігаючи звичайний набір базових інструментів. Щоб обмежити базові інструменти, використовуйте `tools.allow` із потрібними базовими інструментами або групами. +Списки дозволеного є opt-in для необов’язкових plugins. `alsoAllow` вмикає лише названі необов’язкові інструменти plugin, зберігаючи звичайний набір основних інструментів. Щоб обмежити основні інструменти, використовуйте `tools.allow` з потрібними основними інструментами або групами. ## Приклад: сортування email @@ -242,7 +242,7 @@ User: "Check my email and draft replies" } ``` -Користувач затверджує → відновлення: +Користувач схвалює → відновлення: ```json { @@ -258,7 +258,7 @@ User: "Check my email and draft replies" ### `run` -Запустіть конвеєр у режимі інструмента. +Виконати конвеєр у режимі інструмента. ```json { @@ -270,7 +270,7 @@ User: "Check my email and draft replies" } ``` -Запустіть файл робочого процесу з аргументами: +Виконати файл робочого процесу з аргументами: ```json { @@ -282,7 +282,7 @@ User: "Check my email and draft replies" ### `resume` -Продовжіть зупинений робочий процес після затвердження. +Продовжити зупинений робочий процес після схвалення. ```json { @@ -295,8 +295,8 @@ User: "Check my email and draft replies" ### Необов’язкові вхідні дані - `cwd`: відносний робочий каталог для конвеєра (має залишатися в межах робочого каталогу Gateway). -- `timeoutMs`: перервати робочий процес, якщо він перевищує цю тривалість (за замовчуванням: 20000). -- `maxStdoutBytes`: перервати робочий процес, якщо вивід перевищує цей розмір (за замовчуванням: 512000). +- `timeoutMs`: перервати робочий процес, якщо він перевищує цю тривалість (типово: 20000). +- `maxStdoutBytes`: перервати робочий процес, якщо вивід перевищує цей розмір (типово: 512000). - `argsJson`: JSON-рядок, переданий до `lobster run --args-json` (лише файли робочих процесів). ## Конверт виводу @@ -307,45 +307,45 @@ Lobster повертає JSON-конверт з одним із трьох ст - `needs_approval` → призупинено; для відновлення потрібен `requiresApproval.resumeToken` - `cancelled` → явно відхилено або скасовано -Інструмент показує конверт і в `content` (форматований JSON), і в `details` (сирий об’єкт). +Інструмент показує конверт і в `content` (відформатований JSON), і в `details` (сирий об’єкт). -## Затвердження +## Схвалення -Якщо присутній `requiresApproval`, перегляньте запит і вирішіть: +Якщо `requiresApproval` присутній, перегляньте запит і вирішіть: - `approve: true` → відновити й продовжити побічні ефекти -- `approve: false` → скасувати й завершити робочий процес +- `approve: false` → скасувати й фіналізувати робочий процес -Використовуйте `approve --preview-from-stdin --limit N`, щоб додати JSON-перегляд до запитів на затвердження без власного jq/heredoc-клею. Токени відновлення тепер компактні: Lobster зберігає стан відновлення робочого процесу у своєму каталозі стану й повертає невеликий ключ токена. +Використовуйте `approve --preview-from-stdin --limit N`, щоб додати JSON-попередній перегляд до запитів на схвалення без власного jq/heredoc-клею. Токени відновлення тепер компактні: Lobster зберігає стан відновлення робочого процесу у своєму каталозі стану й повертає малий ключ токена. ## OpenProse -OpenProse добре поєднується з Lobster: використовуйте `/prose` для оркестрації підготовки кількох агентів, а потім запускайте конвеєр Lobster для детермінованих затверджень. Якщо програмі Prose потрібен Lobster, дозвольте інструмент `lobster` для субагентів через `tools.subagents.tools`. Див. [OpenProse](/uk/prose). +OpenProse добре поєднується з Lobster: використовуйте `/prose`, щоб оркеструвати підготовку кількох агентів, а потім запустіть конвеєр Lobster для детермінованих схвалень. Якщо програмі Prose потрібен Lobster, дозвольте інструмент `lobster` для субагентів через `tools.subagents.tools`. Див. [OpenProse](/uk/prose). ## Безпека -- **Лише локально в межах процесу** — робочі процеси виконуються всередині процесу Gateway; сам plugin не виконує мережевих викликів. +- **Лише локально в процесі** — робочі процеси виконуються всередині процесу Gateway; сам plugin не виконує мережевих викликів. - **Без секретів** — Lobster не керує OAuth; він викликає інструменти OpenClaw, які це роблять. -- **З урахуванням пісочниці** — вимикається, коли контекст інструмента перебуває в пісочниці. -- **Зміцнений** — тайм-аути й обмеження виводу застосовуються вбудованим раннером. +- **З урахуванням пісочниці** — вимикається, коли контекст інструмента працює в пісочниці. +- **Посилений** — тайм-аути й обмеження виводу застосовуються вбудованим раннером. ## Усунення несправностей -- **`lobster timed out`** → збільште `timeoutMs` або розділіть довгий конвеєр. +- **`lobster timed out`** → збільште `timeoutMs` або розбийте довгий конвеєр. - **`lobster output exceeded maxStdoutBytes`** → збільште `maxStdoutBytes` або зменште розмір виводу. - **`lobster returned invalid JSON`** → переконайтеся, що конвеєр працює в режимі інструмента й друкує лише JSON. -- **`lobster failed`** → перевірте журнали Gateway, щоб знайти подробиці помилки вбудованого раннера. +- **`lobster failed`** → перевірте журнали Gateway, щоб побачити подробиці помилки вбудованого раннера. ## Докладніше - [Plugins](/uk/tools/plugin) - [Створення інструментів plugin](/uk/plugins/building-plugins#registering-agent-tools) -## Приклад із практики: спільнотні робочі процеси +## Приклад із практики: робочі процеси спільноти -Один публічний приклад: CLI “другий мозок” + конвеєри Lobster, які керують трьома Markdown-сховищами (особистим, партнерським, спільним). CLI видає JSON для статистики, списків inbox і сканувань застарілого вмісту; Lobster об’єднує ці команди в робочі процеси на кшталт `weekly-review`, `inbox-triage`, `memory-consolidation` і `shared-task-sync`, кожен зі шлюзами затвердження. AI виконує оцінювання (категоризацію), коли доступний, і повертається до детермінованих правил, коли ні. +Один публічний приклад: CLI «другий мозок» + конвеєри Lobster, що керують трьома Markdown-сховищами (особистим, партнерським, спільним). CLI виводить JSON для статистики, списків вхідних і сканування застарілого; Lobster з’єднує ці команди в робочі процеси на кшталт `weekly-review`, `inbox-triage`, `memory-consolidation` і `shared-task-sync`, кожен зі шлюзами схвалення. ШІ виконує оцінювальні дії (категоризацію), коли доступний, і повертається до детермінованих правил, коли ні. -- Потік: [https://x.com/plattenschieber/status/2014508656335770033](https://x.com/plattenschieber/status/2014508656335770033) +- Обговорення: [https://x.com/plattenschieber/status/2014508656335770033](https://x.com/plattenschieber/status/2014508656335770033) - Репозиторій: [https://github.com/bloomedai/brain-cli](https://github.com/bloomedai/brain-cli) ## Пов’язане