Tools

Kreeft

Lobster is een workflow-shell waarmee OpenClaw meerstaps toolreeksen kan uitvoeren als één deterministische bewerking met expliciete goedkeuringsmomenten.

Lobster is één auteurslaag boven losgekoppeld achtergrondwerk. Zie Taakflow (openclaw tasks flow) voor flow-orkestratie boven individuele taken. Zie openclaw tasks voor het activiteitenlogboek van taken.

Hook

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

Waarom

Tegenwoordig 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: Neveneffecten (e-mail verzenden, opmerking 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 pijplijnspecificatie met ingebouwde goedkeuringen en hervattingstokens.

Goedkeuren/hervatten is ingebouwd: Een normaal programma kan een mens om invoer vragen, maar het kan niet pauzeren en hervatten met een duurzaam token zonder dat je die runtime zelf bedenkt.
Determinisme + controleerbaarheid: Pijplijnen zijn data, dus ze zijn eenvoudig te loggen, vergelijken, opnieuw af te spelen en 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 dan .lobster-bestanden vanuit code.

Hoe het werkt

OpenClaw voert Lobster-workflows in-process uit met een ingebouwde runner. Er wordt geen extern CLI-subproces gestart; de workflow-engine voert uit binnen het gateway-proces en retourneert direct een JSON-envelope. Als de pijplijn 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 tot één 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 pijplijn om goedkeuring vraagt, hervat dan met het token:

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

AI triggert de workflow; Lobster voert de stappen uit. Goedkeuringspoorten houden neveneffecten 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":"..."}'

JSON-only 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": { "alsoAllow": ["llm-task"] }
      }
    ]
  }
}

Gebruik deze in een pijplijn:

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 Task voor details en configuratieopties.

Workflowbestanden (.lobster)

Lobster kan YAML/JSON-workflowbestanden uitvoeren met de velden name, args, steps, env, condition en approval. 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

Opmerkingen:

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

Lobster installeren

Gebundelde Lobster-workflows draaien in-process; er is geen afzonderlijke lobster-binary vereist. De ingebouwde runner wordt geleverd met de Lobster-Plugin.

Als je de zelfstandige Lobster-CLI nodig hebt voor ontwikkeling of externe pijplijnen, 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 bewust in restrictieve allowlist-modus wilt draaien.

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 (ingekort):

{
  "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 pijplijn 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 pijplijn (moet binnen de werkdirectory van de gateway 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 dan de prompt en beslis:

approve: true → hervat en ga door met neveneffecten
approve: false → annuleer en rond de workflow af

Gebruik approve --preview-from-stdin --limit N om een JSON-preview aan goedkeuringsverzoeken toe te voegen 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 voorbereiding met meerdere agents te orkestreren en voer daarna een Lobster-pijplijn uit voor deterministische goedkeuringen. Als een Prose-programma Lobster nodig heeft, sta dan de lobster-tool toe voor sub-agents via tools.subagents.tools. Zie OpenProse.

Veiligheid

Alleen lokaal in-process - workflows worden uitgevoerd binnen het gateway-proces; 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 in een sandbox draait.
Verhard - time-outs en uitvoerlimieten worden afgedwongen door de ingebouwde runner.

Probleemoplossing

lobster timed out → verhoog timeoutMs, of splits een lange pijplijn.
lobster output exceeded maxStdoutBytes → verhoog maxStdoutBytes of verklein de uitvoer.
lobster returned invalid JSON → zorg dat de pijplijn in toolmodus draait en alleen JSON afdrukt.
lobster failed → controleer gateway-logs voor foutdetails van de ingebouwde runner.

Meer informatie

Casestudy: community-workflows

Eén openbaar voorbeeld: een "second brain"-CLI + Lobster-pijplijnen 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 tot workflows zoals weekly-review, inbox-triage, memory-consolidation en shared-task-sync, elk met goedkeuringspoorten. AI verwerkt oordeelsvorming (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

# Hook

# Waarom

# Waarom een DSL in plaats van gewone programma's?

# Hoe het werkt

# Patroon: kleine CLI + JSON-pipes + goedkeuringen

# JSON-only LLM-stappen (llm-task)

# Workflowbestanden (.lobster)

# Lobster installeren

# De tool inschakelen

# Voorbeeld: e-mailtriage

# Toolparameters

# run

# resume

# Optionele invoer

# Uitvoer-envelope

# Goedkeuringen

# OpenProse

# Veiligheid

# Probleemoplossing

# Meer informatie

# Casestudy: community-workflows

# Gerelateerd