Tools

Homard

Lobster est un shell de workflow qui permet à OpenClaw d’exécuter des séquences d’outils en plusieurs étapes comme une seule opération déterministe, avec des points de validation explicites.

Lobster est une couche d’auteur au-dessus du travail détaché en arrière-plan. Pour l’orchestration de flux au-dessus des tâches individuelles, consultez Flux de tâches (openclaw tasks flow). Pour le registre d’activité des tâches, consultez openclaw tasks.

Hook

Votre assistant peut créer les outils qui le gèrent lui-même. Demandez un workflow, et 30 minutes plus tard vous disposez d’une CLI et de pipelines qui s’exécutent en un seul appel. Lobster est la pièce manquante : pipelines déterministes, validations explicites et état reprenable.

Pourquoi

Aujourd’hui, les workflows complexes exigent de nombreux appels d’outils avec aller-retour. Chaque appel consomme des tokens, et le LLM doit orchestrer chaque étape. Lobster déplace cette orchestration dans un runtime typé :

Un appel au lieu de plusieurs : OpenClaw exécute un seul appel d’outil Lobster et obtient un résultat structuré.
Validations intégrées : les effets de bord (envoyer un e-mail, publier un commentaire) interrompent le workflow jusqu’à validation explicite.
Reprenable : les workflows interrompus renvoient un token ; validez puis reprenez sans tout réexécuter.

Pourquoi un DSL plutôt que des programmes classiques ?

Lobster est volontairement petit. L’objectif n’est pas « un nouveau langage », mais une spécification de pipeline prévisible et adaptée à l’IA, avec validations de premier ordre et tokens de reprise.

Validation/reprise intégrée : un programme normal peut demander une validation humaine, mais il ne peut pas s’interrompre puis reprendre avec un token durable sans que vous inventiez vous-même ce runtime.
Déterminisme + auditabilité : les pipelines sont des données ; ils sont donc faciles à journaliser, comparer, rejouer et relire.
Surface contrainte pour l’IA : une petite grammaire + du chaînage JSON réduisent les chemins de code « créatifs » et rendent la validation réaliste.
Politique de sûreté intégrée : délais d’expiration, plafonds de sortie, contrôles de bac à sable et listes d’autorisation sont appliqués par le runtime, pas par chaque script.
Toujours programmable : chaque étape peut appeler n’importe quelle CLI ou script. Si vous voulez du JS/TS, générez des fichiers .lobster depuis le code.

Fonctionnement

OpenClaw exécute les workflows Lobster dans le processus à l’aide d’un lanceur intégré. Aucun sous-processus CLI externe n’est lancé ; le moteur de workflow s’exécute dans le processus Gateway et renvoie directement une enveloppe JSON. Si le pipeline se met en pause pour validation, l’outil renvoie un resumeToken afin que vous puissiez continuer plus tard.

Modèle : petite CLI + tubes JSON + validations

Créez de petites commandes qui parlent JSON, puis enchaînez-les dans un seul appel Lobster. (Les noms de commandes ci-dessous sont des exemples - remplacez-les par les vôtres.)

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
}

Si le pipeline demande une validation, reprenez avec le token :

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

L’IA déclenche le workflow ; Lobster exécute les étapes. Les portes de validation gardent les effets de bord explicites et auditables.

Exemple : mapper des éléments d’entrée vers des appels d’outils :

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

Étapes LLM uniquement JSON (llm-task)

Pour les workflows qui ont besoin d’une étape LLM structurée, activez l’outil de Plugin facultatif llm-task et appelez-le depuis Lobster. Cela garde le workflow déterministe tout en vous permettant de classifier/résumer/rédiger avec un modèle.

Activez l’outil :

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

Limitation importante : Lobster intégré vs `openclaw.invoke`

Le Plugin Lobster fourni exécute les workflows dans le processus à l’intérieur du Gateway. Dans ce mode intégré, openclaw.invoke n’hérite pas automatiquement d’un contexte d’URL/authentification Gateway pour les appels d’outils CLI OpenClaw imbriqués.

Cela signifie que ce modèle n’est pas fiable actuellement dans le lanceur intégré :

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

Utilisez l’exemple ci-dessous uniquement lors de l’exécution de la CLI Lobster autonome dans un environnement où openclaw.invoke est déjà configuré avec le bon contexte Gateway/authentification.

Utilisez-le dans un pipeline CLI Lobster autonome :

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

Si vous utilisez aujourd’hui le Plugin Lobster intégré, préférez soit :

un appel direct à l’outil llm-task en dehors de Lobster, soit
des étapes non-openclaw.invoke dans le pipeline Lobster jusqu’à l’ajout d’un pont intégré pris en charge.

Consultez Tâche LLM pour les détails et les options de configuration.

Fichiers de workflow (.lobster)

Lobster peut exécuter des fichiers de workflow YAML/JSON avec les champs name, args, steps, env, condition et approval. Dans les appels d’outils OpenClaw, définissez pipeline sur le chemin du fichier.

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

Remarques :

stdin: $step.stdout et stdin: $step.json transmettent la sortie d’une étape précédente.
condition (ou when) peut conditionner des étapes à $step.approved.

Installer Lobster

Les workflows Lobster fournis s’exécutent dans le processus ; aucun binaire lobster distinct n’est requis. Le lanceur intégré est livré avec le Plugin Lobster.

Si vous avez besoin de la CLI Lobster autonome pour le développement ou des pipelines externes, installez-la depuis le dépôt Lobster et assurez-vous que lobster est dans PATH.

Activer l’outil

Lobster est un outil de Plugin facultatif (non activé par défaut).

Recommandé (additif, sûr) :

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

Ou par agent :

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

Évitez d’utiliser tools.allow: ["lobster"] sauf si vous avez l’intention d’exécuter en mode liste d’autorisation restrictive.

Exemple : triage des e-mails

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

Avec Lobster :

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

Renvoie une enveloppe JSON (tronquée) :

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

L’utilisateur valide → reprise :

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

Un seul workflow. Déterministe. Sûr.

Paramètres de l’outil

`run`

Exécuter un pipeline en mode outil.

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

Exécuter un fichier de workflow avec des arguments :

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

`resume`

Continuer un workflow interrompu après validation.

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

Entrées facultatives

cwd : répertoire de travail relatif pour le pipeline (doit rester dans le répertoire de travail du Gateway).
timeoutMs : interrompt le workflow s’il dépasse cette durée (par défaut : 20000).
maxStdoutBytes : interrompt le workflow si la sortie dépasse cette taille (par défaut : 512000).
argsJson : chaîne JSON transmise à lobster run --args-json (fichiers de workflow uniquement).

Enveloppe de sortie

Lobster renvoie une enveloppe JSON avec l’un des trois statuts suivants :

ok → terminé avec succès
needs_approval → en pause ; requiresApproval.resumeToken est requis pour reprendre
cancelled → explicitement refusé ou annulé

L’outil expose l’enveloppe à la fois dans content (JSON lisible) et details (objet brut).

Validations

Si requiresApproval est présent, inspectez l’invite et décidez :

approve: true → reprendre et poursuivre les effets de bord
approve: false → annuler et finaliser le workflow

Utilisez approve --preview-from-stdin --limit N pour joindre un aperçu JSON aux demandes de validation sans assemblage personnalisé jq/heredoc. Les tokens de reprise sont désormais compacts : Lobster stocke l’état de reprise du workflow dans son répertoire d’état et renvoie une petite clé de token.

OpenProse

OpenProse fonctionne bien avec Lobster : utilisez /prose pour orchestrer une préparation multi-agent, puis exécutez un pipeline Lobster pour des validations déterministes. Si un programme Prose a besoin de Lobster, autorisez l’outil lobster pour les sous-agents via tools.subagents.tools. Consultez OpenProse.

Sécurité

Local dans le processus uniquement - les workflows s’exécutent dans le processus Gateway ; aucun appel réseau depuis le Plugin lui-même.
Aucun secret - Lobster ne gère pas OAuth ; il appelle les outils OpenClaw qui le font.
Compatible avec le bac à sable - désactivé lorsque le contexte de l’outil est en bac à sable.
Renforcé - délais d’expiration et plafonds de sortie appliqués par le lanceur intégré.

Dépannage

lobster timed out → augmentez timeoutMs ou divisez un long pipeline.
lobster output exceeded maxStdoutBytes → augmentez maxStdoutBytes ou réduisez la taille de sortie.
lobster returned invalid JSON → assurez-vous que le pipeline s’exécute en mode outil et n’imprime que du JSON.
lobster failed → consultez les journaux du Gateway pour les détails de l’erreur du lanceur intégré.

En savoir plus

Étude de cas : workflows communautaires

Un exemple public : une CLI de « second cerveau » + des pipelines Lobster qui gèrent trois coffres Markdown (personnel, partenaire, partagé). La CLI émet du JSON pour les statistiques, les listes de boîte de réception et les analyses d’éléments obsolètes ; Lobster enchaîne ces commandes dans des workflows comme weekly-review, inbox-triage, memory-consolidation et shared-task-sync, chacun avec des portes de validation. L’IA prend en charge le jugement (catégorisation) lorsqu’elle est disponible et se rabat sur des règles déterministes lorsque ce n’est pas le cas.

Fil : https://x.com/plattenschieber/status/2014508656335770033
Dépôt : https://github.com/bloomedai/brain-cli

Connexe

Automatisation et tâches - planification de workflows Lobster
Présentation de l’automatisation - tous les mécanismes d’automatisation
Présentation des outils - tous les outils d’agent disponibles

# Hook

# Pourquoi

# Pourquoi un DSL plutôt que des programmes classiques ?

# Fonctionnement

# Modèle : petite CLI + tubes JSON + validations

# Étapes LLM uniquement JSON (llm-task)

# Limitation importante : Lobster intégré vs openclaw.invoke

# Fichiers de workflow (.lobster)

# Installer Lobster

# Activer l’outil

# Exemple : triage des e-mails

# Paramètres de l’outil

# run

# resume

# Entrées facultatives

# Enveloppe de sortie

# Validations

# OpenProse

# Sécurité

# Dépannage

# En savoir plus

# Étude de cas : workflows communautaires

# Connexe