OpenClawን መጫን እና OmniProxyን ማዋቀር

OpenClaw በራስዎ ኮምፒውተር ላይ የሚጫን የኤአይ (AI) ረዳት ነው። ሌላ የውይይት መስኮት ሳይከፍቱ በቀጥታ በቴሌግራም፣ በዲስኮርድ፣ በዋትስአፕ ወይም በፌይሹ (Feishu) አማካኝነት ማውራት ይችላሉ። ውይይቶች እና መዝገቦች በዚህ ኮምፒውተር ላይ ይቀራሉ፣ እና ቀጣይ እርምጃዎችን በአካባቢው (locally) መፈጸሙን መቀጠል ይችላል።

ከመጀመርዎ በፊት

OpenClaw Node 24.16 ወይም ከዚያ በላይ ይፈልጋል። እንዲሁም Node 26.1 ወይም ከዚያ በላይ መጠቀም ይችላሉ፣ Node 26 ይመከራል። Node ለOpenClaw የሚያስፈልገውን የሩጫ አካባቢ (runtime environment) ያቀርባል።

በ macOS፣ Linux እና Windows ላይ ሊጫን ይችላል። ኮምፒውተሩ ተስማሚ የNode ስሪት ከሌለው፣ የመጫኛ ስክሪፕቱ በራስ-ሰር ያዘጋጃል፡ በ macOS ላይ Node 26 እና በ Linux ላይ Node 24 LTS። pnpm የሚያስፈልገው OpenClawን ከምንጭ ኮድ (source) ሲገነቡ ብቻ ነው።

ቀድሞ የተጫነ የNode ስሪት ካለ፣ መጀመሪያ ማራገፍ አያስፈልግም። በ2026-10-09 በተደረገው ሙከራ፣ በዚህ ኮምፒውተር ላይ የነበረው የስርዓት Node ስሪት 24.2.0 ነበር፣ ይህም ከሚፈለገው 24.16 በታች ነው፣ እና በይነተገናኝ ያልሆነው የመጫኛ ስክሪፕት Node 24.21.0ን በራስ-ሰር አዘጋጅቷል።

መስኮት ይፈልጋሉ

የዴስክቶፕ አጋዥ

• በዊንዶውስ ላይ የHub መጫኛን ይጠቀሙ
• በ macOS ላይ የGitHub DMG ይጠቀሙ
• የአካባቢው Gateway በመጀመሪያ ማዋቀር ወቅት ሊጫን ይችላል

በይፋ የሚመከር

የመጫኛ ስክሪፕት

• macOS Linux WSL2
• በዊንዶውስ ላይ PowerShell ይጠቀሙ
• --no-onboard ማከል ይችላሉ

Node ቀድሞ ተጭኗል

የጥቅል አስተዳዳሪ (Package manager)

• npm pnpm ወይም bun
• ከዚያ onboard ያሂዱ
• ለNode ስሪት የመጫኛ ገጹን ይመልከቱ

ለመጀመሪያ ጊዜ መጫን እና ማስጀመር

የዴስክቶፕ አጋዡን በግራፊክ መስኮት መጫን ወይም በቀጥታ በተርሚናል በኩል መጫን ይችላሉ። Gateway መልዕክቶችን የመቀበል፣ ሞዴሎችን የመጥራት እና ውጤቶችን የመመለስ ኃላፊነት ያለው የአካባቢ አገልግሎት ነው። የዴስክቶፕ አጋዡን ለመጀመሪያ ጊዜ ሲከፍቱ ማዋቀር ይችላሉ።

መስኮት ከፈለጉ

• Windows: ያውርዱ እና ያሂዱ OpenClawCompanion-Setup-x64.exe ወይም OpenClawCompanion-Setup-arm64.exe። መጫኛው የተፈረመ ሲሆን ቅንብሮችን፣ የትሪ ሁኔታን፣ ውይይትን እና የኖድ ሁነታዎችን ያካትታል።
• macOS: ያውርዱ OpenClaw .dmg ከOpenClaw የGitHub ልቀቶች። dmgን ይምረጡ፣ ምንም እንኳን መጠቀም ቢችሉም .zip። ከተጫነ በኋላ OpenClaw.appን ይክፈቱ። ይህ ስሪት የ macOS ፋይል ካላካተተ፣ የ macOS መተግበሪያ ገጽን ይከተሉ።

ለመጀመሪያ ጊዜ ሲከፍቱት፣ OpenClaw በኮምፒውተርዎ ላይ Gateway እንዲያዘጋጅ ወይም ካለ ነባር የርቀት Gateway ጋር እንዲገናኝ መፍቀድ ይችላሉ።

በተርሚናል በኩል መጫን

ለ macOS፣ Linux እና WSL2፣ ይጠቀሙ:

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

ለ Windows PowerShell፣ ይጠቀሙ:

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

ስክሪፕቱ የአሁኑን ስርዓት ይለያል፣ ሲያስፈልግ Node ይጭናል፣ OpenClawን ይጭናል፣ ከዚያም የመጀመሪያውን የኦንቦርዲንግ (onboarding) ሂደት ይጀምራል። የኦንቦርዲንግ ፍሰቱ በመጀመሪያ ጊዜ ማዋቀር ይመራዎታል።

ኦንቦርዲንግ ገና መጀመር ካልፈለጉ፣ በ macOS፣ Linux እና WSL2 ላይ የሚከተለውን ይጠቀሙ:

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

በዊንዶውስ ላይ፣ ኦፊሴላዊውን ይጠቀሙ -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 Gateway እየሰራ መሆኑን ያሳያል። መሰረታዊ ጭነቱ የተጠናቀቀው ሶስቱም ትዕዛዞች መደበኛ ውጤት ሲሰጡ ብቻ ነው።

ተርሚናሉ ማግኘት እንደማይችል ቢዘግብ openclaw፣ የ npm ግሎባል ቢን (bin) ማውጫ ብዙውን ጊዜ ከ 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ን ጭኗል። ከተጫነ በኋላ፣ ያሂዱ openclaw ተፈጻሚ ፋይል (executable) ከማውጫው bin አቃፊ።

ከ 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 ጋር ሲገናኙ፣ ይጠቀሙ openai-completions ለ api። ወደ ይለውጡት openai-responses ሞዴሉ በእርግጥ በኩል የሚሰራ ከሆነ ብቻ /v1/responses።

የሞዴል መታወቂያ (Model ID) በዝርዝሩ ውስጥ ያለው የሞዴል ሙሉ መለያ ነው። ልክ እንደታየው በትክክል ይቅዱት፣ ማንኛውንም ሰያፍ መስመሮች (slashes) ጨምሮ። የሚከተሉት ሁለት ስሞች ከ2026-10-09 ጀምሮ ከአቅራቢ ሰነዶች ማጣቀሻዎች ብቻ ናቸው፤ በዝርዝሩ ውስጥ ካልታዩ አይጠቀሙባቸው: claude-sonnet-5-5, gpt-6-luna።

ጌትዌይ ቁልፉን ባያረጋግጥም፣ apiKey አሁንም እሴት መያዝ አለበት። በዚህ ኮምፒውተር ላይ ብቻ ጥቅም ላይ የሚውል ቦታ ያዥ (placeholder) ሕብረቁምፊ መጠቀም ይችላሉ። እውነተኛ ቁልፍ ወደ ማከማቻ (repository) አይላኩ።

የመሳሪያ ውቅር ያስገቡ

አቅራቢ (Provider) እንደ OpenClaw ሞዴል አገልግሎትን ለማግኘት የሚጠቀምባቸው የግንኙነት ቅንብሮች ስብስብ ተደርጎ ሊወሰድ ይችላል። እዚህ፣ አቅራቢው ተሰይሟል omniproxy።

በተርሚናል ውስጥ የሚከተለውን ትዕዛዝ ያሂዱ፣ አድራሻውን፣ ቁልፉን እና ሁለቱን የሞዴል መታወቂያዎች በራስዎ እሴቶች በመተካት:

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

ይህ ትዕዛዝ አቅራቢውን እና የሞዴል ዝርዝሩን ወደ ውቅሩ ይጽፋል። ትዕዛዙ ከተሳካ በኋላ Gatewayን እንደገና ማስጀመር አያስፈልግዎትም።

በመቀጠል፣ ነባሪውን ሞዴል ይግለጹ። የሞዴል ማጣቀሻው ያካትታል omniproxy/ በሞዴል መታወቂያው ይከተላል። በመታወቂያው ውስጥ ቀድሞውኑ ያሉትን እያንዳንዱን ሰያፍ መስመር ይጠብቁ። በሞዴል ዝርዝሩ ውስጥ ያለው መታወቂያ ከታች ካለው አጭር ስም የበለጠ ከሆነ፣ ከዝርዝሩ ውስጥ ሙሉውን እሴት ይጠቀሙ:

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

reasoning, input, cost, contextWindow፣ እና maxTokens ሁሉም ሊዘለሉ ይችላሉ። ካልቀረቡ፣ የጽሑፍ ሞዴሎች ነባሪዎችን በመጠቀም ይያዛሉ።

ተመሳሳይ ቅንብሮችን በቀጥታ ወደ ውቅር ፋይሉ መጻፍ ይችላሉ። በዋናው ውቅር ውስጥ፣ አቅራቢው የሚገኘው በ models.providers። እያንዳንዱ ወኪል (agent) የራሱ ሊኖረው ይችላል models.json፤ ወኪል ስራዎችን የሚቀበል እና ሞዴሎችን የሚጠራ ረዳት ምሳሌ ነው። ፋይሉ የሚገኘው በ agent/models.json በተጓዳኝ ወኪል ማውጫ ውስጥ በ ~/.openclaw/agents/።

ይህ ከሆነ models.json ባዶ ያልሆነ ይይዛል baseUrl፣ በዋናው ውቅር ውስጥ ያለውን አድራሻ ይተካል።

ጭነትን ያረጋግጡ

ሶስት ትዕዛዞች

• openclaw --version
• openclaw doctor
• gateway status

ውቅር

models.providers

• baseUrl በ /v1 ያበቃል
• apiን ወደ completions ያዘጋጁ
• ቢያንስ የሞዴል መታወቂያውን ይግለጹ

ይምረጡ

provider/model

• ለዋናው ይህንን ማጣቀሻ ይጠቀሙ
• ለቁልፉ የአካባቢ ተለዋዋጭ (environment variable) ይምረጡ
• የጌትዌይ ዝርዝሩን እንደ እውነት ምንጭ ይጠቀሙ

እውነተኛ ስራን ያረጋግጡ

መደበኛ የፕሮጀክት ማውጫ ያስገቡ እና በጣም አጭር መልእክት ይላኩ። በትዕዛዙ ውስጥ ያለውን የሞዴል ማጣቀሻ በሙሉ የሞዴል መታወቂያዎ ይተኩ:

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 ጥያቄ መዝገቦችን ይክፈቱ እና በመዝገቡ ውስጥ የሚታየውን ምንጭ እና የሞዴል መታወቂያ ያረጋግጡ። ከስሪት ትዕዛዝ ወይም ከዶክተር ብቻ የሚመጣ ውጤት የሞዴል ግንኙነቱ ሙሉ በሙሉ መዋቀሩን አያመለክትም።

ጭነት

ትዕዛዙ ምላሽ ይሰጣል

• የስሪት ቁጥሩ ይታያል
• ዶክተር ምንም ማገጃዎች አይዘግብም
• የጌትዌይ ሁኔታ ሊነበብ የሚችል ነው

ስራ

አንድ ትንሽ ስራ አጠናቋል

• ለምሳሌ፣ የአካባቢ ፋይል ያንብቡ
• ምላሹ ስህተት አይደለም
• የሞዴል ማጣቀሻው ትክክል ነው

ምዝግብ ማስታወሻዎች (Logs)

በጌትዌይ ውስጥ ይታያል

• ምንጩ OpenClaw ነው
• የሞዴል መታወቂያ ይዛመዳል
• ቁልፉ ወደ ማከማቻው አልታከለም

የተለመዱ ስህተቶች

• ማግኘት አልተቻለም openclaw: የ npm ግሎባል ቢን ማውጫን ወደ PATH ያክሉ፣ ከዚያ ተርሚናሉን እንደገና ይክፈቱ። ወደተገለጸ ማውጫ ከጫኑ፣ ተፈጻሚውን ፋይል ከዚያ ማውጫ ያሂዱ bin አቃፊ።
• node -v ከ 24.16 በታች ነው፡ መጀመሪያ የድሮውን ስሪት ማራገፍ አያስፈልግዎትም። በመጫኛ ስክሪፕቱ የተዘጋጀውን የNode ስሪት ያረጋግጡ፣ ወይም በመጫኛ ገጹ ላይ እንደተገለጸው 24.16+ ወይም 26.1+ ይጠቀሙ። Node 26 ይመከራል።
• ሞዴሉ አይታይም፡ ሞዴሉ በ ውስጥ መካተት አለበት models ድርድር (array) በ models.providers እና ቢያንስ ተመሳሳይ ሊኖረው ይገባል id። ብቻ በማዘጋጀት ላይ agents.defaults.models አዲስ ሞዴል በራሱ አይመዘግብም።
• የ 400 ምላሽ ስለ ገንቢ ሚና ይጠቅሳል፡ የአድራሻ አስተናጋጁ (host) ካልሆነ api.openai.com፣ ነባሪውን ያቆዩ እና አያዘጋጁ supportsDeveloperRole ወደ እውነት (true)። ወደ እውነት ቢዘጋጅም፣ አሁንም ይተካል።
• በፍጥነት ጊዜው ያልቃል (times out)፡ ይጨምሩ --timeout አድራሻውን ከመቀየርዎ በፊት ከ 300 ሰከንድ በላይ።
• መምረጥ ከተመረጠ በኋላ የመሳሪያ ጥሪዎች ይወድቃሉ gpt-6-luna: የውይይት ማጠናቀቂያዎችን (Chat Completions) ይደግፋል፤ በውይይት ማጠናቀቂያዎች ውስጥ የተግባር ጥሪ የሚደገፈው ብቻ ነው reasoning_effort ነው none። በዝርዝሩ ውስጥ ያለው መታወቂያ ከዚህ የተለየ ከሆነ፣ በዝርዝሩ ውስጥ የሚታየውን መታወቂያ ይጠቀሙ።
• አድራሻው ሊደረስበት አልቻለም፡ OmniProxy እየሰራ መሆኑን ያረጋግጡ፣ ያ baseUrl በ ያበቃል /v1፣ እና ወደ ውቅሩ የተጻፈው አድራሻ ተደራሽ መሆኑን ያረጋግጡ። ሌሎች የግል-አውታረ መረብ አድራሻዎች ለየብቻ መፈቀድ አለባቸው።
• ጥያቄዎች ከተዋቀሩ በኋላ አሁንም ወደ ሌላ አድራሻ ይሄዳሉ፡ ያ የወኪል መሆኑን ያረጋግጡ models.json የተለየ ይይዛል baseUrl.

ኦፊሴላዊ ማጣቀሻዎች

ለመጫኛ ደረጃዎች፣ OpenClaw install ይመልከቱ። ለብጁ አቅራቢ ውቅር፣ Custom providers ይመልከቱ እና configuration fields። በምሳሌዎቹ ውስጥ ጥቅም ላይ የዋሉ የሞዴል መታወቂያዎች፣ ከ Claude model overview ጋር ያወዳድሩ እና GPT-6 Luna.

እያንዳንዱን የቦታ ያዥ (placeholder) በራስዎ የ OmniProxy ውቅር እሴቶች ይተኩ። እውነተኛ ቁልፍን በጭራሽ አያትሙ።

የተቀመጠ ውጤት ወይም HTTP 200 ብቻውን ሙሉ የAgent ተኳኋኝነትን አያረጋግጥም። በ OmniProxy የጥያቄ መዝገብ ውስጥ ምንጩን እና ሞዴሉን ያረጋግጡ።

ኦፊሴላዊ ምንጮች · OpenClaw ↗