Tools
LLM कार्य
llm-task एक बंडल किया गया वैकल्पिक Plugin टूल है, जो केवल JSON वाला एक
LLM कॉल चलाता है और संरचित आउटपुट लौटाता है, जिसे वैकल्पिक रूप से JSON
Schema के विरुद्ध सत्यापित किया जाता है। यह Lobster जैसे वर्कफ़्लो इंजनों को प्रत्येक वर्कफ़्लो के लिए कस्टम
OpenClaw कोड के बिना एक LLM चरण प्रदान करता है।
सक्षम करें
- Plugin सक्षम करें:
{ "plugins": { "entries": { "llm-task": { "enabled": true } } }}- टूल की अनुमति दें:
{ "tools": { "alsoAllow": ["llm-task"] }}alsoAllow अन्य मुख्य टूल को प्रतिबंधित किए बिना सक्रिय टूल प्रोफ़ाइल में
llm-task जोड़ता है। इसके बजाय tools.allow का उपयोग केवल तभी करें, जब आपको प्रतिबंधात्मक
अनुमति-सूची मोड चाहिए।
कॉन्फ़िगरेशन (वैकल्पिक)
{ "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, provider/model स्ट्रिंग की अनुमति-सूची है; किसी भी
अन्य मॉडल का अनुरोध अस्वीकार कर दिया जाता है। अन्य सभी कुंजियाँ प्रत्येक कॉल के लिए फ़ॉलबैक हैं, जिनका उपयोग तब किया जाता है जब
टूल कॉल उस पैरामीटर को छोड़ देता है।
टूल पैरामीटर
| पैरामीटर | प्रकार | टिप्पणियाँ |
|---|---|---|
prompt |
string | आवश्यक। LLM के लिए कार्य निर्देश। |
input |
any | वैकल्पिक पेलोड; JSON में क्रमबद्ध करके प्रॉम्प्ट के अंत में जोड़ा जाता है। |
schema |
object | वैकल्पिक JSON Schema, जिसके विरुद्ध पार्स किए गए आउटपुट का सत्यापन होना आवश्यक है। |
provider |
string | defaultProvider / एजेंट के डिफ़ॉल्ट प्रदाता को ओवरराइड करता है। |
model |
string | defaultModel को ओवरराइड करता है; साधारण मॉडल आईडी, उपनाम या provider/model संदर्भ स्वीकार करता है (दोहराया गया प्रदाता उपसर्ग स्वचालित रूप से हटा दिया जाता है)। |
thinking |
string | रीजनिंग स्तर (जैसे low, medium); समाधान किए गए मॉडल द्वारा समर्थित स्तरों में से एक होना आवश्यक है। |
authProfileId |
string | defaultAuthProfileId को ओवरराइड करता है। |
temperature |
number | यथासंभव लागू किया जाता है; सभी प्रदाता इसका पालन नहीं करते। |
maxTokens |
number | आउटपुट टोकन की यथासंभव लागू की जाने वाली सीमा। |
timeoutMs |
number | रन की समय-सीमा; डिफ़ॉल्ट 30000। |
आउटपुट
details.json (पार्स किया गया, स्कीमा-सत्यापित JSON), साथ ही वास्तव में क्या चला यह बताने वाले
details.provider और details.model लौटाता है।
उदाहरण: Lobster वर्कफ़्लो चरण
महत्वपूर्ण सीमा
नीचे दिया गया उदाहरण मानता है कि स्टैंडअलोन Lobster CLI वहाँ चल रहा है, जहाँ
openclaw.invoke में पहले से सही Gateway URL/प्रमाणीकरण संदर्भ मौजूद है।
OpenClaw के भीतर बंडल किए गए एम्बेडेड Lobster रनर के लिए, यह नेस्टेड CLI पैटर्न वर्तमान में विश्वसनीय नहीं है:
openclaw.invoke --tool llm-task --action json --args-json '{ ... }'जब तक एम्बेडेड Lobster में इस प्रवाह के लिए समर्थित ब्रिज उपलब्ध नहीं होता, इनमें से किसी एक को प्राथमिकता दें:
- Lobster के बाहर सीधे
llm-taskटूल कॉल, या - ऐसे Lobster चरण जो नेस्टेड
openclaw.invokeकॉल पर निर्भर न हों।
स्टैंडअलोन Lobster CLI उदाहरण:
openclaw.invoke --tool llm-task --action json --args-json '{ "prompt": "इनपुट ईमेल के आधार पर आशय और मसौदा लौटाएँ।", "thinking": "low", "input": { "subject": "नमस्ते", "body": "क्या आप सहायता कर सकते हैं?" }, "schema": { "type": "object", "properties": { "intent": { "type": "string" }, "draft": { "type": "string" } }, "required": ["intent", "draft"], "additionalProperties": false }}'सुरक्षा संबंधी टिप्पणियाँ
- केवल JSON: मॉडल को केवल JSON मान लौटाने का निर्देश दिया जाता है, कोई कोड फ़ेंस या टिप्पणी नहीं।
- कोई टूल नहीं: अंतर्निहित रन में टूल अक्षम होते हैं, इसलिए मॉडल कार्य के बीच कोई कॉल नहीं कर सकता।
- आउटपुट को तब तक अविश्वसनीय मानें, जब तक आप
schemaके साथ उसका सत्यापन न कर लें। - इस आउटपुट का उपयोग करने वाले किसी भी दुष्प्रभाव उत्पन्न करने वाले चरण (भेजना, पोस्ट करना, निष्पादित करना) से पहले अनुमोदन रखें।
