Kreeft

Lobster is een workflowshell waarmee OpenClaw meerstapstoolreeksen kan uitvoeren als één enkele, deterministische bewerking met expliciete goedkeuringscontrolepunten. Lobster is één authoringlaag boven losgekoppeld achtergrondwerk. Voor flow-orkestratie boven individuele taken, zie Taakstroom (openclaw tasks flow). Voor het taakactiviteitenlogboek, zie openclaw tasks.

Hook

Je assistent kan de tools bouwen waarmee hij zichzelf beheert. Vraag om een workflow, en 30 minuten later heb je een CLI plus pipelines die als één aanroep draaien. Lobster is het ontbrekende stuk: deterministische pipelines, expliciete goedkeuringen en hervatbare status.

Waarom

Vandaag vereisen complexe workflows veel heen-en-weergaande toolaanroepen. Elke aanroep kost tokens, en de LLM moet elke stap orkestreren. Lobster verplaatst die orkestratie naar een getypte runtime:

Eén aanroep in plaats van veel: OpenClaw voert één Lobster-toolaanroep uit en krijgt een gestructureerd resultaat.
Goedkeuringen ingebouwd: Bijwerkingen (e-mail verzenden, reactie plaatsen) pauzeren de workflow totdat ze expliciet zijn goedgekeurd.
Hervatbaar: Gepauzeerde workflows retourneren een token; keur goed en hervat zonder alles opnieuw uit te voeren.

Waarom een DSL in plaats van gewone programma’s?

Lobster is bewust klein. Het doel is niet “een nieuwe taal”, maar een voorspelbare, AI-vriendelijke pipelinespecificatie met eersteklas goedkeuringen en hervattingstokens.

Goedkeuren/hervatten is ingebouwd: Een normaal programma kan een mens om input vragen, maar het kan niet pauzeren en hervatten met een duurzaam token zonder dat je die runtime zelf uitvindt.
Determinisme + controleerbaarheid: Pipelines zijn data, dus ze zijn eenvoudig te loggen, diffen, opnieuw af te spelen en te beoordelen.
Beperkt oppervlak voor AI: Een kleine grammatica + JSON-piping vermindert “creatieve” codepaden en maakt validatie realistisch.
Veiligheidsbeleid ingebakken: Time-outs, uitvoerlimieten, sandboxcontroles en allowlists worden afgedwongen door de runtime, niet door elk script.
Nog steeds programmeerbaar: Elke stap kan elke CLI of elk script aanroepen. Als je JS/TS wilt, genereer .lobster-bestanden vanuit code.

Hoe het werkt

OpenClaw voert Lobster-workflows in-process uit met een ingebedde runner. Er wordt geen extern CLI-subproces gestart; de workflowengine voert uit binnen het gatewayproces en retourneert rechtstreeks een JSON-envelope. Als de pipeline pauzeert voor goedkeuring, retourneert de tool een resumeToken zodat je later kunt doorgaan.

Patroon: kleine CLI + JSON-pipes + goedkeuringen

Bouw kleine commando’s die JSON spreken en keten ze vervolgens in één enkele Lobster-aanroep. (Voorbeeldcommandonamen hieronder — vervang ze door je eigen namen.)

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
}

Als de pipeline om goedkeuring vraagt, hervat je met het token:

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

AI triggert de workflow; Lobster voert de stappen uit. Goedkeuringspoorten houden bijwerkingen expliciet en controleerbaar. Voorbeeld: invoeritems omzetten naar toolaanroepen:

gog.gmail.search --query 'newer_than:1d' \
  | openclaw.invoke --tool message --action send --each --item-key message --args-json '{"provider":"telegram","to":"..."}'

Alleen-JSON LLM-stappen (llm-task)

Voor workflows die een gestructureerde LLM-stap nodig hebben, schakel je de optionele llm-task-Plugin-tool in en roep je die aan vanuit Lobster. Dit houdt de workflow deterministisch terwijl je nog steeds met een model kunt classificeren/samenvatten/opstellen. Schakel de tool in:

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

Gebruik deze in een pipeline:

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
  }
}'

Zie LLM-taak voor details en configuratieopties.

Workflowbestanden (.lobster)

Lobster kan YAML/JSON-workflowbestanden uitvoeren met name, args, steps, env, condition en approval-velden. Stel in OpenClaw-toolaanroepen pipeline in op het bestandspad.

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

Notities:

stdin: $step.stdout en stdin: $step.json geven de uitvoer van een eerdere stap door.
condition (of when) kan stappen poorten op $step.approved.

Lobster installeren

Gebundelde Lobster-workflows draaien in-process; er is geen aparte lobster-binary vereist. De ingebedde runner wordt meegeleverd met de Lobster-Plugin. Als je de zelfstandige Lobster-CLI nodig hebt voor ontwikkeling of externe pipelines, installeer die dan vanuit de Lobster-repo en zorg dat lobster op PATH staat.

De tool inschakelen

Lobster is een optionele Plugin-tool (niet standaard ingeschakeld). Aanbevolen (additief, veilig):

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

Of per agent:

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

Vermijd het gebruik van tools.allow: ["lobster"], tenzij je van plan bent in restrictieve allowlistmodus te draaien.

Allowlists zijn opt-in voor optionele plugins. Als je allowlist alleen Plugin-tools noemt (zoals lobster), houdt OpenClaw kerntools ingeschakeld. Om kerntools te beperken, neem je ook de kerntools of groepen op die je in de allowlist wilt hebben.

Voorbeeld: e-mailtriage

Zonder 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)

Met Lobster:

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

Retourneert een JSON-envelope (afgekapt):

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

Gebruiker keurt goed → hervatten:

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

Eén workflow. Deterministisch. Veilig.

Toolparameters

`run`

Voer een pipeline uit in toolmodus.

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

Voer een workflowbestand uit met args:

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

`resume`

Ga door met een gepauzeerde workflow na goedkeuring.

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

Optionele invoer

cwd: Relatieve werkdirectory voor de pipeline (moet binnen de gatewaywerkdirectory blijven).
timeoutMs: Breek de workflow af als deze deze duur overschrijdt (standaard: 20000).
maxStdoutBytes: Breek de workflow af als de uitvoer deze grootte overschrijdt (standaard: 512000).
argsJson: JSON-string die wordt doorgegeven aan lobster run --args-json (alleen workflowbestanden).

Uitvoer-envelope

Lobster retourneert een JSON-envelope met een van drie statussen:

ok → succesvol voltooid
needs_approval → gepauzeerd; requiresApproval.resumeToken is vereist om te hervatten
cancelled → expliciet geweigerd of geannuleerd

De tool toont de envelope zowel in content (mooie JSON) als in details (ruw object).

Goedkeuringen

Als requiresApproval aanwezig is, inspecteer je de prompt en beslis je:

approve: true → hervat en ga door met bijwerkingen
approve: false → annuleer en voltooi de workflow

Gebruik approve --preview-from-stdin --limit N om een JSON-preview aan goedkeuringsverzoeken te koppelen zonder aangepaste jq/heredoc-lijm. Hervattingstokens zijn nu compact: Lobster slaat de hervattingsstatus van workflows op onder zijn statusdirectory en geeft een kleine tokensleutel terug.

OpenProse

OpenProse werkt goed samen met Lobster: gebruik /prose om multi-agentvoorbereiding te orkestreren en voer daarna een Lobster-pipeline uit voor deterministische goedkeuringen. Als een Prose-programma Lobster nodig heeft, sta dan de lobster-tool toe voor subagents via tools.subagents.tools. Zie OpenProse.

Veiligheid

Alleen lokaal in-process — workflows worden uitgevoerd binnen het gatewayproces; geen netwerkoproepen vanuit de Plugin zelf.
Geen geheimen — Lobster beheert geen OAuth; het roept OpenClaw-tools aan die dat doen.
Sandbox-bewust — uitgeschakeld wanneer de toolcontext gesandboxt is.
Verhard — time-outs en uitvoerlimieten worden afgedwongen door de ingebedde runner.

Problemen oplossen

lobster timed out → verhoog timeoutMs, of splits een lange pipeline.
lobster output exceeded maxStdoutBytes → verhoog maxStdoutBytes of verminder de uitvoergrootte.
lobster returned invalid JSON → zorg dat de pipeline in toolmodus draait en alleen JSON print.
lobster failed → controleer gatewaylogs voor foutdetails van de ingebedde runner.

Meer informatie

Casestudy: communityworkflows

Eén openbaar voorbeeld: een “second brain”-CLI + Lobster-pipelines die drie Markdown-vaults beheren (persoonlijk, partner, gedeeld). De CLI geeft JSON uit voor statistieken, inboxlijsten en scans op verouderde inhoud; Lobster ketent die commando’s in workflows zoals weekly-review, inbox-triage, memory-consolidation en shared-task-sync, elk met goedkeuringspoorten. AI handelt beoordeling af (categorisatie) wanneer beschikbaar en valt terug op deterministische regels wanneer dat niet zo is.

Gerelateerd

Automatisering en taken — Lobster-workflows plannen
Automatiseringsoverzicht — alle automatiseringsmechanismen
Toolsoverzicht — alle beschikbare agenttools

Overview

Plugins

Skills

Automation and tasks

Tools

Agent coordination

Hook

Waarom

Waarom een DSL in plaats van gewone programma’s?

Hoe het werkt

Patroon: kleine CLI + JSON-pipes + goedkeuringen

Alleen-JSON LLM-stappen (llm-task)

Workflowbestanden (.lobster)

Lobster installeren

De tool inschakelen

Voorbeeld: e-mailtriage

Toolparameters

`run`

`resume`

Optionele invoer

Uitvoer-envelope

Goedkeuringen

OpenProse

Veiligheid

Problemen oplossen

Meer informatie

Casestudy: communityworkflows

Gerelateerd

Overview

Plugins

Skills

Automation and tasks

Tools

Agent coordination

Documentation Index

​Hook

​Waarom

​Waarom een DSL in plaats van gewone programma’s?

​Hoe het werkt

​Patroon: kleine CLI + JSON-pipes + goedkeuringen

​Alleen-JSON LLM-stappen (llm-task)

​Workflowbestanden (.lobster)

​Lobster installeren

​De tool inschakelen

​Voorbeeld: e-mailtriage

​Toolparameters

​run

​resume

​Optionele invoer

​Uitvoer-envelope

​Goedkeuringen

​OpenProse

​Veiligheid

​Problemen oplossen

​Meer informatie

​Casestudy: communityworkflows

​Gerelateerd

Hook

Waarom

Waarom een DSL in plaats van gewone programma’s?

Hoe het werkt

Patroon: kleine CLI + JSON-pipes + goedkeuringen

Alleen-JSON LLM-stappen (llm-task)

Workflowbestanden (.lobster)

Lobster installeren

De tool inschakelen

Voorbeeld: e-mailtriage

Toolparameters

`run`

`resume`

Optionele invoer

Uitvoer-envelope

Goedkeuringen

OpenProse

Veiligheid

Problemen oplossen

Meer informatie

Casestudy: communityworkflows

Gerelateerd