Tools
LLM-Aufgabe
llm-task ist ein gebündeltes optionales Plugin-Tool, das einen einzelnen reinen JSON-
LLM-Aufruf ausführt und strukturierte Ausgaben zurückgibt, die optional anhand eines JSON-
Schemas validiert werden. 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 } } }}- Erlauben Sie das Tool:
{ "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
Allowlist-Modus 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 Allowlist aus provider/model-Zeichenfolgen; eine Anfrage für ein
anderes Modell wird abgelehnt. Alle anderen Schlüssel dienen als aufrufspezifische Fallbacks, wenn beim
Tool-Aufruf der jeweilige Parameter fehlt.
Tool-Parameter
| Parameter | Typ | Hinweise |
|---|---|---|
prompt |
string | Erforderlich. Aufgabenanweisung für das LLM. |
input |
any | Optionale Nutzdaten; werden 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 bzw. den Standard-Provider des Agenten. |
model |
string | Überschreibt defaultModel; akzeptiert reine Modell-IDs, Aliase 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 | Nach bestem Bemühen; nicht alle Provider berücksichtigen diesen Wert. |
maxTokens |
number | Obergrenze für Ausgabe-Token nach bestem Bemühen. |
timeoutMs |
number | Zeitüberschreitung 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 in einer Umgebung ausgeführt wird,
in der openclaw.invoke bereits über den richtigen 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 über eine unterstützte Brücke für diesen Ablauf verfügt, verwenden Sie vorzugsweise entweder:
- direkte Aufrufe des Tools
llm-taskaußerhalb von Lobster oder - Lobster-Schritte, die nicht auf verschachtelten Aufrufen von
openclaw.invokebasieren.
Beispiel für die eigenständige Lobster-CLI:
openclaw.invoke --tool llm-task --action json --args-json '{ "prompt": "Ermitteln Sie anhand der eingegebenen E-Mail die Absicht und geben Sie 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: Bei der zugrunde liegenden Ausführung sind Tools deaktiviert, sodass das Modell während der Aufgabe keine externen Aufrufe durchführen kann.
- Behandeln Sie die Ausgabe als nicht vertrauenswürdig, sofern Sie sie nicht mit
schemavalidieren. - Platzieren Sie Genehmigungen vor jedem Schritt mit Seiteneffekten (Senden, Veröffentlichen, Ausführen), der diese Ausgabe verwendet.