chore(i18n): refresh uk translations
This commit is contained in:
parent
54c6ce7cbb
commit
dcba1cf737
@ -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)
|
||||
|
||||
## Пов’язане
|
||||
|
||||
Loading…
Reference in New Issue
Block a user