Tarea de LLM

llm-task es una herramienta de plugin opcional que ejecuta una tarea de LLM solo JSON y devuelve salida estructurada (opcionalmente validada con JSON Schema).

Esto es ideal para motores de flujo de trabajo como Lobster: puedes agregar un único paso de LLM sin escribir código personalizado de OpenClaw para cada flujo de trabajo.

Habilitar el plugin

1. Habilita el plugin:

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

2. Permite la herramienta opcional:

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

Usa tools.allow solo cuando quieras el modo restrictivo de lista de permitidos.

Configuración (opcional)

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

allowedModels es una lista de permitidos de cadenas provider/model. Si se configura, se rechaza cualquier solicitud fuera de la lista.

Parámetros de la herramienta

• prompt (cadena, obligatorio)
• input (cualquiera, opcional)
• schema (objeto, JSON Schema opcional)
• provider (cadena, opcional)
• model (cadena, opcional)
• thinking (cadena, opcional)
• authProfileId (cadena, opcional)
• temperature (número, opcional)
• maxTokens (número, opcional)
• timeoutMs (número, opcional)

thinking acepta los ajustes preestablecidos estándar de razonamiento de OpenClaw, como low o medium.

Salida

Devuelve details.json con el JSON analizado (y lo valida con schema cuando se proporciona).

Ejemplo: paso de flujo de trabajo de Lobster

Limitación importante

El ejemplo siguiente asume que la CLI independiente de Lobster se ejecuta en un entorno donde openclaw.invoke ya tiene el contexto correcto de URL/autenticación del Gateway.

Para el ejecutor Lobster integrado incluido dentro de OpenClaw, este patrón de CLI anidada actualmente no es fiable:

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

Hasta que Lobster integrado tenga un puente compatible para este flujo, prefiere una de estas opciones:

• llamadas directas a la herramienta llm-task fuera de Lobster, o
• pasos de Lobster que no dependan de llamadas anidadas a openclaw.invoke.

Ejemplo de CLI independiente de Lobster:

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

Notas de seguridad

• La herramienta es solo JSON e indica al modelo que genere solo JSON (sin bloques de código, sin comentarios).
• No se exponen herramientas al modelo para esta ejecución.
• Trata la salida como no confiable a menos que la valides con schema.
• Coloca aprobaciones antes de cualquier paso con efectos secundarios (enviar, publicar, ejecutar).

Relacionado

• Niveles de razonamiento
• Subagentes
• Comandos de barra