Skip to main content
OpenClaw अपने Bedrock Converse स्ट्रीमिंग प्रोवाइडर के माध्यम से Amazon Bedrock मॉडल का उपयोग कर सकता है। Bedrock प्रमाणीकरण AWS SDK डिफ़ॉल्ट क्रेडेंशियल शृंखला का उपयोग करता है, API कुंजी का नहीं।

आरंभ करना

अपनी पसंदीदा प्रमाणीकरण विधि चुनें और सेटअप के चरणों का पालन करें।
इनके लिए सर्वोत्तम: डेवलपर मशीनें, CI या वे होस्ट जहाँ आप AWS क्रेडेंशियल सीधे प्रबंधित करते हैं।
1

Gateway होस्ट पर AWS क्रेडेंशियल सेट करें

2

अपने कॉन्फ़िगरेशन में Bedrock प्रोवाइडर और मॉडल जोड़ें

किसी apiKey की आवश्यकता नहीं है। प्रोवाइडर को auth: "aws-sdk" के साथ कॉन्फ़िगर करें:
3

सत्यापित करें कि मॉडल उपलब्ध हैं

एनवायरनमेंट-मार्कर प्रमाणीकरण (AWS_ACCESS_KEY_ID, AWS_PROFILE या AWS_BEARER_TOKEN_BEDROCK) के साथ, OpenClaw अतिरिक्त कॉन्फ़िगरेशन के बिना मॉडल खोज के लिए अंतर्निहित Bedrock प्रोवाइडर को स्वतः सक्षम करता है।

स्वचालित मॉडल खोज

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 की आवश्यकता पड़ी हो।
स्पष्ट models.providers["amazon-bedrock"] प्रविष्टियों के लिए, OpenClaw पूर्ण रनटाइम प्रमाणीकरण लोड किए बिना भी AWS_BEARER_TOKEN_BEDROCK जैसे AWS एनवायरनमेंट मार्कर से Bedrock एनवायरनमेंट-मार्कर प्रमाणीकरण को पहले ही हल कर सकता है। वास्तविक मॉडल-कॉल प्रमाणीकरण पथ फिर भी AWS SDK डिफ़ॉल्ट शृंखला का उपयोग करता है।
कॉन्फ़िगरेशन विकल्प plugins.entries.amazon-bedrock.config.discovery के अंतर्गत होते हैं:
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 पैरामीटर का समर्थन करते हैं। निम्न स्तर उपलब्ध हैं: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”)। यदि आपको यह त्रुटि दिखाई दे, तो जाँचें कि मॉडल अनुरोधित स्तर का समर्थन करता है या नहीं।
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 पेलोड फ़ील्ड, दोनों पर लागू होता है।
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 कस्टम सैंपलिंग पैरामीटर और असमर्थित गैर-डिफ़ॉल्ट सेवा स्तरों को छोड़ देता है।
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, Bedrock के माध्यम से केवल उन खातों के लिए उपलब्ध है जिनके पास आवश्यक सीमित-पहुँच स्वीकृति है। OpenClaw फ़ाउंडेशन मॉडल anthropic.claude-mythos-5 और us.anthropic.claude-mythos-5 जैसी रीजनल या ग्लोबल इन्फ़रेंस प्रोफ़ाइल को पहचानता है।OpenClaw 1,000,000-टोकन कॉन्टेक्स्ट विंडो, 128,000-टोकन आउटपुट सीमा, इमेज इनपुट, प्रॉम्प्ट कैशिंग, अस्वीकृति-सुरक्षित स्ट्रीमिंग, और मूल प्रयास स्तर लागू करता है। अनुकूली चिंतन हमेशा सक्षम रहता है: /think off और /think minimal, low में मैप होते हैं, जबकि xhigh और max उपलब्ध रहते हैं। कस्टम सैंपलिंग और बाध्य टूल चयन मान छोड़ दिए जाते हैं।
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 आवश्यक हैं।
Gateway द्वारा उपयोग किए गए IAM प्रिंसिपल के पास मानक आह्वान अनुमतियों के अतिरिक्त bedrock:ApplyGuardrail अनुमति होनी चाहिए।
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 प्रदाता के रूप में कॉन्फ़िगर कर सकते हैं।

संबंधित

मॉडल चयन

प्रदाताओं, मॉडल रेफ़रेंस, और फ़ेलओवर व्यवहार का चयन।

मेमोरी खोज

मेमोरी खोज कॉन्फ़िगरेशन के लिए Bedrock एम्बेडिंग।

मेमोरी कॉन्फ़िगरेशन संदर्भ

Bedrock एम्बेडिंग मॉडल की पूरी सूची और आयाम विकल्प।

समस्या निवारण

सामान्य समस्या निवारण और अक्सर पूछे जाने वाले प्रश्न।