इस पेज पर
इस पेज पर
Providers
Amazon Bedrock
OpenClaw अपने Bedrock Converse स्ट्रीमिंग प्रोवाइडर के माध्यम से Amazon Bedrock मॉडल का उपयोग कर सकता है। Bedrock प्रमाणीकरण AWS SDK डिफ़ॉल्ट क्रेडेंशियल शृंखला का उपयोग करता है, API कुंजी का नहीं।
| गुण | मान |
|---|---|
| प्रोवाइडर | amazon-bedrock |
| API | bedrock-converse-stream |
| प्रमाणीकरण | AWS क्रेडेंशियल (एनवायरनमेंट वेरिएबल, साझा कॉन्फ़िगरेशन या इंस्टेंस भूमिका) |
| क्षेत्र | AWS_REGION या AWS_DEFAULT_REGION (डिफ़ॉल्ट: us-east-1) |
आरंभ करना
अपनी पसंदीदा प्रमाणीकरण विधि चुनें और सेटअप के चरणों का पालन करें।
एक्सेस कुंजियाँ / एनवायरनमेंट वेरिएबल
इनके लिए सर्वोत्तम: डेवलपर मशीनें, CI या वे होस्ट जहाँ आप AWS क्रेडेंशियल सीधे प्रबंधित करते हैं।
Gateway होस्ट पर AWS क्रेडेंशियल सेट करें
अपने कॉन्फ़िगरेशन में Bedrock प्रोवाइडर और मॉडल जोड़ें
किसी apiKey की आवश्यकता नहीं है। प्रोवाइडर को auth: "aws-sdk" के साथ कॉन्फ़िगर करें:
सत्यापित करें कि मॉडल उपलब्ध हैं
EC2 इंस्टेंस भूमिकाएँ (IMDS)
इनके लिए सर्वोत्तम: संलग्न IAM भूमिका वाले EC2 इंस्टेंस, जो प्रमाणीकरण के लिए इंस्टेंस मेटाडेटा सेवा का उपयोग करते हैं।
खोज को स्पष्ट रूप से सक्षम करें
IMDS का उपयोग करते समय, OpenClaw केवल एनवायरनमेंट मार्कर से AWS प्रमाणीकरण का पता नहीं लगा सकता, इसलिए आपको इसे स्पष्ट रूप से सक्षम करना होगा:
वैकल्पिक रूप से स्वचालित मोड के लिए एनवायरनमेंट मार्कर जोड़ें
यदि आप एनवायरनमेंट-मार्कर स्वतः-पहचान पथ को भी सक्रिय रखना चाहते हैं (उदाहरण के लिए, openclaw status सतहों के लिए):
आपको नकली API कुंजी की आवश्यकता नहीं है।
सत्यापित करें कि मॉडल खोज लिए गए हैं
स्वचालित मॉडल खोज
OpenClaw उन Bedrock मॉडल को स्वचालित रूप से खोज सकता है जो स्ट्रीमिंग
और टेक्स्ट आउटपुट का समर्थन करते हैं। खोज bedrock:ListFoundationModels और
bedrock:ListInferenceProfiles का उपयोग करती है, और परिणाम कैश किए जाते हैं (डिफ़ॉल्ट: 1 घंटा)।
अंतर्निहित प्रोवाइडर को सक्षम करने का तरीका:
- यदि
plugins.entries.amazon-bedrock.config.discovery.enabled,trueहै, तो AWS एनवायरनमेंट मार्कर मौजूद न होने पर भी OpenClaw खोज का प्रयास करेगा। - यदि
plugins.entries.amazon-bedrock.config.discovery.enabledसेट नहीं है, तो OpenClaw अंतर्निहित Bedrock प्रोवाइडर को केवल तभी स्वतः जोड़ता है, जब उसे इनमें से कोई AWS प्रमाणीकरण मार्कर दिखाई देता है:AWS_BEARER_TOKEN_BEDROCK,AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, याAWS_PROFILE। - वास्तविक Bedrock रनटाइम प्रमाणीकरण पथ फिर भी AWS SDK डिफ़ॉल्ट शृंखला का उपयोग करता है, इसलिए
साझा कॉन्फ़िगरेशन, SSO और IMDS इंस्टेंस-भूमिका प्रमाणीकरण तब भी काम कर सकते हैं, जब खोज
को स्पष्ट रूप से सक्षम करने के लिए
enabled: trueकी आवश्यकता पड़ी हो।
खोज कॉन्फ़िगरेशन विकल्प
कॉन्फ़िगरेशन विकल्प plugins.entries.amazon-bedrock.config.discovery के अंतर्गत होते हैं:
| विकल्प | डिफ़ॉल्ट | विवरण |
|---|---|---|
enabled |
स्वचालित | स्वचालित मोड में, OpenClaw अंतर्निहित Bedrock प्रोवाइडर को केवल तभी सक्षम करता है, जब उसे कोई समर्थित AWS एनवायरनमेंट मार्कर दिखाई देता है। खोज को बाध्य करने के लिए true सेट करें। |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
खोज API कॉल के लिए उपयोग किया जाने वाला AWS क्षेत्र। |
providerFilter |
(सभी) | Bedrock प्रोवाइडर नामों से मिलान करता है (उदाहरण के लिए anthropic, amazon)। |
refreshInterval |
3600 |
कैश अवधि, सेकंड में। कैशिंग अक्षम करने के लिए इसे 0 पर सेट करें। |
defaultContextWindow |
32000 |
अज्ञात टोकन सीमाओं वाले खोजे गए मॉडल के लिए उपयोग की जाने वाली संदर्भ विंडो (यदि आपको अपने मॉडल की सीमाएँ ज्ञात हैं, तो इसे ओवरराइड करें)। |
defaultMaxTokens |
4096 |
अज्ञात टोकन सीमाओं वाले खोजे गए मॉडल के लिए उपयोग किए जाने वाले अधिकतम आउटपुट टोकन (यदि आपको अपने मॉडल की सीमाएँ ज्ञात हैं, तो इसे ओवरराइड करें)। |
संदर्भ विंडो और अधिकतम टोकन सीमाएँ
Bedrock ListFoundationModels और GetFoundationModel API कोई
टोकन-सीमा मेटाडेटा नहीं लौटाते, केवल मॉडल ID, नाम, मोडैलिटी और जीवनचक्र
स्थिति लौटाते हैं। OpenClaw लोकप्रिय Bedrock मॉडल (Claude, Nova, Llama, Mistral, DeepSeek
और अन्य) के ज्ञात संदर्भ विंडो और आउटपुट
सीमाओं की एक लुकअप तालिका के साथ आता है, ताकि उन मॉडल के लिए सत्र प्रबंधन, Compaction सीमाएँ और
संदर्भ-ओवरफ़्लो पहचान सही ढंग से काम करें।
तालिका में शामिल न होने वाले खोजे गए मॉडल defaultContextWindow
और defaultMaxTokens पर फ़ॉलबैक करते हैं। यदि आपके उपयोग का कोई मॉडल सटीक सीमाओं के बिना है,
तो उसे स्पष्ट
models.providers["amazon-bedrock"].models प्रविष्टि से ओवरराइड करें।
त्वरित सेटअप (AWS पथ)
यह चरण-दर-चरण मार्गदर्शिका एक IAM भूमिका बनाती है, Bedrock अनुमतियाँ संलग्न करती है, इंस्टेंस प्रोफ़ाइल संबद्ध करती है और EC2 होस्ट पर OpenClaw खोज सक्षम करती है।
उन्नत कॉन्फ़िगरेशन
इन्फ़रेंस प्रोफ़ाइल
OpenClaw फ़ाउंडेशन मॉडल के साथ-साथ क्षेत्रीय और वैश्विक इन्फ़रेंस प्रोफ़ाइल
खोजता है। जब कोई प्रोफ़ाइल किसी ज्ञात फ़ाउंडेशन मॉडल से मैप होती है, तो
प्रोफ़ाइल उस मॉडल की क्षमताएँ (संदर्भ विंडो, अधिकतम टोकन,
रीजनिंग, विज़न) ग्रहण करती है और सही Bedrock अनुरोध क्षेत्र
स्वचालित रूप से इंजेक्ट किया जाता है। इसका अर्थ है कि क्रॉस-रीजन Claude प्रोफ़ाइल मैन्युअल
प्रोवाइडर ओवरराइड के बिना काम करती हैं। वैश्विक क्रॉस-रीजन प्रोफ़ाइल (global.*) को
openclaw models list में पहले सूचीबद्ध किया जाता है, क्योंकि वे सामान्यतः बेहतर क्षमता
और स्वचालित फ़ेलओवर प्रदान करती हैं।
इन्फ़रेंस प्रोफ़ाइल ID us.anthropic.claude-opus-4-6-v1 (क्षेत्रीय)
या anthropic.claude-opus-4-6-v1 (वैश्विक) जैसी होती हैं। यदि आधारभूत मॉडल पहले से
खोज परिणामों में है, तो प्रोफ़ाइल उसकी क्षमताओं का पूरा सेट ग्रहण करती है;
अन्यथा सुरक्षित डिफ़ॉल्ट लागू होते हैं।
किसी अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है। जब तक खोज सक्षम है और IAM
प्रिंसिपल के पास bedrock:ListInferenceProfiles है, प्रोफ़ाइल
openclaw models list में फ़ाउंडेशन मॉडल के साथ दिखाई देती हैं।
सेवा स्तर
कुछ Bedrock मॉडल लागत
या विलंबता को अनुकूलित करने के लिए service_tier पैरामीटर का समर्थन करते हैं। निम्न स्तर उपलब्ध हैं:
| स्तर | विवरण |
|---|---|
default |
मानक Bedrock स्तर |
flex |
उन कार्यभारों के लिए रियायती प्रोसेसिंग जो अधिक विलंबता सहन कर सकते हैं |
priority |
विलंबता-संवेदनशील कार्यभारों के लिए प्राथमिकता वाली प्रोसेसिंग |
reserved |
स्थिर-अवस्था वाले कार्यभारों के लिए आरक्षित क्षमता |
Bedrock मॉडल अनुरोधों के लिए agents.defaults.params के माध्यम से
serviceTier (या service_tier) सेट करें, या
agents.defaults.models["<model-key>"].params में प्रत्येक मॉडल के लिए अलग से सेट करें:
मान्य मान default, flex, priority, और reserved हैं। Claude
Fable 5, Opus 5, और Sonnet 5 केवल default स्तर का समर्थन करते हैं; OpenClaw उन मॉडल के लिए अनुरोधित
flex, priority, या reserved को लेकर चेतावनी देता है और
उन्हें अनदेखा करता है। अन्य मॉडल के लिए, हर मॉडल हर स्तर का समर्थन नहीं करता है -- असमर्थित स्तर
Bedrock सत्यापन त्रुटि लौटाता है, और त्रुटि संदेश
भ्रामक हो सकता है (उदाहरण के लिए, स्तर को समस्या बताने के बजाय
"The provided model identifier is invalid")। यदि आपको यह त्रुटि दिखाई दे, तो जाँचें
कि मॉडल अनुरोधित स्तर का समर्थन करता है या नहीं।
Claude Opus 5, 4.8, और 4.7 का तापमान
Bedrock, Claude Opus 5, Opus 4.8,
और Opus 4.7 के लिए temperature पैरामीटर अस्वीकार करता है। OpenClaw किसी भी मेल खाने वाले Bedrock
रेफ़रेंस के लिए temperature को स्वचालित रूप से छोड़ देता है, जिसमें फ़ाउंडेशन मॉडल आईडी, नामित इन्फ़रेंस प्रोफ़ाइल, ऐसी एप्लिकेशन
इन्फ़रेंस प्रोफ़ाइल जिनका अंतर्निहित मॉडल bedrock:GetInferenceProfile के माध्यम से Opus 5/4.8/4.7 में रिज़ॉल्व होता है,
और वैकल्पिक रीजन प्रीफ़िक्स वाले डॉटेड opus-4.7/opus-4.8 वेरिएंट
(us., eu., ap., apac., au., jp.,
global.) शामिल हैं। किसी कॉन्फ़िगरेशन विकल्प की आवश्यकता नहीं है, और यह विलोपन
अनुरोध विकल्प ऑब्जेक्ट तथा inferenceConfig पेलोड फ़ील्ड, दोनों पर लागू होता है।
Claude Opus 5
Messages-API Bedrock
एंडपॉइंट पर amazon-bedrock/anthropic.claude-opus-5, या Bedrock डिस्कवरी में दिखाई देने पर
global.anthropic.claude-opus-5 जैसी रीजनल/ग्लोबल इन्फ़रेंस प्रोफ़ाइल का उपयोग करें।
OpenClaw 1,000,000-टोकन कॉन्टेक्स्ट विंडो, 128,000-टोकन आउटपुट
सीमा, इमेज इनपुट, प्रॉम्प्ट कैशिंग, अस्वीकृति-सुरक्षित स्ट्रीमिंग, और मूल
xhigh/max प्रयास स्तर लागू करता है।
अनुकूली चिंतन का डिफ़ॉल्ट high है। /think off चिंतन को अक्षम करता है, जबकि
/think xhigh|max अनुकूली चिंतन को सक्षम रखता है। OpenClaw कस्टम
सैंपलिंग पैरामीटर और असमर्थित गैर-डिफ़ॉल्ट सेवा स्तरों को छोड़ देता है।
Claude Fable 5
us-east-1 में amazon-bedrock/anthropic.claude-fable-5, या
us.anthropic.claude-fable-5 जैसी रीजनल इन्फ़रेंस आईडी का उपयोग करें।
OpenClaw Fable की 1M कॉन्टेक्स्ट विंडो, 128K आउटपुट सीमा, हमेशा-सक्रिय
अनुकूली चिंतन, और समर्थित प्रयास मैपिंग लागू करता है। /think off और
/think minimal, low में मैप होते हैं; Opus 4.7/4.8 रूट के अनुरूप,
तापमान और बाध्य टूल चयन नियंत्रण छोड़ दिए जाते हैं। स्ट्रीमिंग आउटपुट को
तब तक रोका जाता है जब तक Bedrock कोई अंतिम स्थिति नहीं लौटाता, ताकि स्ट्रीम के बीच होने वाली अस्वीकृतियाँ
आंशिक टेक्स्ट उजागर न करें।
Fable उपलब्ध होने से पहले AWS को स्पष्ट provider_data_share डेटा-प्रतिधारण सहमति
आवश्यक होती है। प्रॉम्प्ट और पूर्णताएँ Anthropic के साथ साझा की जाती हैं और
भरोसे तथा सुरक्षा के लिए अधिकतम 30 दिनों तक रखी जाती हैं। मॉडल सक्षम करने से पहले
Bedrock डेटा प्रतिधारण
की समीक्षा और कॉन्फ़िगरेशन करें।
Claude Mythos 5
Claude Mythos 5, Bedrock के माध्यम से केवल उन खातों के लिए उपलब्ध है जिनके पास
आवश्यक सीमित-पहुँच स्वीकृति है। OpenClaw फ़ाउंडेशन मॉडल
anthropic.claude-mythos-5 और us.anthropic.claude-mythos-5 जैसी रीजनल या ग्लोबल इन्फ़रेंस प्रोफ़ाइल
को पहचानता है।
OpenClaw 1,000,000-टोकन कॉन्टेक्स्ट विंडो, 128,000-टोकन आउटपुट
सीमा, इमेज इनपुट, प्रॉम्प्ट कैशिंग, अस्वीकृति-सुरक्षित स्ट्रीमिंग, और मूल
प्रयास स्तर लागू करता है। अनुकूली चिंतन हमेशा सक्षम रहता है: /think off और
/think minimal, low में मैप होते हैं, जबकि xhigh और max उपलब्ध रहते हैं।
कस्टम सैंपलिंग और बाध्य टूल चयन मान छोड़ दिए जाते हैं।
Claude Sonnet 5
AWS, Sonnet 5 को
bedrock-runtime और bedrock-mantle एंडपॉइंट, दोनों के लिए दस्तावेज़ित करता है।
OpenClaw, Bedrock फ़ाउंडेशन मॉडल
anthropic.claude-sonnet-5 और us.anthropic.claude-sonnet-5 जैसी रीजनल या ग्लोबल इन्फ़रेंस प्रोफ़ाइल
को पहचानता है। यह 1,000,000-टोकन कॉन्टेक्स्ट
विंडो, 128,000-टोकन आउटपुट सीमा, इमेज इनपुट, मूल प्रयास स्तर,
प्रॉम्प्ट कैशिंग, और अस्वीकृति-सुरक्षित स्ट्रीमिंग लागू करता है।
Bedrock, Sonnet 5 के लिए अनुकूली चिंतन सक्षम रखता है। OpenClaw का डिफ़ॉल्ट
high है; /think off और /think minimal, low में मैप होते हैं क्योंकि यह रूट
चिंतन को अक्षम नहीं कर सकता। अनुकूली चिंतन सक्रिय रहने के दौरान कस्टम तापमान और बाध्य टूल चयन मान
छोड़ दिए जाते हैं।
गार्डरेल
amazon-bedrock Plugin कॉन्फ़िगरेशन में guardrail ऑब्जेक्ट जोड़कर
सभी Bedrock मॉडल आह्वानों पर Amazon Bedrock Guardrails
लागू किए जा सकते हैं। गार्डरेल से आप सामग्री फ़िल्टरिंग,
विषय निषेध, शब्द फ़िल्टर, संवेदनशील जानकारी फ़िल्टर, और संदर्भात्मक
ग्राउंडिंग जाँच लागू कर सकते हैं।
guardrailIdentifier और guardrailVersion आवश्यक हैं।
| विकल्प | विवरण |
|---|---|
guardrailIdentifier |
गार्डरेल आईडी (जैसे abc123) या पूर्ण ARN (जैसे arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123)। |
guardrailVersion |
प्रकाशित संस्करण संख्या, या कार्यशील ड्राफ़्ट के लिए "DRAFT"। |
streamProcessingMode |
स्ट्रीमिंग के दौरान गार्डरेल मूल्यांकन के लिए "sync" या "async"। छोड़े जाने पर Bedrock अपने डिफ़ॉल्ट का उपयोग करता है। |
trace |
डीबगिंग के लिए "enabled" या "enabled_full"; प्रोडक्शन के लिए इसे छोड़ दें या "disabled" पर सेट करें। |
मेमोरी खोज के लिए एम्बेडिंग
Bedrock, मेमोरी खोज के लिए एम्बेडिंग प्रदाता के रूप में भी काम कर सकता है।
इसे इन्फ़रेंस प्रदाता से अलग कॉन्फ़िगर किया जाता है -- memory.search.provider को "bedrock" पर सेट करें:
Bedrock एम्बेडिंग, इन्फ़रेंस के समान AWS SDK क्रेडेंशियल शृंखला का उपयोग करती हैं (इंस्टेंस भूमिकाएँ, SSO, एक्सेस कुंजियाँ, साझा कॉन्फ़िगरेशन, और वेब पहचान)। किसी API कुंजी की आवश्यकता नहीं है।
समर्थित एम्बेडिंग मॉडल में Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4), और TwelveLabs Marengo शामिल हैं। पूरी मॉडल सूची और आयाम विकल्पों के लिए मेमोरी कॉन्फ़िगरेशन संदर्भ -- Bedrock देखें।
टिप्पणियाँ और सावधानियाँ
- Bedrock के लिए आपके AWS खाते/रीजन में मॉडल एक्सेस सक्षम होना आवश्यक है।
- स्वचालित डिस्कवरी के लिए
bedrock:ListFoundationModelsऔरbedrock:ListInferenceProfilesअनुमतियाँ आवश्यक हैं। - यदि आप ऑटो मोड पर निर्भर हैं, तो Gateway होस्ट पर समर्थित AWS प्रमाणीकरण एनवायरनमेंट मार्कर में से कोई एक सेट करें।
यदि आप एनवायरनमेंट मार्कर के बिना IMDS/साझा-कॉन्फ़िगरेशन प्रमाणीकरण पसंद करते हैं, तो
plugins.entries.amazon-bedrock.config.discovery.enabled: trueसेट करें। - OpenClaw क्रेडेंशियल स्रोत को इस क्रम में दिखाता है:
AWS_BEARER_TOKEN_BEDROCK, फिरAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, फिरAWS_PROFILE, और फिर डिफ़ॉल्ट AWS SDK शृंखला। - रीज़निंग समर्थन मॉडल पर निर्भर करता है; वर्तमान क्षमताओं के लिए Bedrock मॉडल कार्ड देखें।
- यदि आप प्रबंधित कुंजी प्रवाह पसंद करते हैं, तो Bedrock के सामने OpenAI-संगत प्रॉक्सी भी रख सकते हैं और इसके बजाय उसे OpenAI प्रदाता के रूप में कॉन्फ़िगर कर सकते हैं।