Community translations by veiseule.ai — Help improve them on Crowdin
Skip to main content

Lobster

Lobster er en workflow-shell, der lader OpenClaw køre flertrins værktøjssekvenser som én samlet, deterministisk operation med eksplicitte godkendelseskontrolpunkter.

Hook

Din assistent kan bygge de værktøjer, der styrer sig selv. Bed om en arbejdsgang, og 30 minutter senere har du en CLI plus rørledninger, der kører som et opkald. Hummer er det manglende stykke: deterministiske rørledninger, eksplicitte godkendelser og genoptagelsestilstand.

Hvorfor

I dag kræver komplekse arbejdsgange mange back-og-tilbage værktøjskald. Hvert opkald omkostninger tokens, og LLM har til at orkestrere hvert trin. Hummer flytter at orkestration ind i en indtastet driftstid:

  • Ét kald i stedet for mange: OpenClaw kører ét Lobster-værktøjskald og får et struktureret resultat.
  • Godkendelser indbygget: Sideeffekter (send e-mail, post kommentar) stopper workflowet, indtil det eksplicit godkendes.
  • Genoptagelig: Stoppede workflows returnerer et token; godkend og genoptag uden at genkøre det hele.

Hvorfor en DSL i stedet for almindelige programmer?

Hummer er forsætligt lille. Målet er ikke "et nyt sprog", det er en forudsigelig, AI-venlig rørledning spec med førsteklasses godkendelser og genoptage tokens.

  • Godkend/genoptag er indbygget: Et almindeligt program kan spørge et menneske, men det kan ikke pause og genoptage med et holdbart token uden at du selv opfinder den runtime.
  • Determinisme + sporbarhed: Pipelines er data, så de er nemme at logge, diff’e, afspille igen og gennemse.
  • Begrænset overflade for AI: En lille grammatik + JSON-piping reducerer “kreative” kodeveje og gør validering realistisk.
  • Sikkerhedspolitik indbygget: Timeouts, outputlofter, sandbox-tjek og tilladelseslister håndhæves af runtimen, ikke af hvert script.
  • ** Stadig programmerbar **: Hvert trin kan kalde enhver CLI eller script. Hvis du vil have JS/TS, generer .lobster filer fra kode.

Sådan fungerer det

OpenClaw lancerer den lokale lobster CLI i ** værktøjstilstand** og analyserer en JSON konvolut fra stdout. Hvis rørledningen holder pause for godkendelse, returnerer værktøjet et et 'resumeToken', så du kan fortsætte senere.

Mønster: lille CLI + JSON-pipes + godkendelser

Byg små kommandoer, der taler JSON, derefter kæde dem ind i en enkelt Hummer opkald. (Eksempel kommandonavne nedenfor — byt i din egen.)

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
}

Hvis pipelinen anmoder om godkendelse, så genoptag med tokenet:

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

AI udløser arbejdsgangen; Lobster udfører trinene. Godkendelse porte holde bivirkninger eksplicitte og kontrollerbare.

Eksempel: map input-elementer til værktøjskald:

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

Kun JSON LLM-trin (llm-task)

For arbejdsgange, der har brug for et struktureret LLM trin, skal du aktivere det valgfrie llm-task plugin-værktøj og kalde det fra Lobster. Dette holder arbejdsgangen deterministisk, mens du stadig lader dig klassificere/opsummere/udkast med en model.

Aktivér værktøjet:

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

Brug det i en pipeline:

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

Se LLM Task for detaljer og konfigurationsmuligheder.

Workflow-filer (.lobster)

Lobster kan køre YAML/JSON workflow filer med name, args, steps, env, condition, og approval felter. I OpenClaw værktøj kalder, sæt pipeline til filen stien.

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

Noter:

  • stdin: $step.stdout og stdin: $step.json videresender output fra et tidligere trin.
  • condition (eller when) kan gate trin baseret på $step.approved.

Installér Lobster

Installer Hummer CLI på den samme vært, der kører OpenClaw Gateway (se Hummer repo), og sørg for, at hummer er på PATH. Hvis du ønsker at bruge en brugerdefineret binær placering, passere en absolute lobsterPath i værktøjskaldet.

Aktivér værktøjet

Lobster er et valgfrit plugin-værktøj (ikke aktiveret som standard).

Anbefalet (additivt, sikkert):

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

Eller pr. agent:

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

Undgå at bruge tools.allow: ["lobster"], medmindre du har til hensigt at køre i restriktiv tilladelsesliste-tilstand.

Bemærk: Tilladslister er valgfri for valgfri plugins. Hvis din tilladelse kun navne plugin værktøjer (som lobster), OpenClaw holder kerneværktøjer aktiveret. For at begrænse kerneværktøjet skal du også inkludere de kerneværktøjer eller grupper, du ønsker i tilladelseslisten.

Example: Email triage

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

Med Lobster:

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

Returnerer en JSON-envelope (afkortet):

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

Bruger godkender → genoptag:

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

En arbejdsgang. Bestemmende. Sikker.

Tool parameters

run

Kør en pipeline i tool mode.

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

Kør en workflow-fil med argumenter:

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

resume

Fortsæt et stoppet workflow efter godkendelse.

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

Optional inputs

  • lobsterPath: Absolut sti til Lobster-binæren (udelad for at bruge PATH).
  • cwd: Arbejdsmappe for pipelinen (standard er den aktuelle proces’ arbejdsmappe).
  • timeoutMs: Dræb underprocessen, hvis den overstiger denne varighed (standard: 20000).
  • maxStdoutBytes: Dræb underprocessen, hvis stdout overstiger denne størrelse (standard: 512000).
  • argsJson: JSON-streng sendt til lobster run --args-json (kun workflow-filer).

Output envelope

Lobster returnerer en JSON-envelope med én af tre statusser:

  • ok → afsluttet med succes
  • needs_approval → pauset; requiresApproval.resumeToken er påkrævet for at genoptage
  • cancelled → eksplicit afvist eller annulleret

Værktøjet eksponerer envelopen både i content (pæn JSON) og details (råt objekt).

Approvals

Hvis requiresApproval er til stede, så inspicér prompten og beslut:

  • approve: true → genoptag og fortsæt sideeffekter
  • approve: false → annullér og afslut workflowet

Brug Godkend --preview-from-stdin --limit N for at vedhæfte en JSON forhåndsvisning til godkendelsesanmodninger uden brugerdefineret jq/heredoc lim. Genoptag tokens er nu komprimeret: Hummer butikker arbejdsgangen genoptage tilstand under sin tilstand dir og hænder tilbage en lille symbolsk nøgle.

OpenProse

OpenProse par godt med Lobster: bruge /prose at orkestrere multi-agent prep, derefter køre en Hummer rørledning for deterministiske godkendelser. Hvis et Prose program har brug for Lobster, tillade den lobster værktøj for sub-agenter via tools.subagents.tools. Se OpenProse.

Safety

  • Kun lokale underprocesser — ingen netværkskald fra selve plugin’et.
  • Ingen hemmeligheder — Lobster håndterer ikke OAuth; det kalder OpenClaw-værktøjer, der gør.
  • Sandbox-aware — deaktiveret, når værktøjskonteksten er sandboxed.
  • Hærdet — lobsterPath skal være absolut, hvis angivet; timeouts og outputlofter håndhæves.

Troubleshooting

  • lobster subprocess timed out → øg timeoutMs, eller opdel en lang pipeline.
  • lobster output exceeded maxStdoutBytes → hæv maxStdoutBytes eller reducer outputstørrelsen.
  • lobster returned invalid JSON → sørg for, at pipelinen kører i tool mode og kun printer JSON.
  • lobster failed (code …) → kør den samme pipeline i en terminal for at inspicere stderr.

Learn more

Case study: community workflows

Et offentligt eksempel: en “anden hjerne” CLI + Hummer rørledninger, der styrer tre Markdown hvælvinger (personlig, partner, delt). CLI udsender JSON for statistik, indbakke lister og robuste scanninger. Lobster kæder disse kommandoer ind i arbejdsgange som ugentligt review, inbox-triage, memory-consolidation, og delt-task-sync, hver med godkendelsesporte. AI håndterer dom (kategorisering), når den er tilgængelig, og falder tilbage til deterministiske regler, når ikke.

veiseule.ai — Community translations maintained by John Kelly. Improve translations on Crowdin.