Tâche du LLM

llm-task est un outil de Plugin facultatif intégré qui exécute un unique appel LLM produisant exclusivement du JSON et renvoie une sortie structurée, éventuellement validée par rapport à un schéma JSON. Il fournit aux moteurs de workflow comme Lobster une étape LLM sans nécessiter de code OpenClaw personnalisé pour chaque workflow.

Activation

Activez le Plugin :

{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  }
}

Autorisez l’outil :

{
  "tools": {
    "alsoAllow": ["llm-task"]
  }
}

alsoAllow ajoute llm-task au profil d’outils actif sans restreindre les autres outils principaux. Utilisez plutôt tools.allow uniquement si vous souhaitez un mode restrictif fondé sur une liste d’autorisation.

Configuration (facultative)

{
  "plugins": {
    "entries": {
      "llm-task": {
        "enabled": true,
        "config": {
          "defaultProvider": "openai",
          "defaultModel": "gpt-5.6-sol",
          "defaultAuthProfileId": "main",
          "allowedModels": ["openai/gpt-5.6-sol"],
          "maxTokens": 800,
          "timeoutMs": 30000
        }
      }
    }
  }
}

allowedModels est une liste d’autorisation de chaînes provider/model ; toute requête visant un autre modèle est rejetée. Toutes les autres clés servent de valeurs de repli par appel lorsque l’appel d’outil omet le paramètre correspondant.

Paramètres de l’outil

Paramètre	Type	Remarques
`prompt`	string	Obligatoire. Instruction de tâche destinée au LLM.
`input`	any	Charge utile facultative ; sérialisée en JSON et ajoutée au prompt.
`schema`	object	Schéma JSON facultatif par rapport auquel la sortie analysée doit être validée.
`provider`	string	Remplace `defaultProvider` / le fournisseur par défaut de l’agent.
`model`	string	Remplace `defaultModel` ; accepte les identifiants de modèle seuls, les alias ou une référence `provider/model` (un préfixe de fournisseur dupliqué est automatiquement supprimé).
`thinking`	string	Niveau de raisonnement (par ex. `low`, `medium`) ; doit être pris en charge par le modèle résolu.
`authProfileId`	string	Remplace `defaultAuthProfileId`.
`temperature`	number	Appliqué dans la mesure du possible ; tous les fournisseurs ne le prennent pas en charge.
`maxTokens`	number	Limite indicative du nombre de jetons de sortie.
`timeoutMs`	number	Délai d’expiration de l’exécution ; valeur par défaut : `30000`.

Sortie

Renvoie details.json (le JSON analysé et validé par rapport au schéma), ainsi que details.provider et details.model, qui indiquent respectivement le fournisseur et le modèle effectivement utilisés.

Exemple : étape d’un workflow Lobster

Limitation importante

L’exemple ci-dessous suppose que la CLI Lobster autonome s’exécute dans un environnement où openclaw.invoke dispose déjà de l’URL du Gateway et du contexte d’authentification appropriés. Pour l’exécuteur Lobster intégré fourni avec OpenClaw, ce modèle d’appel imbriqué de la CLI n’est pas fiable actuellement :

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

Tant que Lobster intégré ne dispose pas d’une passerelle prise en charge pour ce flux, privilégiez l’une des options suivantes :

des appels directs à l’outil llm-task en dehors de Lobster, ou
des étapes Lobster qui ne reposent pas sur des appels imbriqués à openclaw.invoke.

Exemple avec la 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
  }
}'

Remarques de sécurité

JSON uniquement : le modèle reçoit l’instruction de renvoyer uniquement une valeur JSON, sans bloc de code ni commentaire.
Aucun outil : les outils sont désactivés pour l’exécution sous-jacente ; le modèle ne peut donc pas effectuer d’appel externe pendant la tâche.
Considérez la sortie comme non fiable, sauf si vous la validez avec schema.
Placez les demandes d’approbation avant toute étape produisant des effets de bord (envoi, publication, exécution) qui consomme cette sortie.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Activation

Configuration (facultative)

Paramètres de l’outil

Sortie

Exemple : étape d’un workflow Lobster

Limitation importante

Remarques de sécurité

Voir aussi

​Activation

​Configuration (facultative)

​Paramètres de l’outil

​Sortie

​Exemple : étape d’un workflow Lobster

​Limitation importante

​Remarques de sécurité

​Voir aussi

Activation

Configuration (facultative)

Paramètres de l’outil

Sortie

Exemple : étape d’un workflow Lobster

Limitation importante

Remarques de sécurité

Voir aussi