Tools

Hummer

Lobster ist eine Workflow-Shell, mit der OpenClaw mehrstufige Tool-Sequenzen als einzelne, deterministische Operation mit expliziten Genehmigungs-Checkpoints ausführen kann.

Lobster ist eine Autorisierungsebene oberhalb abgekoppelter Hintergrundarbeit. Für Flow-Orchestrierung oberhalb einzelner Aufgaben siehe Task Flow (openclaw tasks flow). Für das Aktivitätsprotokoll der Aufgaben siehe openclaw tasks.

Hook

Ihr Assistent kann die Tools erstellen, die ihn selbst verwalten. Fragen Sie nach einem Workflow, und 30 Minuten später haben Sie eine CLI plus Pipelines, die als ein Aufruf laufen. Lobster ist das fehlende Stück: deterministische Pipelines, explizite Genehmigungen und fortsetzbarer Zustand.

Warum

Heute erfordern komplexe Workflows viele hin- und hergehende Tool-Aufrufe. Jeder Aufruf kostet Tokens, und das LLM muss jeden Schritt orchestrieren. Lobster verlagert diese Orchestrierung in eine typisierte Runtime:

Ein Aufruf statt vieler: OpenClaw führt einen Lobster-Tool-Aufruf aus und erhält ein strukturiertes Ergebnis.
Genehmigungen integriert: Seiteneffekte (E-Mail senden, Kommentar posten) halten den Workflow an, bis sie explizit genehmigt wurden.
Fortsetzbar: Angehaltene Workflows geben ein Token zurück; genehmigen und fortsetzen, ohne alles erneut auszuführen.

Warum eine DSL statt normaler Programme?

Lobster ist absichtlich klein. Das Ziel ist nicht „eine neue Sprache“, sondern eine vorhersehbare, KI-freundliche Pipeline-Spezifikation mit erstklassigen Genehmigungen und Resume-Tokens.

Genehmigen/Fortsetzen ist integriert: Ein normales Programm kann einen Menschen um Eingabe bitten, aber es kann nicht mit einem dauerhaften Token pausieren und fortgesetzt werden, ohne dass Sie diese Runtime selbst erfinden.
Determinismus + Auditierbarkeit: Pipelines sind Daten, daher lassen sie sich leicht protokollieren, vergleichen, erneut abspielen und prüfen.
Begrenzte Oberfläche für KI: Eine kleine Grammatik + JSON-Piping reduziert „kreative“ Codepfade und macht Validierung realistisch.
Sicherheitsrichtlinie eingebaut: Timeouts, Ausgabelimits, Sandbox-Prüfungen und Allow-Lists werden von der Runtime durchgesetzt, nicht von jedem Skript.
Trotzdem programmierbar: Jeder Schritt kann eine beliebige CLI oder ein Skript aufrufen. Wenn Sie JS/TS möchten, generieren Sie .lobster-Dateien aus Code.

Funktionsweise

OpenClaw führt Lobster-Workflows in-process mit einem eingebetteten Runner aus. Es wird kein externer CLI-Subprozess gestartet; die Workflow-Engine läuft innerhalb des Gateway-Prozesses und gibt direkt einen JSON-Umschlag zurück. Wenn die Pipeline für eine Genehmigung pausiert, gibt das Tool ein resumeToken zurück, damit Sie später fortfahren können.

Muster: kleine CLI + JSON-Pipes + Genehmigungen

Erstellen Sie kleine Befehle, die JSON sprechen, und verketten Sie sie dann zu einem einzelnen Lobster-Aufruf. (Die untenstehenden Beispielbefehlsnamen können Sie durch Ihre eigenen ersetzen.)

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
}

Wenn die Pipeline eine Genehmigung anfordert, setzen Sie sie mit dem Token fort:

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

KI löst den Workflow aus; Lobster führt die Schritte aus. Genehmigungs-Gates halten Seiteneffekte explizit und auditierbar.

Beispiel: Eingabeelemente in Tool-Aufrufe abbilden:

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-Schritte (llm-task)

Für Workflows, die einen strukturierten LLM-Schritt benötigen, aktivieren Sie das optionale llm-task-Plugin-Tool und rufen Sie es aus Lobster auf. So bleibt der Workflow deterministisch, während Sie dennoch mit einem Modell klassifizieren/zusammenfassen/entwerfen können.

Aktivieren Sie das Tool:

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

Verwenden Sie es in einer 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
  }
}'

Details und Konfigurationsoptionen finden Sie unter LLM Task.

Workflow-Dateien (.lobster)

Lobster kann YAML/JSON-Workflow-Dateien mit den Feldern name, args, steps, env, condition und approval ausführen. Setzen Sie in OpenClaw-Tool-Aufrufen pipeline auf den Dateipfad.

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

Hinweise:

stdin: $step.stdout und stdin: $step.json übergeben die Ausgabe eines vorherigen Schritts.
condition (oder when) kann Schritte anhand von $step.approved steuern.

Lobster installieren

Gebündelte Lobster-Workflows laufen in-process; es ist keine separate lobster-Binärdatei erforderlich. Der eingebettete Runner wird mit dem Lobster-Plugin ausgeliefert.

Wenn Sie die eigenständige Lobster-CLI für Entwicklung oder externe Pipelines benötigen, installieren Sie sie aus dem Lobster-Repo und stellen Sie sicher, dass lobster in PATH liegt.

Tool aktivieren

Lobster ist ein optionales Plugin-Tool (standardmäßig nicht aktiviert).

Beispiel: E-Mail-Triage

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

Mit Lobster:

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

Gibt einen JSON-Umschlag zurück (gekürzt):

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

Benutzer genehmigt → fortsetzen:

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

Ein Workflow. Deterministisch. Sicher.

Tool-Parameter

`run`

Führen Sie eine Pipeline im Tool-Modus aus.

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

Führen Sie eine Workflow-Datei mit Argumenten aus:

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

`resume`

Setzen Sie einen angehaltenen Workflow nach der Genehmigung fort.

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

Optionale Eingaben

cwd: Relatives Arbeitsverzeichnis für die Pipeline (muss innerhalb des Gateway-Arbeitsverzeichnisses bleiben).
timeoutMs: Bricht den Workflow ab, wenn er diese Dauer überschreitet (Standard: 20000).
maxStdoutBytes: Bricht den Workflow ab, wenn die Ausgabe diese Größe überschreitet (Standard: 512000).
argsJson: JSON-Zeichenfolge, die an lobster run --args-json übergeben wird (nur Workflow-Dateien).

Ausgabeumschlag

Lobster gibt einen JSON-Umschlag mit einem von drei Statuswerten zurück:

ok → erfolgreich abgeschlossen
needs_approval → pausiert; requiresApproval.resumeToken ist zum Fortsetzen erforderlich
cancelled → explizit abgelehnt oder abgebrochen

Das Tool stellt den Umschlag sowohl in content (formatiertes JSON) als auch in details (Rohobjekt) bereit.

Genehmigungen

Wenn requiresApproval vorhanden ist, prüfen Sie den Prompt und entscheiden Sie:

approve: true → fortsetzen und mit Seiteneffekten weiterfahren
approve: false → Workflow abbrechen und finalisieren

Verwenden Sie approve --preview-from-stdin --limit N, um Genehmigungsanforderungen ohne eigenen jq-/Heredoc-Klebstoff eine JSON-Vorschau anzuhängen. Resume-Tokens sind jetzt kompakt: Lobster speichert den Fortsetzungszustand des Workflows unter seinem State-Verzeichnis und gibt einen kleinen Token-Schlüssel zurück.

OpenProse

OpenProse passt gut zu Lobster: Verwenden Sie /prose, um Multi-Agent-Vorbereitung zu orchestrieren, und führen Sie danach eine Lobster-Pipeline für deterministische Genehmigungen aus. Wenn ein Prose-Programm Lobster benötigt, erlauben Sie das lobster-Tool für Sub-Agents über tools.subagents.tools. Siehe OpenProse.

Sicherheit

Nur lokal in-process – Workflows werden innerhalb des Gateway-Prozesses ausgeführt; keine Netzwerkaufrufe vom Plugin selbst.
Keine Secrets – Lobster verwaltet kein OAuth; es ruft OpenClaw-Tools auf, die das tun.
Sandbox-bewusst – deaktiviert, wenn der Tool-Kontext sandboxed ist.
Gehärtet – Timeouts und Ausgabelimits werden vom eingebetteten Runner durchgesetzt.

Fehlerbehebung

lobster timed out → erhöhen Sie timeoutMs oder teilen Sie eine lange Pipeline auf.
lobster output exceeded maxStdoutBytes → erhöhen Sie maxStdoutBytes oder reduzieren Sie die Ausgabegröße.
lobster returned invalid JSON → stellen Sie sicher, dass die Pipeline im Tool-Modus läuft und nur JSON ausgibt.
lobster failed → prüfen Sie die Gateway-Logs auf Fehlerdetails des eingebetteten Runners.

Weitere Informationen

Fallstudie: Community-Workflows

Ein öffentliches Beispiel: eine „Second Brain“-CLI plus Lobster-Pipelines, die drei Markdown-Vaults verwalten (persönlich, Partner, gemeinsam). Die CLI gibt JSON für Statistiken, Inbox-Listen und Stale-Scans aus; Lobster verkettet diese Befehle zu Workflows wie weekly-review, inbox-triage, memory-consolidation und shared-task-sync, jeweils mit Genehmigungs-Gates. KI übernimmt, wenn verfügbar, die Beurteilung (Kategorisierung) und fällt andernfalls auf deterministische Regeln zurück.

Verwandt

Automatisierung und Aufgaben – Lobster-Workflows planen
Automatisierungsübersicht – alle Automatisierungsmechanismen
Tools-Übersicht – alle verfügbaren Agent-Tools

# Hook

# Warum

# Warum eine DSL statt normaler Programme?

# Funktionsweise

# Muster: kleine CLI + JSON-Pipes + Genehmigungen

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

# Workflow-Dateien (.lobster)

# Lobster installieren

# Tool aktivieren

# Beispiel: E-Mail-Triage

# Tool-Parameter

# run

# resume

# Optionale Eingaben

# Ausgabeumschlag

# Genehmigungen

# OpenProse

# Sicherheit

# Fehlerbehebung

# Weitere Informationen

# Fallstudie: Community-Workflows

# Verwandt