Tools
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-tasken 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.
