OpenClaw ఇన్‌స్టాలేషన్ మరియు OmniProxy కాన్ఫిగరేషన్

OpenClaw అనేది మీ స్వంత కంప్యూటర్‌లో ఇన్‌స్టాల్ చేయబడే ఒక AI అసిస్టెంట్. మీరు మరొక చాట్ విండోను తెరిచి ఉంచాల్సిన అవసరం లేకుండానే Telegram, Discord, WhatsApp లేదా Feishu ద్వారా నేరుగా దీనితో మాట్లాడవచ్చు. సంభాషణలు మరియు రికార్డులు ఈ కంప్యూటర్‌లోనే ఉంటాయి మరియు ఇది స్థానికంగా తదుపరి దశలను కొనసాగించగలదు.

ప్రారంభించే ముందు

OpenClawకి Node 24.16 లేదా అంతకంటే కొత్త వెర్షన్ అవసరం. మీరు Node 26.1 లేదా అంతకంటే కొత్త వెర్షన్‌ను కూడా ఉపయోగించవచ్చు, Node 26 సిఫార్సు చేయబడింది. Node, OpenClawకి అవసరమైన రన్‌టైమ్ ఎన్విరాన్‌మెంట్‌ను అందిస్తుంది.

దీనిని macOS, Linux మరియు Windowsలలో ఇన్‌స్టాల్ చేయవచ్చు. కంప్యూటర్‌లో తగిన Node వెర్షన్ లేకపోతే, ఇన్‌స్టాలేషన్ స్క్రిప్ట్ స్వయంచాలకంగా ఒకదాన్ని సిద్ధం చేస్తుంది: macOSలో Node 26 మరియు Linuxలో Node 24 LTS. OpenClawని సోర్స్ నుండి బిల్డ్ చేసేటప్పుడు మాత్రమే pnpm అవసరం.

మీరు ఇప్పటికే పాత Node వెర్షన్‌ను ఇన్‌స్టాల్ చేసి ఉంటే, దాన్ని ముందుగా అన్‌ఇన్‌స్టాల్ చేయనవసరం లేదు. 2026-10-09న జరిగిన పరీక్షలో, ఈ కంప్యూటర్‌లోని సిస్టమ్ Node వెర్షన్ 24.2.0 (అవసరమైన 24.16 కంటే తక్కువ) ఉంది, మరియు నాన్-ఇంటరాక్టివ్ ఇన్‌స్టాలేషన్ స్క్రిప్ట్ స్వయంచాలకంగా Node 24.21.0ని సిద్ధం చేసింది.

మీకు విండో కావాలంటే

డెస్క్‌టాప్ కంపానియన్

• Windowsలో Hub ఇన్‌స్టాలర్‌ని ఉపయోగించండి
• macOSలో GitHub DMGని ఉపయోగించండి
• ప్రారంభ సెటప్ సమయంలో లోకల్ గేట్‌వేని ఇన్‌స్టాల్ చేయవచ్చు

అధికారికంగా సిఫార్సు చేయబడింది

ఇన్‌స్టాలేషన్ స్క్రిప్ట్

• macOS Linux WSL2
• Windowsలో PowerShell ఉపయోగించండి
• మీరు --no-onboardని జోడించవచ్చు

Node ఇప్పటికే ఇన్‌స్టాల్ చేయబడింది

ప్యాకేజీ మేనేజర్

• npm pnpm లేదా bun
• తర్వాత onboardని రన్ చేయండి
• Node వెర్షన్ కోసం ఇన్‌స్టాలేషన్ పేజీని చూడండి

మొదటిసారి ఇన్‌స్టాల్ చేసి ప్రారంభించడం

మీరు గ్రాఫికల్ విండోతో డెస్క్‌టాప్ కంపానియన్‌ని ఇన్‌స్టాల్ చేయవచ్చు లేదా నేరుగా టెర్మినల్ ద్వారా ఇన్‌స్టాల్ చేయవచ్చు. గేట్‌వే అనేది మెసేజ్‌లను స్వీకరించడానికి, మోడల్స్‌ని పిలవడానికి మరియు ఫలితాలను తిరిగి ఇవ్వడానికి బాధ్యత వహించే లోకల్ సర్వీస్. డెస్క్‌టాప్ కంపానియన్‌ని మొదటిసారి తెరిచినప్పుడు మీరు దీన్ని సెటప్ చేయవచ్చు.

మీకు విండో కావాలంటే

• Windows: OpenClawCompanion-Setup-x64.exe లేదా OpenClawCompanion-Setup-arm64.exeని డౌన్‌లోడ్ చేసి రన్ చేయండి. ఇన్‌స్టాలర్ సైన్ చేయబడింది మరియు సెట్టింగ్‌లు, ట్రే స్టేటస్, చాట్ మరియు నోడ్ మోడ్‌లను కలిగి ఉంటుంది.
• macOS: OpenClaw యొక్క GitHub రిలీజ్‌ల నుండి OpenClaw .dmgని డౌన్‌లోడ్ చేయండి. dmgని ఇష్టపడండి, అయితే మీరు .zipని కూడా ఉపయోగించవచ్చు. ఇన్‌స్టాలేషన్ తర్వాత OpenClaw.appని తెరవండి. ఈ వెర్షన్‌లో macOS ఫైల్ లేకపోతే, macOS యాప్ పేజీని అనుసరించండి.

మొదటిసారి తెరిచినప్పుడు, మీరు OpenClawని ఈ కంప్యూటర్‌లో గేట్‌వేని సిద్ధం చేయనివ్వవచ్చు లేదా ఇప్పటికే ఉన్న రిమోట్ గేట్‌వేకి కనెక్ట్ చేయవచ్చు.

టెర్మినల్ ద్వారా ఇన్‌స్టాల్ చేయడం

macOS, Linux మరియు WSL2 కోసం, దీన్ని ఉపయోగించండి:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell కోసం, దీన్ని ఉపయోగించండి:

iwr -useb https://openclaw.ai/install.ps1 | iex

ఈ స్క్రిప్ట్ ప్రస్తుత సిస్టమ్‌ను గుర్తిస్తుంది, అవసరమైనప్పుడు Nodeని ఇన్‌స్టాల్ చేస్తుంది, OpenClawని ఇన్‌స్టాల్ చేస్తుంది, ఆపై ప్రారంభ ఆన్‌బోర్డింగ్ ప్రక్రియను ప్రారంభిస్తుంది. ఆన్‌బోర్డింగ్ ఫ్లో మొదటిసారి సెటప్ ద్వారా మీకు మార్గనిర్దేశం చేస్తుంది.

మీరు ఇంకా ఆన్‌బోర్డింగ్‌ను ప్రారంభించకూడదనుకుంటే, macOS, Linux మరియు WSL2లో దానికి బదులుగా దీన్ని ఉపయోగించండి:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windowsలో, అధికారిక -NoOnboard ఎంపికను ఉపయోగించండి:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

మీరు ఇప్పటికే Nodeని మీరే మేనేజ్ చేస్తుంటే, మీరు npm, pnpm లేదా bunని కూడా ఉపయోగించవచ్చు. npm 12 లేదా npm 11.16 మరియు అంతకంటే కొత్త వెర్షన్‌లతో, దీన్ని రన్ చేయండి:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 మరియు అంతకంటే పాత వెర్షన్‌ల కోసం, --allow-scripts=openclawని తొలగించండి. pnpm ఉపయోగిస్తున్నప్పుడు, --allow-build=openclawని జోడించండి. ఖచ్చితమైన తేడాల కోసం ఇన్‌స్టాలేషన్ పేజీని చూడండి.

ఇన్‌స్టాలేషన్ తర్వాత, ఈ మూడు కమాండ్‌లను వరుసగా రన్ చేయండి:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version వెర్షన్‌ను ప్రదర్శిస్తుంది, openclaw doctor సాధారణ ఎన్విరాన్‌మెంట్ సమస్యలను తనిఖీ చేస్తుంది, మరియు openclaw gateway status గేట్‌వే రన్ అవుతుందో లేదో చూపుతుంది. ఈ మూడు కమాండ్‌లు సాధారణ అవుట్‌పుట్‌ను ఇచ్చినప్పుడు మాత్రమే ప్రాథమిక ఇన్‌స్టాలేషన్ పూర్తవుతుంది.

టెర్మినల్ openclawని కనుగొనలేకపోతున్నామని నివేదిస్తే, npm గ్లోబల్ బిన్ డైరెక్టరీ సాధారణంగా PATH నుండి తప్పిపోయి ఉంటుంది. PATH అనేది టెర్మినల్ ప్రోగ్రామ్‌ల కోసం వెతికే స్థానాల జాబితా. node -v, npm prefix -g, మరియు echo "$PATH" అవుట్‌పుట్‌లను పోల్చి చూడండి, సంబంధిత బిన్ డైరెక్టరీని PATHకి జోడించండి, ఆపై టెర్మినల్‌ను మళ్లీ తెరవండి.

~/.openclaw ఇప్పటికే ప్రస్తుతం వాడుకలో ఉన్న కాన్ఫిగరేషన్‌ను కలిగి ఉంటే, డిఫాల్ట్ ఇన్‌స్టాలేషన్ స్క్రిప్ట్ ఆ డైరెక్టరీని ఉపయోగిస్తుంది. ఇప్పటికే ఉన్న కాన్ఫిగరేషన్‌ను మార్చకుండా ప్రత్యేక కాపీని ఇన్‌స్టాల్ చేయడానికి, నాన్-ఇంటరాక్టివ్ స్క్రిప్ట్‌ను రన్ చేసి కొత్త డైరెక్టరీని పేర్కొనండి:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard అనేది ఈ స్క్రిప్ట్ యొక్క డిఫాల్ట్ ప్రవర్తన. 2026-10-09న, ఈ కమాండ్ OpenClaw 2026.9.9ని ఇన్‌స్టాల్ చేసింది. ఇన్‌స్టాలేషన్ తర్వాత, డైరెక్టరీ యొక్క bin ఫోల్డర్ నుండి openclaw ఎగ్జిక్యూటబుల్‌ను రన్ చేయండి.

OmniProxy నుండి కనెక్షన్ విలువలను పొందడం

ముందుగా OmniProxy రన్ అవుతుందని నిర్ధారించుకోండి, ఆపై దాని మోడల్ జాబితాను తెరిచి ఈ క్రింది మూడు విలువలను సిద్ధం చేయండి:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl అనేది OpenClaw మోడల్ అభ్యర్థనలను పంపే చిరునామా, మరియు ఇది తప్పనిసరిగా /v1తో ముగియాలి. OmniProxyకి కనెక్ట్ చేస్తున్నప్పుడు, api కోసం openai-completionsని ఉపయోగించండి. మోడల్ నిజంగా /v1/responses ద్వారా పనిచేస్తేనే దాన్ని openai-responsesకి మార్చండి.

మోడల్ ID అనేది జాబితాలో మోడల్ యొక్క పూర్తి ఐడెంటిఫైయర్. స్లాష్‌లతో సహా చూపిన విధంగానే దాన్ని కాపీ చేయండి. ఈ క్రింది రెండు పేర్లు 2026-10-09 నాటికి ప్రొవైడర్ డాక్యుమెంటేషన్ నుండి కేవలం రిఫరెన్స్‌లు మాత్రమే; అవి జాబితాలో కనిపించకపోతే వాటిని ఉపయోగించవద్దు: claude-sonnet-5-5, gpt-6-luna.

గేట్‌వే కీని ధృవీకరించకపోయినా, apiKey తప్పనిసరిగా ఒక విలువను కలిగి ఉండాలి. మీరు ఈ కంప్యూటర్‌లో మాత్రమే ఉపయోగించే ప్లేస్‌హోల్డర్ స్ట్రింగ్‌ను ఉపయోగించవచ్చు. నిజమైన కీని రిపోజిటరీకి కమిట్ చేయవద్దు.

టూల్ కాన్ఫిగరేషన్‌ను నమోదు చేయడం

ప్రొవైడర్‌ను OpenClaw మోడల్ సర్వీస్‌ను కనుగొనడానికి ఉపయోగించే కనెక్షన్ సెట్టింగ్‌ల సెట్‌గా అర్థం చేసుకోవచ్చు. ఇక్కడ, ప్రొవైడర్ పేరు omniproxy.

టెర్మినల్‌లో ఈ క్రింది కమాండ్‌ను రన్ చేయండి, చిరునామా, కీ మరియు రెండు మోడల్ IDలను మీ స్వంత విలువలతో భర్తీ చేయండి:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

ఈ కమాండ్ ప్రొవైడర్ మరియు మోడల్ జాబితాను కాన్ఫిగరేషన్‌లోకి వ్రాస్తుంది. కమాండ్ విజయవంతమైన తర్వాత మీరు గేట్‌వేని రీస్టార్ట్ చేయనవసరం లేదు.

తర్వాత, డిఫాల్ట్ మోడల్‌ను పేర్కొనండి. మోడల్ రిఫరెన్స్ omniproxy/ మరియు దాని తర్వాత మోడల్ IDని కలిగి ఉంటుంది. IDలో ఇప్పటికే ఉన్న ప్రతి స్లాష్‌ను అలాగే ఉంచండి. మోడల్ జాబితాలోని ID క్రింద ఉన్న చిన్న పేరు కంటే పొడవుగా ఉంటే, జాబితా నుండి పూర్తి విలువను ఉపయోగించండి:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindow, మరియు maxTokens అన్నింటినీ వదిలివేయవచ్చు. అవి అందించబడనప్పుడు, టెక్స్ట్ మోడల్స్ డిఫాల్ట్‌లను ఉపయోగించి నిర్వహించబడతాయి.

మీరు అదే సెట్టింగ్‌లను నేరుగా కాన్ఫిగరేషన్ ఫైల్‌లోకి కూడా వ్రాయవచ్చు. ప్రధాన కాన్ఫిగరేషన్‌లో, ప్రొవైడర్ models.providers కింద ఉంటుంది. ప్రతి ఏజెంట్ కూడా తన స్వంత models.jsonని కలిగి ఉండవచ్చు; ఏజెంట్ అనేది టాస్క్‌లను స్వీకరించి మోడల్స్‌ని పిలిచే అసిస్టెంట్ ఇన్‌స్టాన్స్. ఫైల్ ~/.openclaw/agents/ కింద సంబంధిత ఏజెంట్ డైరెక్టరీలో agent/models.json వద్ద ఉంటుంది.

ఈ models.json ఖాళీగా లేని baseUrlని కలిగి ఉంటే, అది ప్రధాన కాన్ఫిగరేషన్‌లోని చిరునామాను ఓవర్‌రైడ్ చేస్తుంది.

ఇన్‌స్టాలేషన్‌ను తనిఖీ చేయండి

మూడు కమాండ్‌లు

• openclaw --version
• openclaw doctor
• gateway status

కాన్ఫిగరేషన్

models.providers

• baseUrl /v1తో ముగుస్తుంది
• apiని completionsకి సెట్ చేయండి
• కనీసం మోడల్ idని పేర్కొనండి

ఎంచుకోండి

provider/model

• ప్రాథమిక కోసం ఈ రిఫరెన్స్‌ని ఉపయోగించండి
• కీ కోసం ఎన్విరాన్‌మెంట్ వేరియబుల్‌ను ఇష్టపడండి
• గేట్‌వే జాబితాను నిజమైన మూలంగా ఉపయోగించండి

నిజమైన టాస్క్‌ను ధృవీకరించడం

సాధారణ ప్రాజెక్ట్ డైరెక్టరీకి cd చేసి, చాలా చిన్న సందేశాన్ని పంపండి. కమాండ్‌లోని మోడల్ రిఫరెన్స్‌ను మీ పూర్తి మోడల్ IDతో భర్తీ చేయండి:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local ఈ ఏజెంట్ టాస్క్‌ను స్థానికంగా రన్ చేస్తుంది, --model ఈ రన్ కోసం ఉపయోగించాల్సిన మోడల్‌ను పేర్కొంటుంది, మరియు --timeout 300 గరిష్ట నిరీక్షణ సమయాన్ని 300 సెకన్లకు సెట్ చేస్తుంది.

టెర్మినల్‌లో నిజమైన మోడల్ ప్రతిస్పందన కనిపించాలి. 2026-10-09న, OpenClaw 2026.9.9 ఈ కమాండ్‌ని ఉపయోగించి ప్రతిస్పందనను అందుకుంది. మొదటి కాల్‌కు ఒకటి లేదా రెండు నిమిషాలు పట్టవచ్చు.

అసలు లోపం Request timed out before a response was generated కనిపిస్తే, --timeoutని పెంచి అభ్యర్థనను మళ్లీ పంపండి. దీని అర్థం సాధారణంగా నిరీక్షణ సమయం సరిపోలేదని, చిరునామా తప్పు అని కాదు.

చిన్న ప్రతిస్పందన విజయవంతమైన తర్వాత, మీరు పేర్కొన్న లోకల్ ఫైల్‌ను చదవమని అడగండి. ఆపై OmniProxy యొక్క అభ్యర్థన రికార్డులను తెరిచి, రికార్డులో చూపిన మూలం మరియు మోడల్ IDని నిర్ధారించండి. వెర్షన్ కమాండ్ లేదా డాక్టర్ నుండి మాత్రమే అవుట్‌పుట్ రావడం అంటే మోడల్ కనెక్షన్ పూర్తిగా కాన్ఫిగర్ చేయబడిందని అర్థం కాదు.

ఇన్‌స్టాలేషన్

కమాండ్ స్పందిస్తుంది

• వెర్షన్ నంబర్ ప్రదర్శించబడుతుంది
• డాక్టర్ ఎటువంటి అడ్డంకులు లేవని నివేదిస్తుంది
• గేట్‌వే స్టేటస్ చదవగలిగేలా ఉంది

టాస్క్

ఇది ఒక చిన్న టాస్క్‌ను పూర్తి చేసింది

• ఉదాహరణకు, లోకల్ ఫైల్‌ను చదవండి
• ప్రతిస్పందన లోపం కాదు
• మోడల్ రిఫరెన్స్ సరైనది

లాగ్స్

గేట్‌వేలో కనిపిస్తుంది

• మూలం OpenClaw
• మోడల్ ID సరిపోలుతుంది
• కీ రిపోజిటరీకి జోడించబడలేదు

సాధారణ లోపాలు

• openclawని కనుగొనలేకపోతున్నాము: npm గ్లోబల్ బిన్ డైరెక్టరీని PATHకి జోడించి, ఆపై టెర్మినల్‌ను మళ్లీ తెరవండి. మీరు పేర్కొన్న డైరెక్టరీలో ఇన్‌స్టాల్ చేసి ఉంటే, ఆ డైరెక్టరీ యొక్క bin ఫోల్డర్ నుండి ఎగ్జిక్యూటబుల్‌ను రన్ చేయండి.
• node -v 24.16 కంటే తక్కువ ఉంది: మీరు పాత వెర్షన్‌ను ముందుగా అన్‌ఇన్‌స్టాల్ చేయనవసరం లేదు. ఇన్‌స్టాలేషన్ స్క్రిప్ట్ సిద్ధం చేసిన Node వెర్షన్‌ను తనిఖీ చేయండి, లేదా ఇన్‌స్టాలేషన్ పేజీలో వివరించిన విధంగా 24.16+ లేదా 26.1+ని ఉపయోగించండి. Node 26 సిఫార్సు చేయబడింది.
• మోడల్ కనిపించడం లేదు: మోడల్ తప్పనిసరిగా models.providers కింద ఉన్న models అర్రేలో చేర్చబడాలి మరియు కనీసం అదే idని కలిగి ఉండాలి. కేవలం agents.defaults.modelsని సెట్ చేయడం వల్ల కొత్త మోడల్ రిజిస్టర్ అవ్వదు.
• 400 ప్రతిస్పందన డెవలపర్ రోల్ గురించి పేర్కొంటుంది: చిరునామా హోస్ట్ api.openai.com కానప్పుడు, డిఫాల్ట్‌ను ఉంచండి మరియు supportsDeveloperRoleని trueకి సెట్ చేయవద్దు. ఇది trueకి సెట్ చేయబడినప్పటికీ, అది ఇప్పటికీ ఓవర్‌రైడ్ చేయబడుతుంది.
• ఇది త్వరగా టైమ్ అవుట్ అవుతుంది: చిరునామాను మార్చే ముందు --timeoutని 300 సెకన్ల కంటే ఎక్కువకు పెంచండి.
• gpt-6-lunaని ఎంచుకున్న తర్వాత టూల్ కాల్స్ విఫలమవుతాయి: ఇది Chat Completionsకి మద్దతు ఇస్తుంది; Chat Completionsలో ఫంక్షన్ కాలింగ్ reasoning_effort అనేది none అయినప్పుడు మాత్రమే మద్దతు ఇవ్వబడుతుంది. జాబితాలోని ID దీని కంటే భిన్నంగా ఉంటే, జాబితాలో చూపిన IDని ఉపయోగించండి.
• చిరునామాను చేరుకోలేము: OmniProxy రన్ అవుతుందని, baseUrl అనేది /v1తో ముగుస్తుందని, మరియు కాన్ఫిగరేషన్‌కు వ్రాసిన చిరునామా అందుబాటులో ఉందని నిర్ధారించుకోండి. ఇతర ప్రైవేట్-నెట్‌వర్క్ చిరునామాలను విడిగా అనుమతించాలి.
• కాన్ఫిగరేషన్ తర్వాత కూడా అభ్యర్థనలు మరొక చిరునామాకు వెళ్తున్నాయి: ఆ ఏజెంట్ యొక్క models.json భిన్నమైన baseUrlని కలిగి ఉందో లేదో తనిఖీ చేయండి.

అధికారిక రిఫరెన్స్‌లు

ఇన్‌స్టాలేషన్ దశల కోసం, OpenClaw install చూడండి. కస్టమ్ ప్రొవైడర్ కాన్ఫిగరేషన్ కోసం, Custom providers మరియు configuration fields చూడండి. ఉదాహరణలలో ఉపయోగించిన మోడల్ IDల కోసం, Claude model overview మరియు GPT-6 Lunaతో పోల్చి చూడండి.

మీ స్వంత OmniProxy కన్ఫిగరేషన్ నుండి విలువలతో ప్రతి ప్లేస్‌హోల్డర్‌ను మార్చండి. నిజమైన కీని ఎప్పుడూ ప్రచురించకండి.

సేవ్ చేయబడిన ఫలితం లేదా HTTP 200 మాత్రమే పూర్తి ఏజెంట్ అనుకూలతను నిరూపించదు. OmniProxy కాల్ రికార్డ్‌లో మూలం మరియు మోడల్‌ను తనిఖీ చేయండి.

అధికారిక మూలాలు · OpenClaw ↗