Омар

Lobster — це workflow shell, який дозволяє OpenClaw запускати багатоетапні послідовності інструментів як одну детерміновану операцію з явними контрольними точками схвалення. Lobster — це шар авторингу над від’єднаною фоновою роботою. Для оркестрації потоків над окремими завданнями див. Task Flow (openclaw tasks flow). Для журналу активності завдань див. openclaw tasks.

Хук

Ваш асистент може створювати інструменти, які керують ним самим. Попросіть workflow, і через 30 хвилин матимете CLI плюс конвеєри, що запускаються одним викликом. Lobster — це відсутня частина: детерміновані конвеєри, явні схвалення та стан, який можна відновити.

Навіщо

Сьогодні складні workflow потребують багатьох взаємних викликів інструментів. Кожен виклик коштує токенів, а LLM має оркеструвати кожен крок. Lobster переносить цю оркестрацію в типізоване середовище виконання:

Один виклик замість багатьох: OpenClaw виконує один виклик інструмента Lobster і отримує структурований результат.
Вбудовані схвалення: побічні ефекти (надіслати email, опублікувати коментар) зупиняють workflow до явного схвалення.
Можна відновити: зупинені workflow повертають токен; схваліть і відновіть без повторного запуску всього.

Чому DSL замість звичайних програм?

Lobster навмисно малий. Мета — не «нова мова», а передбачувана, зручна для AI специфікація конвеєра з першокласними схваленнями та токенами відновлення.

Схвалення/відновлення вбудовано: звичайна програма може запитати людину, але не може призупинитися й відновитися зі сталим токеном, якщо ви самі не створите таке середовище виконання.
Детермінізм + аудитованість: конвеєри — це дані, тому їх легко логувати, порівнювати, відтворювати й переглядати.
Обмежена поверхня для AI: крихітна граматика + JSON-пайпи зменшують «творчі» шляхи коду та роблять валідацію реалістичною.
Політика безпеки вбудована: тайм-аути, ліміти виводу, перевірки sandbox та allowlist забезпечуються середовищем виконання, а не кожним скриптом.
Усе ще програмований: кожен крок може викликати будь-який CLI або скрипт. Якщо вам потрібен JS/TS, генеруйте файли .lobster з коду.

Як це працює

OpenClaw запускає workflow Lobster у процесі за допомогою вбудованого runner. Зовнішній CLI subprocess не запускається; рушій workflow виконується всередині процесу gateway і повертає JSON-конверт напряму. Якщо конвеєр призупиняється для схвалення, інструмент повертає resumeToken, щоб ви могли продовжити пізніше.

Патерн: малий CLI + JSON-пайпи + схвалення

Створюйте маленькі команди, які говорять JSON, а потім з’єднуйте їх в один виклик Lobster. (Назви команд нижче наведено як приклад — замініть їх власними.)

inbox list --json
inbox categorize --json
inbox apply --json

{
  "action": "run",
  "pipeline": "exec --json --shell 'inbox list --json' | exec --stdin json --shell 'inbox categorize --json' | exec --stdin json --shell 'inbox apply --json' | approve --preview-from-stdin --limit 5 --prompt 'Apply changes?'",
  "timeoutMs": 30000
}

Якщо конвеєр запитує схвалення, відновіть його з токеном:

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

AI запускає workflow; Lobster виконує кроки. Шлюзи схвалення роблять побічні ефекти явними й придатними для аудиту. Приклад: зіставити вхідні елементи з викликами інструментів:

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)

Для workflow, яким потрібен структурований крок LLM, увімкніть необов’язковий інструмент плагіна llm-task і викликайте його з Lobster. Це зберігає workflow детермінованим, водночас дозволяючи класифікувати/підсумовувати/чернеткувати за допомогою моделі. Увімкніть інструмент:

{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  },
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": { "alsoAllow": ["llm-task"] }
      }
    ]
  }
}

Важливе обмеження: вбудований Lobster проти `openclaw.invoke`

Вбудований плагін Lobster запускає workflow у процесі всередині gateway. У цьому вбудованому режимі openclaw.invoke не успадковує автоматично URL/auth-контекст gateway для вкладених викликів інструментів OpenClaw CLI. Це означає, що цей патерн наразі ненадійний у вбудованому runner:

openclaw.invoke --tool llm-task --action json --args-json '{ ... }'

Використовуйте приклад нижче лише під час запуску окремого Lobster CLI у середовищі, де openclaw.invoke уже налаштовано з правильним gateway/auth-контекстом. Використовуйте його в окремому конвеєрі Lobster CLI:

openclaw.invoke --tool llm-task --action json --args-json '{
  "prompt": "Given the input email, return intent and draft.",
  "thinking": "low",
  "input": { "subject": "Hello", "body": "Can you help?" },
  "schema": {
    "type": "object",
    "properties": {
      "intent": { "type": "string" },
      "draft": { "type": "string" }
    },
    "required": ["intent", "draft"],
    "additionalProperties": false
  }
}'

Якщо ви сьогодні використовуєте вбудований плагін Lobster, надавайте перевагу одному з варіантів:

прямому виклику інструмента llm-task поза Lobster, або
крокам без openclaw.invoke всередині конвеєра Lobster, доки не буде додано підтримуваний вбудований міст.

Див. LLM Task, щоб дізнатися деталі та параметри конфігурації.

Файли workflow (.lobster)

Lobster може запускати YAML/JSON-файли workflow з полями name, args, steps, env, condition і approval. У викликах інструментів OpenClaw встановіть pipeline на шлях до файлу.

name: inbox-triage
args:
  tag:
    default: "family"
steps:
  - id: collect
    command: inbox list --json
  - id: categorize
    command: inbox categorize --json
    stdin: $collect.stdout
  - id: approve
    command: inbox apply --approve
    stdin: $categorize.stdout
    approval: required
  - id: execute
    command: inbox apply --execute
    stdin: $categorize.stdout
    condition: $approve.approved

Примітки:

stdin: $step.stdout і stdin: $step.json передають вивід попереднього кроку.
condition (або when) може обмежувати кроки за $step.approved.

Установлення Lobster

Вбудовані workflow Lobster виконуються у процесі; окремий binary lobster не потрібен. Вбудований runner постачається з плагіном Lobster. Якщо вам потрібен окремий Lobster CLI для розробки або зовнішніх конвеєрів, установіть його з репозиторію Lobster і переконайтеся, що lobster є в PATH.

Увімкнення інструмента

Lobster — це необов’язковий інструмент плагіна (не ввімкнений за замовчуванням). Рекомендовано (адитивно, безпечно):

{
  "tools": {
    "alsoAllow": ["lobster"]
  }
}

Або для окремого агента:

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "alsoAllow": ["lobster"]
        }
      }
    ]
  }
}

Уникайте використання tools.allow: ["lobster"], якщо не маєте наміру працювати в обмежувальному режимі allowlist.

Allowlists вмикаються явно для необов’язкових плагінів. alsoAllow вмикає лише названі необов’язкові інструменти плагінів, зберігаючи звичайний набір основних інструментів. Щоб обмежити основні інструменти, використовуйте tools.allow з потрібними основними інструментами або групами.

Приклад: сортування email

Без Lobster:

User: "Check my email and draft replies"
→ openclaw calls gmail.list
→ LLM summarizes
→ User: "draft replies to #2 and #5"
→ LLM drafts
→ User: "send #2"
→ openclaw calls gmail.send
(repeat daily, no memory of what was triaged)

З Lobster:

{
  "action": "run",
  "pipeline": "email.triage --limit 20",
  "timeoutMs": 30000
}

Повертає JSON-конверт (скорочено):

{
  "ok": true,
  "status": "needs_approval",
  "output": [{ "summary": "5 need replies, 2 need action" }],
  "requiresApproval": {
    "type": "approval_request",
    "prompt": "Send 2 draft replies?",
    "items": [],
    "resumeToken": "..."
  }
}

Користувач схвалює → відновлення:

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

Один workflow. Детермінований. Безпечний.

Параметри інструмента

`run`

Запустити конвеєр у режимі інструмента.

{
  "action": "run",
  "pipeline": "gog.gmail.search --query 'newer_than:1d' | email.triage",
  "cwd": "workspace",
  "timeoutMs": 30000,
  "maxStdoutBytes": 512000
}

Запустити файл workflow з аргументами:

{
  "action": "run",
  "pipeline": "/path/to/inbox-triage.lobster",
  "argsJson": "{\"tag\":\"family\"}"
}

`resume`

Продовжити зупинений workflow після схвалення.

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

Необов’язкові вхідні параметри

cwd: відносний робочий каталог для конвеєра (має залишатися в межах робочого каталогу gateway).
timeoutMs: перервати workflow, якщо він перевищує цю тривалість (за замовчуванням: 20000).
maxStdoutBytes: перервати workflow, якщо вивід перевищує цей розмір (за замовчуванням: 512000).
argsJson: JSON-рядок, переданий до lobster run --args-json (лише для файлів workflow).

Вихідний конверт

Lobster повертає JSON-конверт з одним із трьох статусів:

ok → завершено успішно
needs_approval → призупинено; для відновлення потрібен requiresApproval.resumeToken
cancelled → явно відхилено або скасовано

Інструмент показує конверт і в content (форматований JSON), і в details (сирий об’єкт).

Схвалення

Якщо присутній requiresApproval, перевірте prompt і вирішіть:

approve: true → відновити й продовжити побічні ефекти
approve: false → скасувати й фіналізувати workflow

Використовуйте approve --preview-from-stdin --limit N, щоб додати JSON-попередній перегляд до запитів на схвалення без власного jq/heredoc glue. Токени відновлення тепер компактні: Lobster зберігає стан відновлення workflow у своєму каталозі стану й повертає малий ключ токена.

OpenProse

OpenProse добре поєднується з Lobster: використовуйте /prose для оркестрації підготовки з кількома агентами, а потім запускайте конвеєр Lobster для детермінованих схвалень. Якщо програмі Prose потрібен Lobster, дозвольте інструмент lobster для субагентів через tools.subagents.tools. Див. OpenProse.

Безпека

Лише локально в процесі - workflow виконуються всередині процесу gateway; сам плагін не робить мережевих викликів.
Без секретів - Lobster не керує OAuth; він викликає інструменти OpenClaw, які це роблять.
З урахуванням sandbox - вимикається, коли контекст інструмента працює в sandbox.
Посилений - тайм-аути й ліміти виводу забезпечуються вбудованим runner.

Усунення несправностей

lobster timed out → збільште timeoutMs або розділіть довгий конвеєр.
lobster output exceeded maxStdoutBytes → збільште maxStdoutBytes або зменште розмір виводу.
lobster returned invalid JSON → переконайтеся, що конвеєр запускається в режимі інструмента й друкує лише JSON.
lobster failed → перевірте логи gateway, щоб побачити деталі помилки вбудованого runner.

Дізнатися більше

Приклад: community workflow

Один публічний приклад: CLI «second brain» + конвеєри Lobster, які керують трьома Markdown-сховищами (особистим, партнерським, спільним). CLI виводить JSON для статистики, списків inbox і сканування застарілих елементів; Lobster об’єднує ці команди у workflow на кшталт weekly-review, inbox-triage, memory-consolidation і shared-task-sync, кожен із шлюзами схвалення. AI обробляє судження (категоризацію), коли доступний, і повертається до детермінованих правил, коли ні.

Тред: https://x.com/plattenschieber/status/2014508656335770033
Репозиторій: https://github.com/bloomedai/brain-cli

Пов’язане

Автоматизація - планування workflow Lobster
Огляд автоматизації - усі механізми автоматизації
Огляд інструментів - усі доступні інструменти агента

Overview

Plugins

Bundled plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Хук

Навіщо

Чому DSL замість звичайних програм?

Як це працює

Патерн: малий CLI + JSON-пайпи + схвалення

Кроки LLM лише з JSON (llm-task)

Важливе обмеження: вбудований Lobster проти `openclaw.invoke`

Файли workflow (.lobster)

Установлення Lobster

Увімкнення інструмента

Приклад: сортування email

Параметри інструмента

`run`

`resume`

Необов’язкові вхідні параметри

Вихідний конверт

Схвалення

OpenProse

Безпека

Усунення несправностей

Дізнатися більше

Приклад: community workflow

Пов’язане

Overview

Plugins

Bundled plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Documentation Index

​Хук

​Навіщо

​Чому DSL замість звичайних програм?

​Як це працює

​Патерн: малий CLI + JSON-пайпи + схвалення

​Кроки LLM лише з JSON (llm-task)

​Важливе обмеження: вбудований Lobster проти openclaw.invoke

​Файли workflow (.lobster)

​Установлення Lobster

​Увімкнення інструмента

​Приклад: сортування email

​Параметри інструмента

​run

​resume

​Необов’язкові вхідні параметри

​Вихідний конверт

​Схвалення

​OpenProse

​Безпека

​Усунення несправностей

​Дізнатися більше

​Приклад: community workflow

​Пов’язане

Хук

Навіщо

Чому DSL замість звичайних програм?

Як це працює

Патерн: малий CLI + JSON-пайпи + схвалення

Кроки LLM лише з JSON (llm-task)

Важливе обмеження: вбудований Lobster проти `openclaw.invoke`

Файли workflow (.lobster)

Установлення Lobster

Увімкнення інструмента

Приклад: сортування email

Параметри інструмента

`run`

`resume`

Необов’язкові вхідні параметри

Вихідний конверт

Схвалення

OpenProse

Безпека

Усунення несправностей

Дізнатися більше

Приклад: community workflow

Пов’язане