openclaw infer प्रदाता-समर्थित अनुमान के लिए मानक हेडलेस सतह है। यह कच्चे Gateway RPC नाम या एजेंट टूल आईडी नहीं, बल्कि क्षमता परिवार (model, image, audio, tts, video, web, embedding) उजागर करता है। openclaw capability ... उसी कमांड ट्री का उपनाम है।
एकबारगी प्रदाता रैपर की तुलना में इसे प्राथमिकता देने के कारण:
- OpenClaw में पहले से कॉन्फ़िगर किए गए प्रदाताओं और मॉडलों का पुनः उपयोग करता है।
- स्क्रिप्ट और एजेंट-संचालित स्वचालन के लिए स्थिर
--jsonएनवेलप (JSON आउटपुट देखें)। - अधिकांश उपकमांड के लिए Gateway के बिना सामान्य स्थानीय पथ चलाता है।
- एंड-टू-एंड प्रदाता जाँचों के लिए, प्रदाता अनुरोध भेजे जाने से पहले यह शिप की गई CLI, कॉन्फ़िगरेशन लोडिंग, डिफ़ॉल्ट-एजेंट समाधान, बंडल किए गए Plugin सक्रियण और साझा क्षमता रनटाइम का प्रयोग करता है।
infer को कौशल में बदलें
इसे कॉपी करके किसी एजेंट में पेस्ट करें:openclaw infer ... को प्राथमिकता देता है और कौशल के मुख्य भाग में संपूर्ण infer सतह का दोबारा दस्तावेज़ीकरण नहीं करता।
कमांड ट्री
infer list / infer inspect --name <capability> इस ट्री को डेटा के रूप में दिखाते हैं (क्षमता आईडी, ट्रांसपोर्ट, विवरण)।
सामान्य कार्य
व्यवहार
- जब आउटपुट किसी अन्य कमांड या स्क्रिप्ट में जाता हो, तो
--jsonका उपयोग करें; अन्यथा टेक्स्ट आउटपुट का उपयोग करें। - किसी विशिष्ट बैकएंड को पिन करने के लिए
--providerया--model provider/modelका उपयोग करें। - एकबारगी चिंतन/तर्क ओवरराइड के लिए
model run --thinking <level>का उपयोग करें:off,minimal,low,medium,high,adaptive,xhigh, याmax। image describe,audio transcribeऔरvideo describeके लिए,--modelको<provider/model>प्रारूप का उपयोग करना चाहिए।image describeके लिए,--fileस्थानीय पथ और HTTP(S) URL स्वीकार करता है; रिमोट URL सामान्य मीडिया-फ़ेच SSRF नीति से गुजरते हैं।- स्टेटलेस निष्पादन कमांड (
model run,image *,audio *,video *,web *,embedding *) डिफ़ॉल्ट रूप से स्थानीय होते हैं। Gateway-प्रबंधित स्टेट कमांड (tts status) डिफ़ॉल्ट रूप से Gateway का उपयोग करते हैं। - स्थानीय पथ के लिए Gateway का चलना कभी आवश्यक नहीं होता।
- स्थानीय
model runएक हल्का एकबारगी प्रदाता पूर्णता है: यह कॉन्फ़िगर किए गए एजेंट मॉडल और प्रमाणीकरण का समाधान करता है, लेकिन चैट-एजेंट टर्न शुरू नहीं करता, टूल लोड नहीं करता और बंडल किए गए MCP सर्वर नहीं खोलता। model run --fileप्रॉम्प्ट के साथ इमेज फ़ाइलें (स्वतः पहचाना गया MIME प्रकार) संलग्न करता है; एकाधिक इमेज के लिए--fileदोहराएँ। गैर-इमेज फ़ाइलें अस्वीकार कर दी जाती हैं — इसके बजायinfer audio transcribeयाinfer video describeका उपयोग करें।model run --gatewayGateway रूटिंग, सहेजे गए प्रमाणीकरण, प्रदाता चयन और एम्बेडेड रनटाइम का प्रयोग करता है, लेकिन कच्चा मॉडल प्रोब बना रहता है: कोई पिछला सत्र ट्रांसक्रिप्ट, बूटस्ट्रैप/AGENTS संदर्भ, टूल या बंडल किए गए MCP सर्वर नहीं।model run --gateway --model <provider/model>के लिए विश्वसनीय-ऑपरेटर Gateway क्रेडेंशियल आवश्यक है, क्योंकि यह Gateway से एकबारगी प्रदाता/मॉडल ओवरराइड चलाने को कहता है।
मॉडल
टेक्स्ट अनुमान और मॉडल/प्रदाता निरीक्षण।--local के साथ पूर्ण <provider/model> संदर्भों का उपयोग करें:
- स्थानीय
model runप्रदाता/मॉडल/प्रमाणीकरण की स्थिति के लिए सबसे संकीर्ण CLI स्मोक है: गैर-ChatGPT-Codex प्रदाताओं के लिए यह केवल दिया गया प्रॉम्प्ट भेजता है। - स्थानीय
model run --model <provider/model>उस प्रदाता को कॉन्फ़िगरेशन में लिखे जाने से पहले सटीक बंडल की गई स्थिर-कैटलॉग पंक्तियों (वही पंक्तियाँ जिन्हेंopenclaw models list --allदिखाता है) का समाधान कर सकता है। प्रदाता प्रमाणीकरण अभी भी आवश्यक है; अनुपलब्ध क्रेडेंशियलUnknown modelके रूप में नहीं, बल्कि प्रमाणीकरण त्रुटियों के रूप में विफल होते हैं। - Mistral Medium 3.5 तर्क प्रोब के लिए तापमान को अनसेट/डिफ़ॉल्ट छोड़ें। Mistral
reasoning_effort="high"कोtemperature: 0के साथ अस्वीकार करता है; डिफ़ॉल्ट तापमान या0.7जैसे गैर-शून्य मान का उपयोग करें। - OpenAI ChatGPT/Codex OAuth (
openai-chatgpt-responsesAPI) स्थानीय प्रोब एक न्यूनतम सिस्टम निर्देश जोड़ते हैं, ताकि ट्रांसपोर्ट अपने आवश्यकinstructionsफ़ील्ड को भर सके — कोई पूर्ण एजेंट संदर्भ, टूल, मेमोरी या सत्र ट्रांसक्रिप्ट नहीं। model run --fileइमेज सामग्री को सीधे एकल उपयोगकर्ता संदेश से संलग्न करता है। सामान्य प्रारूप (PNG, JPEG, WebP) तब काम करते हैं जब MIME प्रकार कोimage/*के रूप में पहचाना जाता है; असमर्थित या अपरिचित फ़ाइलें प्रदाता को कॉल किए जाने से पहले विफल हो जाती हैं। जब आप प्रत्यक्ष मल्टीमॉडल-मॉडल प्रोब के बजाय OpenClaw की इमेज-मॉडल रूटिंग और फ़ॉलबैक चाहते हों, तो इसके बजायinfer image describeका उपयोग करें।- चयनित मॉडल को इमेज इनपुट का समर्थन करना चाहिए; केवल-टेक्स्ट मॉडल प्रदाता स्तर पर अनुरोध अस्वीकार कर सकते हैं।
model run --promptमें गैर-व्हाइटस्पेस टेक्स्ट होना चाहिए; खाली प्रॉम्प्ट किसी भी प्रदाता या Gateway कॉल से पहले अस्वीकार कर दिए जाते हैं।- जब प्रदाता कोई टेक्स्ट आउटपुट नहीं लौटाता, तो स्थानीय
model runगैर-शून्य स्थिति के साथ बाहर निकलता है, ताकि अगम्य प्रदाता और खाली पूर्णताएँ सफल प्रोब जैसी न दिखें। - मॉडल इनपुट को कच्चा रखते हुए Gateway रूटिंग या एजेंट-रनटाइम सेटअप का परीक्षण करने के लिए
model run --gatewayका उपयोग करें। पूर्ण एजेंट संदर्भ, टूल, मेमोरी और सत्र ट्रांसक्रिप्ट के लिएopenclaw agentया किसी चैट सतह का उपयोग करें। --thinking adaptiveपूर्णता-रनटाइम स्तर केmediumसे मैप होता है; मूल अधिकतम प्रयास का समर्थन करने वाले OpenAI मॉडलों के लिए--thinking max,maxसे मैप होता है, अन्यथाxhighसे।model auth login,model auth logoutऔरmodel auth statusसहेजी गई प्रदाता प्रमाणीकरण स्थिति प्रबंधित करते हैं।
इमेज
जनरेशन, संपादन और वर्णन।-
मौजूदा इनपुट फ़ाइलों से शुरू करते समय
image editका उपयोग करें;--size,--aspect-ratio, या--resolutionउन प्रदाताओं/मॉडलों पर ज्यामिति संकेत जोड़ते हैं जो उनका समर्थन करते हैं। -
--output-format png --background transparentके साथ--model openai/gpt-image-1.5पारदर्शी-पृष्ठभूमि वाला OpenAI PNG आउटपुट देता है;--openai-backgroundउसी संकेत के लिए OpenAI-विशिष्ट उपनाम है। जो प्रदाता पृष्ठभूमि समर्थन घोषित नहीं करते, वे इसे उपेक्षित ओवरराइड के रूप में रिपोर्ट करते हैं (JSON आवरण मेंignoredOverridesदेखें)। -
--quality low|medium|high|autoउन प्रदाताओं के लिए काम करता है जो छवि-गुणवत्ता संकेतों का समर्थन करते हैं, जिनमें OpenAI शामिल है। OpenAI--openai-moderation low|autoको भी स्वीकार करता है। -
image providers --jsonसूचीबद्ध करता है कि कौन-से बंडल किए गए छवि प्रदाता खोजे जा सकते हैं, कॉन्फ़िगर और चयनित हैं, तथा प्रत्येक कौन-सी जनरेशन/संपादन क्षमताएँ उपलब्ध कराता है। -
छवि-जनरेशन परिवर्तनों के लिए
image generate --model <provider/model> --jsonसबसे सीमित लाइव स्मोक परीक्षण है:प्रतिक्रियाok,provider,model,attempts, और लिखे गए आउटपुट पथों की रिपोर्ट करती है। जब--outputसेट हो, तो अंतिम एक्सटेंशन प्रदाता द्वारा लौटाए गए MIME प्रकार के अनुसार हो सकता है। -
image describeऔरimage describe-manyके लिए, कार्य-विशिष्ट निर्देश (OCR, तुलना, UI निरीक्षण, संक्षिप्त कैप्शन लेखन) हेतु--promptका उपयोग करें। -
धीमे स्थानीय विज़न मॉडलों या Ollama के कोल्ड स्टार्ट के लिए
--timeout-msका उपयोग करें। -
image describeके लिए, एक स्पष्ट--model(जो छवि-सक्षम<provider/model>होना चाहिए) पहले चलता है, फिर वह कॉल विफल होने पर कॉन्फ़िगर किए गएagents.defaults.imageModel.fallbacksआज़माए जाते हैं। इनपुट-तैयारी त्रुटियाँ (फ़ाइल अनुपलब्ध, असमर्थित URL) किसी भी फ़ॉलबैक प्रयास से पहले विफल हो जाती हैं, और मॉडल कैटलॉग या प्रदाता कॉन्फ़िगरेशन में मॉडल का छवि-सक्षम होना आवश्यक है। -
स्थानीय Ollama विज़न मॉडलों के लिए, पहले मॉडल पुल करें और
OLLAMA_API_KEYको किसी भी प्लेसहोल्डर मान पर सेट करें, उदाहरण के लिएollama-local। Ollama देखें।
ऑडियो
फ़ाइल ट्रांसक्रिप्शन (रीयलटाइम सत्र प्रबंधन नहीं)।--model का <provider/model> होना आवश्यक है।
TTS
वाक् संश्लेषण और TTS प्रदाता/पर्सोना स्थिति।tts statusकेवल--gatewayका समर्थन करता है (यह Gateway द्वारा प्रबंधित TTS स्थिति को दर्शाता है)।- TTS व्यवहार का निरीक्षण और कॉन्फ़िगरेशन करने के लिए
tts providers,tts voices,tts personas,tts set-provider, औरtts set-personaका उपयोग करें।
वीडियो
जनरेशन और विवरण।video generate,--size,--aspect-ratio,--resolution,--duration,--audio,--watermark, और--timeout-msस्वीकार करता है, जिन्हें वीडियो-जनरेशन रनटाइम को अग्रेषित किया जाता है।video describeके लिए--modelका<provider/model>होना आवश्यक है।
वेब
खोज और फ़ेच।web providers खोज और फ़ेच के लिए उपलब्ध, कॉन्फ़िगर किए गए और चयनित प्रदाताओं को सूचीबद्ध करता है।
एम्बेडिंग
वेक्टर निर्माण और एम्बेडिंग-प्रदाता निरीक्षण।JSON आउटपुट
Infer कमांड साझा आवरण के अंतर्गत JSON आउटपुट को सामान्यीकृत करते हैं:okcapabilitytransportprovidermodelattemptsinputs(लागू होने पर अनुरोध के साथ भेजे गए छवि अटैचमेंट)outputsignoredOverrides(लागू होने पर वे संकेत कुंजियाँ जिनका प्रदाता समर्थन नहीं करता)error
outputs में OpenClaw द्वारा लिखी गई फ़ाइलें होती हैं। स्वचालन के लिए मानव-पठनीय stdout को पार्स करने के बजाय उस सरणी में मौजूद path, mimeType, size, और किसी भी मीडिया-विशिष्ट आयाम का उपयोग करें।