प्रमाणीकरण

OpenClaw मॉडल प्रदाताओं के लिए OAuth और API कुंजियों का समर्थन करता है। हमेशा चालू रहने वाले Gateway होस्ट के लिए API कुंजी सबसे पूर्वानुमेय विकल्प है; सदस्यता/OAuth प्रवाह भी तब काम करते हैं, जब वे आपके प्रदाता खाते के मॉडल से मेल खाते हों।

• पूरा OAuth प्रवाह और स्टोरेज लेआउट: /concepts/oauth
• SecretRef-आधारित प्रमाणीकरण (env/file/exec प्रदाता): सीक्रेट प्रबंधन
• models status --probe द्वारा उपयोग किए जाने वाले क्रेडेंशियल पात्रता/कारण कोड: प्रमाणीकरण क्रेडेंशियल अर्थविज्ञान

अनुशंसित सेटअप: API कुंजी (कोई भी प्रदाता)

1. अपने प्रदाता कंसोल में एक API कुंजी बनाएँ।
2. इसे Gateway होस्ट (openclaw gateway चलाने वाली मशीन) पर रखें:

export <PROVIDER>_API_KEY="..."openclaw models status

3. यदि Gateway systemd/launchd के अंतर्गत चलता है, तो कुंजी को ~/.openclaw/.env में रखें, ताकि डेमन उसे पढ़ सके:

cat >> ~/.openclaw/.env <<'EOF'&lt;PROVIDER&gt;_API_KEY=...EOF

4. Gateway प्रक्रिया (या डेमन) को पुनः आरंभ करें, फिर दोबारा जाँचें:

openclaw models statusopenclaw doctor

यदि आप स्वयं env vars प्रबंधित नहीं करना चाहते हैं, तो openclaw onboard डेमन के उपयोग के लिए API कुंजियाँ भी संग्रहीत कर सकता है। env लोडिंग की पूरी प्राथमिकता (env.shellEnv, ~/.openclaw/.env, systemd/launchd) के लिए पर्यावरण चर देखें।

Anthropic: Claude CLI का पुनः उपयोग

Anthropic सेटअप-टोकन प्रमाणीकरण अब भी समर्थित विकल्प है। Claude CLI का पुनः उपयोग (claude -p-शैली का उपयोग) भी इस एकीकरण के लिए अनुमोदित है; जब होस्ट पर Claude CLI लॉगिन उपलब्ध हो, तो स्थानीय/डेस्कटॉप उपयोग के लिए यही पसंदीदा विकल्प है। लंबे समय तक चलने वाले Gateway होस्ट के लिए, स्पष्ट सर्वर-साइड बिलिंग नियंत्रण के साथ Anthropic API कुंजी अब भी सबसे पूर्वानुमेय विकल्प है।

Claude CLI के पुनः उपयोग के लिए होस्ट सेटअप:

# Gateway होस्ट पर चलाएँclaude auth loginclaude auth status --textopenclaw models auth login --provider anthropic --method cli --set-default

इसके दो चरण हैं: होस्ट पर Claude Code को Anthropic में लॉग इन करें, फिर OpenClaw को Anthropic मॉडल चयन स्थानीय claude-cli बैकएंड के माध्यम से रूट करने और उससे मेल खाने वाली OpenClaw प्रमाणीकरण प्रोफ़ाइल संग्रहीत करने के लिए कहें।

Gateway सेवा को PATH पर claude को रिज़ॉल्व करना आवश्यक है। यदि किसी परिनियोजन को गैर-मानक निष्पादन योग्य पथ की आवश्यकता हो, तो CLI बैकएंड Plugin के माध्यम से एक रैपर पंजीकृत करें।

मैन्युअल टोकन प्रविष्टि

किसी भी प्रदाता के लिए काम करती है; प्रति-एजेंट SQLite प्रमाणीकरण स्टोर में लिखती है और कॉन्फ़िगरेशन अपडेट करती है:

openclaw models auth paste-token --provider openrouter

OpenClaw प्रत्येक एजेंट के openclaw-agent.sqlite से प्रमाणीकरण प्रोफ़ाइल पढ़ता है। एंडपॉइंट विवरण (baseUrl, api, मॉडल आईडी, हेडर, टाइमआउट) प्रमाणीकरण प्रोफ़ाइल में नहीं, बल्कि openclaw.json या models.json के models.providers.<id> के अंतर्गत होने चाहिए।

यदि किसी पुराने इंस्टॉल में अब भी auth-profiles.json, auth-state.json, या { "openrouter": { "apiKey": "..." } } जैसा समतल आकार मौजूद है, तो उसे SQLite में आयात करने के लिए openclaw doctor --fix चलाएँ; doctor मूल JSON फ़ाइलों के पास टाइमस्टैम्प वाले बैकअप रखता है।

Bedrock auth: "aws-sdk" जैसे बाहरी प्रमाणीकरण रूट क्रेडेंशियल नहीं हैं। नामित Bedrock रूट के लिए openclaw.json में auth.profiles.<id>.mode: "aws-sdk" सेट करें—प्रमाणीकरण प्रोफ़ाइल स्टोर में type: "aws-sdk" न लिखें। openclaw doctor --fix पुराने AWS SDK मार्कर को क्रेडेंशियल स्टोर से कॉन्फ़िगरेशन मेटाडेटा में माइग्रेट करता है।

SecretRef-समर्थित क्रेडेंशियल

• api_key क्रेडेंशियल keyRef: { source, provider, id } का उपयोग कर सकते हैं
• token क्रेडेंशियल tokenRef: { source, provider, id } का उपयोग कर सकते हैं
• OAuth-मोड प्रोफ़ाइल SecretRef क्रेडेंशियल अस्वीकार करती हैं: यदि auth.profiles.<id>.mode, "oauth" है, तो उस प्रोफ़ाइल के लिए SecretRef-समर्थित keyRef/tokenRef अस्वीकार कर दिया जाता है।

मॉडल प्रमाणीकरण स्थिति की जाँच

openclaw models statusopenclaw doctor

ऑटोमेशन-अनुकूल जाँच, समाप्त/अनुपलब्ध होने पर निकास 1, शीघ्र समाप्त होने पर 2:

openclaw models status --check

लाइव प्रमाणीकरण जाँच (दायरा सीमित करने के लिए --probe-provider, --probe-profile, --probe-timeout, --probe-concurrency, या --probe-max-tokens जोड़ें):

openclaw models status --probe

टिप्पणियाँ:

• जाँच पंक्तियाँ प्रमाणीकरण प्रोफ़ाइल, env क्रेडेंशियल, या models.json से आ सकती हैं।
• यदि auth.order.<provider> किसी संग्रहीत प्रोफ़ाइल को छोड़ देता है, तो जाँच उसे आज़माने के बजाय उस प्रोफ़ाइल के लिए excluded_by_auth_order रिपोर्ट करती है।
• यदि प्रमाणीकरण मौजूद है, लेकिन OpenClaw उस प्रदाता के लिए जाँच योग्य मॉडल रिज़ॉल्व नहीं कर पाता, तो जाँच status: no_model रिपोर्ट करती है।
• दर-सीमा कूलडाउन मॉडल-दायरे वाले हो सकते हैं: एक मॉडल के लिए कूलडाउन में मौजूद प्रोफ़ाइल उसी प्रदाता के दूसरे मॉडल को फिर भी सेवा दे सकती है।

वैकल्पिक संचालन स्क्रिप्ट (systemd/Termux): प्रमाणीकरण निगरानी स्क्रिप्ट।

API कुंजी रोटेशन (Gateway)

जब किसी कॉल पर प्रदाता की दर-सीमा लागू होती है, तो कुछ प्रदाता किसी वैकल्पिक कॉन्फ़िगर की गई कुंजी के साथ अनुरोध का पुनः प्रयास करते हैं।

प्रति प्रदाता कुंजी प्राथमिकता क्रम:

1. OPENCLAW_LIVE_<PROVIDER>_KEY (एकल ओवरराइड, एक कुंजी को पिन करता है)
2. <PROVIDER>_API_KEYS (अल्पविराम/स्पेस/अर्धविराम से अलग की गई सूची)
3. <PROVIDER>_API_KEY
4. <PROVIDER>_API_KEY_* (इस उपसर्ग वाला कोई भी env var)

Google प्रदाता (google, google-vertex) अतिरिक्त रूप से GOOGLE_API_KEY पर फ़ॉलबैक करते हैं। संयुक्त सूची का उपयोग करने से पहले उसमें से डुप्लिकेट हटा दिए जाते हैं।

OpenClaw अगली कुंजी पर केवल तभी रोटेट करता है, जब त्रुटि संदेश rate_limit, rate limit, 429, quota exceeded/quota_exceeded, resource exhausted/resource_exhausted, या too many requests से मेल खाता हो। अन्य त्रुटियों पर वैकल्पिक कुंजियों के साथ पुनः प्रयास नहीं किया जाता। यदि सभी कुंजियाँ विफल हो जाती हैं, तो अंतिम प्रयास की अंतिम त्रुटि लौटाई जाती है।

सहेजा गया प्रमाणीकरण हटाने से प्रदाता के पास कुंजी निरस्त नहीं होती—जब प्रदाता-साइड अमान्यकरण आवश्यक हो, तो प्रदाता डैशबोर्ड में उसे रोटेट या निरस्त करें।

Gateway के चलने के दौरान प्रदाता प्रमाणीकरण हटाना

जब आप Gateway कंट्रोल प्लेन के माध्यम से प्रदाता प्रमाणीकरण हटाते हैं, तो OpenClaw उस प्रदाता की सहेजी गई प्रमाणीकरण प्रोफ़ाइल मिटा देता है और उन सक्रिय चैट/एजेंट रन को रोक देता है, जिनका चयनित मॉडल प्रदाता हटाए गए प्रदाता से मेल खाता है। रोके गए रन stopReason: "auth-revoked" के साथ सामान्य रद्दीकरण/जीवनचक्र इवेंट उत्सर्जित करते हैं, ताकि कनेक्टेड क्लाइंट दिखा सकें कि क्रेडेंशियल हटाए जाने के कारण रन रुक गया।

यह नियंत्रित करना कि कौन-सा क्रेडेंशियल उपयोग किया जाए

OpenAI और पुराने openai-codex आईडी

OpenAI API-कुंजी प्रोफ़ाइल और ChatGPT/Codex OAuth प्रोफ़ाइल दोनों मानक प्रदाता आईडी openai का उपयोग करती हैं। नए कॉन्फ़िगरेशन के लिए openai:* प्रोफ़ाइल आईडी और auth.order.openai का उपयोग करें।

यदि पुराने कॉन्फ़िगरेशन, प्रमाणीकरण प्रोफ़ाइल आईडी, या auth.order.openai-codex में openai-codex दिखाई दे, तो उसे पुराना माइग्रेशन इनपुट मानें—नई openai-codex प्रोफ़ाइल न बनाएँ। चलाएँ:

openclaw doctor --fixopenclaw models auth list --provider openai

Doctor पुराने openai-codex:* प्रोफ़ाइल आईडी और auth.order.openai-codex प्रविष्टियों को मानक openai रूट में पुनर्लिखता है। OpenAI-विशिष्ट मॉडल/रनटाइम रूटिंग के लिए OpenAI देखें।

लॉगिन के दौरान (CLI)

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

--profile-id एक ही एजेंट के भीतर समान प्रदाता के कई OAuth लॉगिन को अलग रखता है।

--force चयनित एजेंट डायरेक्टरी में उस प्रदाता की सहेजी गई प्रमाणीकरण प्रोफ़ाइल मिटाता है, फिर वही प्रमाणीकरण प्रवाह दोबारा चलाता है। इसका उपयोग तब करें, जब कोई सहेजी गई प्रोफ़ाइल अटकी हो, समाप्त हो चुकी हो, या गलत खाते से जुड़ी हो। यह प्रदाता के पास क्रेडेंशियल निरस्त नहीं करता।

openclaw models auth login --provider anthropic --force

प्रति-सत्र (चैट कमांड)

• /model <alias-or-id>@<profileId> वर्तमान सत्र के लिए किसी विशिष्ट प्रदाता क्रेडेंशियल को पिन करता है (उदाहरण प्रोफ़ाइल आईडी: anthropic:default, anthropic:work)।
• /model (या /model list) एक संक्षिप्त चयनकर्ता दिखाता है; /model status पूर्ण दृश्य दिखाता है (उम्मीदवार + अगली प्रमाणीकरण प्रोफ़ाइल, साथ ही कॉन्फ़िगर होने पर प्रदाता एंडपॉइंट विवरण)।

यदि आप पहले से चल रही चैट के लिए प्रमाणीकरण क्रम या प्रोफ़ाइल पिनिंग बदलते हैं, तो नया सत्र शुरू करने के लिए /new या /reset भेजें—मौजूदा सत्र रीसेट होने तक अपने वर्तमान मॉडल/प्रोफ़ाइल चयन को बनाए रखते हैं।

प्रति-एजेंट (CLI ओवरराइड)

प्रमाणीकरण क्रम ओवरराइड उस एजेंट की SQLite प्रमाणीकरण स्थिति में संग्रहीत होते हैं:

openclaw models auth order get --provider anthropicopenclaw models auth order set --provider anthropic anthropic:defaultopenclaw models auth order clear --provider anthropic

किसी विशिष्ट एजेंट को लक्षित करने के लिए --agent <id> का उपयोग करें; कॉन्फ़िगर किए गए डिफ़ॉल्ट एजेंट का उपयोग करने के लिए इसे छोड़ दें। openclaw models status --probe छोड़ी गई संग्रहीत प्रोफ़ाइल को चुपचाप छोड़ने के बजाय excluded_by_auth_order के रूप में दिखाता है।

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

"कोई क्रेडेंशियल नहीं मिला"

Gateway होस्ट पर Anthropic API कुंजी कॉन्फ़िगर करें, या Anthropic सेटअप-टोकन पथ सेट करें, फिर दोबारा जाँचें:

openclaw models status

टोकन शीघ्र समाप्त होने वाला/समाप्त

कौन-सी प्रोफ़ाइल समाप्त होने वाली है, यह देखने के लिए openclaw models status चलाएँ। यदि Anthropic टोकन प्रोफ़ाइल अनुपलब्ध या समाप्त हो गई है, तो उसे सेटअप-टोकन के माध्यम से रीफ़्रेश करें या Anthropic API कुंजी पर माइग्रेट करें।

संबंधित

• सीक्रेट प्रबंधन
• दूरस्थ पहुँच
• प्रमाणीकरण स्टोरेज