Attività LLM

llm-task è uno strumento Plugin opzionale incluso che esegue una singola chiamata LLM esclusivamente JSON e restituisce un output strutturato, facoltativamente convalidato rispetto a uno schema JSON. Fornisce ai motori di workflow come Lobster un passaggio LLM senza richiedere codice OpenClaw personalizzato per ogni workflow.

Abilitazione

1. Abilita il Plugin:

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

2. Consenti lo strumento:

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

alsoAllow aggiunge llm-task al profilo degli strumenti attivo senza limitare gli altri strumenti principali. Usa invece tools.allow solo se desideri una modalità restrittiva basata su un elenco di elementi consentiti.

Configurazione (facoltativa)

{  "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 è un elenco di stringhe provider/model consentite; una richiesta per qualsiasi altro modello viene rifiutata. Tutte le altre chiavi sono valori di ripiego per chiamata, usati quando la chiamata allo strumento omette il relativo parametro.

Parametri dello strumento

Output

Restituisce details.json (il JSON analizzato e convalidato rispetto allo schema), oltre a details.provider e details.model, che indicano rispettivamente il provider e il modello effettivamente utilizzati.

Esempio: passaggio di un workflow Lobster

Limitazione importante

L'esempio seguente presuppone che la CLI Lobster autonoma sia in esecuzione in un ambiente in cui openclaw.invoke dispone già del corretto contesto dell'URL e dell'autenticazione del Gateway.

Per l'esecutore Lobster incorporato incluso in OpenClaw, questo schema di CLI nidificata non è attualmente affidabile:

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

Finché Lobster incorporato non disporrà di un bridge supportato per questo flusso, preferisci una delle seguenti opzioni:

• chiamate dirette allo strumento llm-task al di fuori di Lobster; oppure
• passaggi Lobster che non dipendano da chiamate openclaw.invoke nidificate.

Esempio con la CLI Lobster autonoma:

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

Note sulla sicurezza

• Solo JSON: al modello viene richiesto di restituire esclusivamente un valore JSON, senza blocchi di codice né commenti.
• Nessuno strumento: l'esecuzione sottostante ha gli strumenti disabilitati, quindi il modello non può effettuare chiamate esterne durante l'attività.
• Considera l'output non attendibile, a meno che non venga convalidato con schema.
• Inserisci le approvazioni prima di qualsiasi passaggio con effetti collaterali (invio, pubblicazione, esecuzione) che utilizzi questo output.

Contenuti correlati

• Livelli di ragionamento
• Sottoagenti
• Comandi slash