Tools
LLM-Aufgabe
llm-task ist ein gebündeltes optionales Plugin-Tool, das einen einzelnen reinen JSON-
LLM-Aufruf ausführt und eine strukturierte Ausgabe zurückgibt, die optional anhand eines JSON-
Schemas validiert wird. Es stellt Workflow-Engines wie Lobster einen LLM-Schritt bereit, ohne dass
für jeden Workflow eigener OpenClaw-Code erforderlich ist.
Aktivieren
- Aktivieren Sie das Plugin:
{ "plugins": { "entries": { "llm-task": { "enabled": true } } }}- Lassen Sie das Tool zu:
{ "tools": { "alsoAllow": ["llm-task"] }}alsoAllow fügt llm-task zusätzlich zum aktiven Tool-Profil hinzu, ohne
andere Kern-Tools einzuschränken. Verwenden Sie stattdessen tools.allow nur, wenn Sie einen
restriktiven Zulassungslistenmodus wünschen.
Konfiguration (optional)
{ "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 ist eine Zulassungsliste von provider/model-Zeichenfolgen; eine Anfrage für ein
anderes Modell wird abgelehnt. Alle anderen Schlüssel sind Rückfallwerte pro Aufruf, die verwendet
werden, wenn der Tool-Aufruf den jeweiligen Parameter auslässt.
Tool-Parameter
| Parameter | Typ | Hinweise |
|---|---|---|
prompt |
string | Erforderlich. Aufgabenanweisung für das LLM. |
input |
any | Optionale Nutzlast; wird als JSON serialisiert und an den Prompt angehängt. |
schema |
object | Optionales JSON-Schema, anhand dessen die geparste Ausgabe validiert werden muss. |
provider |
string | Überschreibt defaultProvider / den Standard-Provider des Agenten. |
model |
string | Überschreibt defaultModel; akzeptiert reine Modell-IDs, Aliasse oder eine provider/model-Referenz (ein doppeltes Provider-Präfix wird automatisch entfernt). |
thinking |
string | Reasoning-Stufe (z. B. low, medium); muss vom aufgelösten Modell unterstützt werden. |
authProfileId |
string | Überschreibt defaultAuthProfileId. |
temperature |
number | Bestmögliche Umsetzung; nicht alle Provider berücksichtigen den Wert. |
maxTokens |
number | Bestmögliche Obergrenze für Ausgabetoken. |
timeoutMs |
number | Zeitlimit für die Ausführung; Standardwert 30000. |
Ausgabe
Gibt details.json (das geparste, anhand des Schemas validierte JSON) sowie details.provider
und details.model zurück, die angeben, was tatsächlich ausgeführt wurde.
Beispiel: Lobster-Workflow-Schritt
Wichtige Einschränkung
Das folgende Beispiel setzt voraus, dass die eigenständige Lobster-CLI dort ausgeführt wird, wo
openclaw.invoke bereits über den korrekten Gateway-URL-/Authentifizierungskontext verfügt.
Für den gebündelten eingebetteten Lobster-Runner innerhalb von OpenClaw ist dieses verschachtelte CLI- Muster derzeit nicht zuverlässig:
openclaw.invoke --tool llm-task --action json --args-json '{ ... }'Bis eingebettetes Lobster eine unterstützte Brücke für diesen Ablauf bietet, verwenden Sie vorzugsweise entweder:
- direkte Aufrufe des Tools
llm-taskaußerhalb von Lobster oder - Lobster-Schritte, die nicht auf verschachtelten
openclaw.invoke-Aufrufen beruhen.
Beispiel für die eigenständige Lobster-CLI:
openclaw.invoke --tool llm-task --action json --args-json '{ "prompt": "Gib anhand der eingegebenen E-Mail die Absicht und einen Entwurf zurück.", "thinking": "low", "input": { "subject": "Hallo", "body": "Können Sie helfen?" }, "schema": { "type": "object", "properties": { "intent": { "type": "string" }, "draft": { "type": "string" } }, "required": ["intent", "draft"], "additionalProperties": false }}'Sicherheitshinweise
- Nur JSON: Das Modell wird angewiesen, ausschließlich einen JSON-Wert zurückzugeben, ohne Code- Blöcke und ohne Kommentare.
- Keine Tools: Für die zugrunde liegende Ausführung sind Tools deaktiviert, sodass das Modell während der Aufgabe keine externen Aufrufe tätigen kann.
- Behandeln Sie die Ausgabe als nicht vertrauenswürdig, sofern Sie sie nicht mit
schemavalidieren. - Fügen Sie vor jedem Schritt mit Nebenwirkungen (Senden, Veröffentlichen, Ausführen), der diese Ausgabe verwendet, eine Genehmigung ein.