Tarea del LLM

llm-task es una herramienta de plugin opcional incluida que ejecuta una única llamada a un LLM solo con JSON y devuelve una salida estructurada, validada opcionalmente con un esquema JSON. Proporciona a motores de flujo de trabajo como Lobster un paso de LLM sin código personalizado de OpenClaw para cada flujo de trabajo.

Habilitar

Habilite el plugin:

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

Permita la herramienta:

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

alsoAllow añade llm-task al perfil de herramientas activo sin restringir otras herramientas principales. Utilice tools.allow en su lugar solo si desea un modo de lista de permitidos restrictivo.

Configuración (opcional)

{
  "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 es una lista de permitidos de cadenas provider/model; se rechazan las solicitudes de cualquier otro modelo. Todas las demás claves son valores alternativos por llamada que se utilizan cuando la llamada a la herramienta omite ese parámetro.

Parámetros de la herramienta

Parámetro	Tipo	Notas
`prompt`	cadena	Obligatorio. Instrucción de la tarea para el LLM.
`input`	cualquiera	Carga útil opcional; se serializa a JSON y se añade al prompt.
`schema`	objeto	Esquema JSON opcional con el que debe validarse la salida analizada.
`provider`	cadena	Sobrescribe `defaultProvider` / el proveedor predeterminado del agente.
`model`	cadena	Sobrescribe `defaultModel`; acepta identificadores de modelo simples, alias o una referencia `provider/model` (los prefijos de proveedor duplicados se eliminan automáticamente).
`thinking`	cadena	Nivel de razonamiento (p. ej., `low`, `medium`); debe ser uno de los admitidos por el modelo resuelto.
`authProfileId`	cadena	Sobrescribe `defaultAuthProfileId`.
`temperature`	número	Se aplica en la medida de lo posible; no todos los proveedores lo respetan.
`maxTokens`	número	Límite máximo orientativo de tokens de salida.
`timeoutMs`	número	Tiempo de espera de la ejecución; valor predeterminado: `30000`.

Salida

Devuelve details.json (el JSON analizado y validado con el esquema), además de details.provider y details.model, que indican lo que se ejecutó realmente.

Ejemplo: paso de un flujo de trabajo de Lobster

Limitación importante

El ejemplo siguiente presupone que la CLI independiente de Lobster se ejecuta donde openclaw.invoke ya tiene el contexto correcto de URL/autenticación del Gateway. Para el ejecutor de Lobster integrado incluido en OpenClaw, este patrón de CLI anidada no es fiable actualmente:

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

Hasta que Lobster integrado disponga de un puente compatible con este flujo, se recomienda usar:

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 la CLI independiente de Lobster:

openclaw.invoke --tool llm-task --action json --args-json '{
  "prompt": "A partir del correo electrónico de entrada, devuelve la intención y un borrador.",
  "thinking": "low",
  "input": {
    "subject": "Hola",
    "body": "¿Puedes ayudarme?"
  },
  "schema": {
    "type": "object",
    "properties": {
      "intent": { "type": "string" },
      "draft": { "type": "string" }
    },
    "required": ["intent", "draft"],
    "additionalProperties": false
  }
}'

Notas de seguridad

Solo JSON: se indica al modelo que devuelva únicamente un valor JSON, sin bloques de código ni comentarios.
Sin herramientas: la ejecución subyacente tiene las herramientas deshabilitadas, por lo que el modelo no puede realizar llamadas externas durante la tarea.
Trate la salida como no fiable a menos que la valide con schema.
Exija aprobaciones antes de cualquier paso con efectos secundarios (enviar, publicar, ejecutar) que consuma esta salida.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Habilitar

Configuración (opcional)

Parámetros de la herramienta

Salida

Ejemplo: paso de un flujo de trabajo de Lobster

Limitación importante

Notas de seguridad

Relacionado

​Habilitar

​Configuración (opcional)

​Parámetros de la herramienta

​Salida

​Ejemplo: paso de un flujo de trabajo de Lobster

​Limitación importante

​Notas de seguridad

​Relacionado

Habilitar

Configuración (opcional)

Parámetros de la herramienta

Salida

Ejemplo: paso de un flujo de trabajo de Lobster

Limitación importante

Notas de seguridad

Relacionado