Kusakinisha OpenClaw na Kusanidi OmniProxy

OpenClaw ni msaidizi wa AI aliyesakinishwa kwenye kompyuta yako mwenyewe. Unaweza kuzungumza naye moja kwa moja kupitia Telegram, Discord, WhatsApp, au Feishu bila kuhitaji kuweka dirisha lingine la gumzo wazi. Mazungumzo na rekodi hubaki kwenye kompyuta hii, na inaweza kuendelea kutekeleza hatua zinazofuata ndani ya mfumo.

Kabla Hujaanza

OpenClaw inahitaji Node 24.16 au toleo jipya zaidi. Unaweza pia kutumia Node 26.1 au toleo jipya zaidi, huku Node 26 ikipendekezwa. Node hutoa mazingira ya utekelezaji yanayohitajika na OpenClaw.

Inaweza kusakinishwa kwenye macOS, Linux, na Windows. Ikiwa kompyuta haina toleo linalofaa la Node, hati ya usakinishaji itatayarisha moja kiotomatiki: Node 26 kwenye macOS na Node 24 LTS kwenye Linux. pnpm inahitajika tu wakati wa kujenga OpenClaw kutoka kwa chanzo.

Ikiwa toleo la zamani la Node tayari limesakinishwa, huhitaji kuliondoa kwanza. Wakati wa majaribio mnamo 2026-10-09, toleo la Node kwenye kompyuta hii lilikuwa 24.2.0, chini ya 24.16 inayohitajika, na hati ya usakinishaji isiyoingiliana ilitayarisha Node 24.21.0 kiotomatiki.

Je, unataka dirisha

Mwandamani wa mezani

• Tumia kisakinishi cha Hub kwenye Windows
• Tumia GitHub DMG kwenye macOS
• Gateway ya ndani inaweza kusakinishwa wakati wa usanidi wa awali

Inapendekezwa rasmi

Hati ya usakinishaji

• macOS Linux WSL2
• Tumia PowerShell kwenye Windows
• Unaweza kuongeza --no-onboard

Node tayari imesakinishwa

Kidhibiti cha vifurushi

• npm pnpm au bun
• Kisha endesha onboard
• Angalia ukurasa wa usakinishaji kwa toleo la Node

Sakinisha na Uzindue kwa Mara ya Kwanza

Unaweza kusakinisha mwandamani wa mezani na dirisha la picha, au kusakinisha moja kwa moja kupitia terminal. Gateway ni huduma ya ndani inayohusika na kupokea ujumbe, kuita miundo, na kurejesha matokeo. Unaweza kuisanidi unapofungua mwandamani wa mezani kwa mara ya kwanza.

Ikiwa Unataka Dirisha

• Windows: Pakua na uendeshe OpenClawCompanion-Setup-x64.exe au OpenClawCompanion-Setup-arm64.exe. Kisakinishi kimesainiwa na kinajumuisha mipangilio, hali ya trei, gumzo, na njia za node.
• macOS: Pakua OpenClaw .dmg kutoka kwa matoleo ya GitHub ya OpenClaw. Pendelea dmg, ingawa unaweza pia kutumia .zip. Fungua OpenClaw.app baada ya kusakinisha. Ikiwa toleo hili halijumuishi faili ya macOS, fuata ukurasa wa programu ya macOS.

Unapoifungua kwa mara ya kwanza, unaweza kuruhusu OpenClaw itayarishe Gateway kwenye kompyuta hii au kuunganisha kwenye Gateway ya mbali iliyopo.

Sakinisha Kupitia Terminal

Kwa macOS, Linux, na WSL2, tumia:

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

Kwa Windows PowerShell, tumia:

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

Hati hugundua mfumo wa sasa, husakinisha Node inapohitajika, husakinisha OpenClaw, na kisha kuanza mchakato wa awali wa kujiunga. Mtiririko wa kujiunga hukuongoza kupitia usanidi wa mara ya kwanza.

Ikiwa hutaki kuanza kujiunga bado, tumia yafuatayo badala yake kwenye macOS, Linux, na WSL2:

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

Kwenye Windows, tumia chaguo rasmi la -NoOnboard:

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

Ikiwa tayari unajisimamia Node mwenyewe, unaweza pia kutumia npm, pnpm, au bun. Kwa npm 12 au npm 11.16 na baadaye, endesha:

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

Kwa npm 11.15 na mapema, ondoa --allow-scripts=openclaw. Unapotumia pnpm, ongeza --allow-build=openclaw. Rejelea ukurasa wa usakinishaji kwa tofauti kamili.

Baada ya kusakinisha, endesha amri hizi tatu kwa mpangilio:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version huonyesha toleo, openclaw doctor hukagua masuala ya kawaida ya mazingira, na openclaw gateway status huonyesha ikiwa Gateway inafanya kazi. Usakinishaji wa msingi umekamilika tu wakati amri zote tatu zinatoa matokeo ya kawaida.

Ikiwa terminal inaripoti kuwa haiwezi kupata openclaw, saraka ya bin ya kimataifa ya npm kwa kawaida haipo kwenye PATH. PATH ni orodha ya maeneo ambapo terminal hutafuta programu. Linganisha matokeo ya node -v, npm prefix -g, na echo "$PATH", ongeza saraka husika ya bin kwenye PATH, na kisha ufungue tena terminal.

Ikiwa ~/.openclaw tayari ina usanidi unaotumika sasa, hati ya usakinishaji chaguo-msingi itatumia saraka hiyo. Ili kusakinisha nakala tofauti bila kubadilisha usanidi uliopo, endesha hati isiyoingiliana na ubainishe saraka mpya:

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

--no-onboard ni tabia chaguo-msingi ya hati hii. Mnamo 2026-10-09, amri hii ilisakinisha OpenClaw 2026.9.9. Baada ya kusakinisha, endesha openclaw inayoweza kutekelezwa kutoka kwa folda ya bin ya saraka hiyo.

Pata Thamani za Muunganisho kutoka OmniProxy

Kwanza thibitisha kuwa OmniProxy inafanya kazi, kisha ufungue orodha yake ya miundo na utayarishe thamani hizi tatu:

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 ni anwani ambayo OpenClaw hutuma maombi ya miundo, na lazima iishe na /v1. Unapounganisha kwenye OmniProxy, tumia openai-completions kwa api. Ibadilishe kuwa openai-responses tu ikiwa muundo unafanya kazi kupitia /v1/responses.

Kitambulisho cha Muundo (Model ID) ni kitambulisho kamili cha muundo kwenye orodha. Nakili kama inavyoonyeshwa, ikijumuisha mikwaju yoyote. Majina mawili yafuatayo ni marejeleo tu kutoka kwa nyaraka za mtoa huduma kufikia 2026-10-09; usiyatumie ikiwa hayaonekani kwenye orodha: claude-sonnet-5-5, gpt-6-luna.

Hata kama gateway haithibitishi ufunguo, apiKey lazima bado iwe na thamani. Unaweza kutumia kamba ya kishika nafasi inayotumiwa kwenye kompyuta hii pekee. Usikabidhi ufunguo halisi kwenye hazina.

Ingiza Usanidi wa Zana

Mtoa huduma (Provider) anaweza kueleweka kama seti ya mipangilio ya muunganisho ambayo OpenClaw hutumia kupata huduma ya muundo. Hapa, Mtoa huduma anaitwa omniproxy.

Endesha amri ifuatayo kwenye terminal, ukibadilisha anwani, ufunguo, na vitambulisho viwili vya muundo na thamani zako mwenyewe:

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

Amri hii huandika Mtoa huduma na orodha ya miundo kwenye usanidi. Huhitaji kuanzisha upya Gateway baada ya amri kufanikiwa.

Kisha, bainisha muundo chaguo-msingi. Marejeleo ya muundo yanajumuisha omniproxy/ ikifuatiwa na kitambulisho cha muundo. Hifadhi kila mkwaju uliopo kwenye kitambulisho. Ikiwa kitambulisho kwenye orodha ya miundo ni kirefu kuliko jina fupi hapa chini, tumia thamani kamili kutoka kwenye orodha:

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

reasoning, input, cost, contextWindow, na maxTokens zote zinaweza kuachwa. Wakati hazijatolewa, miundo ya maandishi hushughulikiwa kwa kutumia chaguo-msingi.

Unaweza pia kuandika mipangilio hiyo hiyo moja kwa moja kwenye faili ya usanidi. Katika usanidi mkuu, Mtoa huduma anapatikana chini ya models.providers. Kila wakala anaweza pia kuwa na models.json yake; wakala ni mfano wa msaidizi anayepokea kazi na kuita miundo. Faili iko kwenye agent/models.json ndani ya saraka husika ya wakala chini ya ~/.openclaw/agents/.

Ikiwa models.json hii ina baseUrl isiyo tupu, inabatilisha anwani katika usanidi mkuu.

Kagua usakinishaji

Amri tatu

• openclaw --version
• openclaw doctor
• gateway status

Usanidi

models.providers

• baseUrl inaishia na /v1
• Weka api kuwa completions
• Bainisha angalau kitambulisho cha muundo

Chagua

provider/model

• Tumia marejeleo haya kwa msingi
• Pendelea kigeu cha mazingira kwa ufunguo
• Tumia orodha ya gateway kama chanzo cha ukweli

Thibitisha Kazi Halisi

Ingiza saraka ya kawaida ya mradi na utume ujumbe mfupi sana. Badilisha marejeleo ya muundo kwenye amri na Kitambulisho chako kamili cha Muundo:

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

--local huendesha kazi hii ya wakala ndani ya mfumo, --model hubainisha muundo wa kutumia kwa uendeshaji huu, na --timeout 300 huweka muda wa juu wa kusubiri kuwa sekunde 300.

Jibu halisi la muundo lazima lionekane kwenye terminal. Mnamo 2026-10-09, OpenClaw 2026.9.9 ilipokea jibu kwa kutumia amri hii. Simu ya kwanza inaweza kuchukua dakika moja au mbili.

Ikiwa kosa la asili Request timed out before a response was generated litaonekana, ongeza --timeout na utume ombi tena. Hii kwa kawaida inamaanisha muda wa kusubiri haukutosha na haimaanishi lazima kuwa anwani si sahihi.

Baada ya jibu fupi kufanikiwa, mwambie asome faili ya ndani unayobainisha. Kisha fungua rekodi za ombi za OmniProxy na uthibitishe chanzo na kitambulisho cha muundo kilichoonyeshwa kwenye rekodi. Matokeo kutoka kwa amri ya toleo au daktari pekee haimaanishi kuwa muunganisho wa muundo umesanidiwa kikamilifu.

Usakinishaji

Amri inajibu

• Nambari ya toleo inaonyeshwa
• amri ya doctor inaripoti hakuna vizuizi
• Hali ya Gateway inasomeka

Kazi

Imekamilisha kazi ndogo

• Kwa mfano, soma faili ya ndani
• Jibu si kosa
• Marejeleo ya muundo ni sahihi

Kumbukumbu

Inaonekana kwenye gateway

• Chanzo ni OpenClaw
• Kitambulisho cha muundo kinalingana
• Ufunguo haukuongezwa kwenye hazina

Makosa ya Kawaida

• Haiwezi kupata openclaw: Ongeza saraka ya bin ya kimataifa ya npm kwenye PATH, kisha ufungue tena terminal. Ikiwa umesakinisha kwenye saraka iliyobainishwa, endesha inayoweza kutekelezwa kutoka kwa folda ya bin ya saraka hiyo.
• node -v iko chini ya 24.16: Huhitaji kuondoa toleo la zamani kwanza. Angalia toleo la Node lililotayarishwa na hati ya usakinishaji, au tumia 24.16+ au 26.1+ kama ilivyoelezwa kwenye ukurasa wa usakinishaji. Node 26 inapendekezwa.
• Muundo hauonekani: Muundo lazima ujumuishwe kwenye safu ya models chini ya models.providers na lazima angalau uwe na id sawa. Kuweka agents.defaults.models pekee hakusajili muundo mpya peke yake.
• Jibu la 400 linataja jukumu la msanidi: Wakati mwenyeji wa anwani si api.openai.com, weka chaguo-msingi na usiweke supportsDeveloperRole kuwa kweli. Hata ikiwa imewekwa kuwa kweli, bado itabatilishwa.
• Muda wake unaisha haraka: Ongeza --timeout hadi zaidi ya sekunde 300 kabla ya kubadilisha anwani.
• Miito ya zana inashindwa baada ya kuchagua gpt-6-luna: Inasaidia Chat Completions; utekelezaji wa kazi katika Chat Completions unasaidiwa tu wakati reasoning_effort ni none. Ikiwa kitambulisho kwenye orodha ni tofauti na hiki, tumia kitambulisho kilichoonyeshwa kwenye orodha.
• Anwani haiwezi kufikiwa: Thibitisha kuwa OmniProxy inafanya kazi, kwamba baseUrl inaishia na /v1, na kwamba anwani iliyoandikwa kwenye usanidi inafikika. Anwani nyingine za mtandao wa kibinafsi lazima ziruhusiwe kando.
• Maombi bado yanaenda kwenye anwani nyingine baada ya usanidi: Angalia ikiwa models.json ya wakala huyo ina baseUrl tofauti.

Marejeleo Rasmi

Kwa hatua za usakinishaji, angalia OpenClaw install. Kwa usanidi wa Mtoa huduma maalum, angalia Custom providers na configuration fields. Kwa vitambulisho vya muundo vinavyotumiwa katika mifano, linganisha dhidi ya Claude model overview na GPT-6 Luna.

Badilisha kila nafasi yenye thamani kutoka kwenye usanidi wako wa OmniProxy. Usitangaze funguo halisi.

Matokeo yaliyohifadhiwa au HTTP 200 pekee hayathibitishi utangamano kamili wa Agent. Angalia chanzo na mfano katika rekodi ya maombi ya OmniProxy.

Vyanzo rasmi · OpenClaw ↗