chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-03 23:09:19 +00:00
parent 54c6ce7cbb
commit dcba1cf737

View File

@ -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"]`, якщо ви не маєте наміру працювати в обмежувальному режимі списку дозволеного.
<Note>
Allowlists вмикаються за бажанням для необов’язкових plugins. `alsoAllow` вмикає лише названі необов’язкові інструменти plugin, зберігаючи звичайний набір базових інструментів. Щоб обмежити базові інструменти, використовуйте `tools.allow` із потрібними базовими інструментами або групами.
Списки дозволеного є opt-in для необов’язкових plugins. `alsoAllow` вмикає лише названі необов’язкові інструменти plugin, зберігаючи звичайний набір основних інструментів. Щоб обмежити основні інструменти, використовуйте `tools.allow` з потрібними основними інструментами або групами.
</Note>
## Приклад: сортування 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)
## Пов’язане