LLM-taak

llm-task is een gebundelde optionele plugintool die één LLM-aanroep met uitsluitend JSON uitvoert en gestructureerde uitvoer retourneert, die optioneel wordt gevalideerd aan de hand van een JSON Schema. Hiermee krijgen workflow-engines zoals Lobster een LLM-stap zonder aangepaste OpenClaw-code per workflow.

Inschakelen

Schakel de plugin in:

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

Sta de tool toe:

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

alsoAllow voegt llm-task toe boven op het actieve toolprofiel zonder andere kerntools te beperken. Gebruik in plaats daarvan alleen tools.allow als je een beperkende toestaanlijstmodus wilt.

Configuratie (optioneel)

{
  "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 is een toestaanlijst van provider/model-tekenreeksen; een aanvraag voor elk ander model wordt geweigerd. Alle andere sleutels zijn terugvalwaarden per aanroep die worden gebruikt wanneer de toolaanroep die parameter weglaat.

Toolparameters

Parameter	Type	Opmerkingen
`prompt`	string	Vereist. Taakinstructie voor het LLM.
`input`	any	Optionele payload; wordt naar JSON geserialiseerd en aan de prompt toegevoegd.
`schema`	object	Optioneel JSON Schema waaraan de geparseerde uitvoer moet voldoen.
`provider`	string	Overschrijft `defaultProvider` / de standaardprovider van de agent.
`model`	string	Overschrijft `defaultModel`; accepteert kale model-id’s, aliassen of een `provider/model`-verwijzing (een dubbel providervoorvoegsel wordt automatisch verwijderd).
`thinking`	string	Redeneerniveau (bijv. `low`, `medium`); moet door het gevonden model worden ondersteund.
`authProfileId`	string	Overschrijft `defaultAuthProfileId`.
`temperature`	number	Naar beste vermogen; niet alle providers respecteren dit.
`maxTokens`	number	Limiet naar beste vermogen voor uitvoertokens.
`timeoutMs`	number	Time-out voor uitvoering; standaard `30000`.

Uitvoer

Retourneert details.json (de geparseerde, aan het schema getoetste JSON) plus details.provider en details.model, die aangeven wat daadwerkelijk is uitgevoerd.

Voorbeeld: Lobster-workflowstap

Belangrijke beperking

In het onderstaande voorbeeld wordt ervan uitgegaan dat de zelfstandige Lobster CLI wordt uitgevoerd waar openclaw.invoke al de juiste Gateway-URL/authenticatiecontext heeft. Voor de gebundelde ingebedde Lobster-runner in OpenClaw is dit geneste CLI- patroon momenteel niet betrouwbaar:

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

Totdat ingebedde Lobster een ondersteunde brug voor deze flow heeft, geef je de voorkeur aan:

rechtstreekse llm-task-toolaanroepen buiten Lobster, of
Lobster-stappen die niet afhankelijk zijn van geneste openclaw.invoke-aanroepen.

Voorbeeld voor de zelfstandige Lobster CLI:

openclaw.invoke --tool llm-task --action json --args-json '{
  "prompt": "Geef op basis van de ingevoerde e-mail de intentie en een concept terug.",
  "thinking": "low",
  "input": {
    "subject": "Hallo",
    "body": "Kun je helpen?"
  },
  "schema": {
    "type": "object",
    "properties": {
      "intent": { "type": "string" },
      "draft": { "type": "string" }
    },
    "required": ["intent", "draft"],
    "additionalProperties": false
  }
}'

Veiligheidsopmerkingen

Alleen JSON: het model krijgt de instructie om uitsluitend een JSON-waarde te retourneren, zonder code- fences en zonder commentaar.
Geen tools: voor de onderliggende uitvoering zijn tools uitgeschakeld, zodat het model tijdens de taak geen externe aanroepen kan doen.
Behandel de uitvoer als niet-vertrouwd, tenzij je deze valideert met schema.
Plaats goedkeuringen vóór elke stap met neveneffecten (verzenden, plaatsen, uitvoeren) die deze uitvoer gebruikt.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Inschakelen

Configuratie (optioneel)

Toolparameters

Uitvoer

Voorbeeld: Lobster-workflowstap

Belangrijke beperking

Veiligheidsopmerkingen

Gerelateerd

​Inschakelen

​Configuratie (optioneel)

​Toolparameters

​Uitvoer

​Voorbeeld: Lobster-workflowstap

​Belangrijke beperking

​Veiligheidsopmerkingen

​Gerelateerd

Inschakelen

Configuratie (optioneel)

Toolparameters

Uitvoer

Voorbeeld: Lobster-workflowstap

Belangrijke beperking

Veiligheidsopmerkingen

Gerelateerd