Installazzjoni ta’ OpenClaw u konfigurazzjoni ta’ OmniProxy

OpenClaw huwa assistent tal-AI installat fuq il-kompjuter tiegħek. Tista’ tkellmu direttament minn Telegram, Discord, WhatsApp jew Feishu mingħajr ma jkollok għalfejn iżżomm tieqa oħra taċ-chat miftuħa; il-konverżazzjonijiet u r-rekords jibqgħu fuq dan il-kompjuter, u jista’ jkompli jwettaq il-passi li jmiss lokalment.

Tħejjija qabel l-installazzjoni

OpenClaw jeħtieġ Node 24.16 jew verżjoni aktar ġdida, u tista’ tuża wkoll Node 26.1 jew verżjoni aktar ġdida. Huwa rrakkomandat li tuża Node 26. Node huwa l-ambjent bażiku meħtieġ biex jitħaddem OpenClaw.

Jista’ jiġi installat fuq macOS, Linux u Windows. Jekk il-kompjuter ma jkollux verżjoni xierqa ta’ Node, l-iskript tal-installazzjoni jippreparaha awtomatikament: Node 26 fuq macOS u Node 24 LTS fuq Linux. pnpm huwa meħtieġ biss meta tibni OpenClaw mill-kodiċi sors.

Jekk il-kompjuter diġà għandu verżjoni eqdem ta’ Node, m’hemmx għalfejn tneħħiha minnufih. Fit-test tal-2026-10-09, il-verżjoni tas-sistema ta’ Node fuq dan il-kompjuter kienet 24.2.0, inqas mill-verżjoni meħtieġa 24.16, u l-iskript tal-installazzjoni mhux interattiv ħejja Node 24.21.0 awtomatikament.

Trid tieqa

Assistent tad-desktop

Fuq Windows uża l-pakkett tal-installazzjoni ta' Hub
Fuq macOS uża d-DMG minn GitHub
Fl-ewwel tnedija tista' tinstalla Gateway lokali

Rakkomandat uffiċjalment

Skript tal-installazzjoni

macOS Linux WSL2
Fuq Windows uża PowerShell
Tista' żżid --no-onboard

Diġà għandek Node

Maniġer tal-pakketti

npm pnpm jew bun
Imbagħad ħaddem onboard
Ara l-paġna tal-installazzjoni għall-verżjoni ta' Node

Jekk trid tieqa, niżżel il-programm anċillari tad-desktop. Jekk trid tużah biss mit-terminal, ħaddem l-iskript uffiċjali tal-installazzjoni.

Installazzjoni u l-ewwel tħaddim

Tista’ tinstalla l-programm anċillari tad-desktop b’tieqa, jew tinstalla direttament mit-terminal. Gateway huwa s-servizz lokali li jirċievi l-messaġġi, isejjaħ il-mudell u jibgħat lura r-riżultati. Tista’ tippreparah meta tiftaħ il-programm anċillari tad-desktop għall-ewwel darba.

Jekk trid tieqa

Windows: niżżel u ħaddem OpenClawCompanion-Setup-x64.exe jew OpenClawCompanion-Setup-arm64.exe. Il-pakkett tal-installazzjoni huwa ffirmat u jinkludi settings, tray status, chat u node mode.
macOS: niżżel il-fajl .dmg ta’ OpenClaw mill-GitHub releases ta’ OpenClaw. Preferibbilment uża d-dmg, iżda tista’ tuża wkoll .zip. Wara l-installazzjoni, iftaħ OpenClaw.app. Jekk din il-verżjoni ma jkollhiex fajl għal macOS, segwi l-paġna tal-app għal macOS.

Meta tiftaħ għall-ewwel darba, tista’ tħalli lil OpenClaw jipprepara Gateway fuq dan il-kompjuter, jew tikkonnettja ma’ Gateway remot li diġà jeżisti.

Installazzjoni mit-terminal

Fuq macOS, Linux u WSL2 uża:

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

Fuq Windows PowerShell uża:

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

L-iskript jagħraf is-sistema attwali, jinstalla Node meta jkun meħtieġ, imbagħad jinstalla OpenClaw u jibda l-gwida inizjali. Il-gwida tgħinek tlesti l-ewwel konfigurazzjoni.

Jekk għalissa ma tridx tidħol fil-gwida, fuq macOS, Linux u WSL2 uża minflok:

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

Fuq Windows uża l-għażla uffiċjali -NoOnboard:

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

Jekk diġà timmaniġġja Node int stess, tista’ tuża wkoll npm, pnpm jew bun. Għal npm 12 u npm 11.16 jew aktar ġdid, ħaddem:

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

Għal npm 11.15 jew verżjoni eqdem, neħħi --allow-scripts=openclaw. Meta tuża pnpm, żid --allow-build=openclaw. Għad-differenzi eżatti, irreferi għall-paġna tal-installazzjoni.

Wara li titlesta l-installazzjoni, ħaddem dawn it-tliet kmandi wieħed wara l-ieħor:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version juri l-verżjoni, openclaw doctor jiċċekkja problemi komuni tal-ambjent, u openclaw gateway status juri jekk Gateway huwiex qed jaħdem. L-installazzjoni bażika titqies kompluta biss jekk it-tliet kmandi kollha jagħtu output normali.

Jekk it-terminal jgħid li ma jistax isib openclaw, normalment id-direttorju globali bin ta’ npm ma jkunx miżjud ma’ PATH. PATH hija l-lista ta’ postijiet fejn it-terminal ifittex il-programmi. Tista’ tqabbel ir-riżultati ta’ node -v, npm prefix -g u echo "$PATH", iżżid id-direttorju bin korrispondenti ma’ PATH, u mbagħad terġa’ tiftaħ it-terminal.

Jekk diġà hemm konfigurazzjoni li qed tintuża f’~/.openclaw, l-iskript tal-installazzjoni awtomatikament juża dak id-direttorju. Biex tinstalla kopja separata mingħajr ma tibdel il-konfigurazzjoni eżistenti, ħaddem l-iskript mhux interattiv u speċifika direttorju ġdid:

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

--no-onboard hija l-imġiba awtomatika ta’ dan l-iskript. Fl-2026-10-09, dan il-kmand intuża biex tiġi installata OpenClaw 2026.9.9. Wara l-installazzjoni, trid tħaddem openclaw mid-direttorju bin ta’ dak id-direttorju.

Ikseb il-parametri tal-konnessjoni minn OmniProxy

L-ewwel ikkonferma li OmniProxy qed jaħdem, imbagħad iftaħ il-lista tal-mudelli tiegħu u ħejji dawn it-tliet valuri:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Ikkopja l-ID kollu mil-lista attwali tal-mudelli ta’ OmniProxy

baseUrl huwa l-indirizz fejn OpenClaw jibgħat it-talbiet tal-mudell, u jrid jispiċċa b’/v1. Meta tikkonnettja ma’ OmniProxy, uża openai-completions għal api. Ibdel għal openai-responses biss jekk dan il-mudell tassew jaħdem permezz ta’ /v1/responses.

Model ID huwa l-identifikatur sħiħ tal-mudell fil-lista. Ikkopjah eżattament kif jidher fil-lista, u jekk ikun fih slashes, żommhom ukoll. Iż-żewġ ismijiet li ġejjin huma biss għal tqabbil mad-dokumentazzjoni tal-fornituri tal-2026-10-09; tużahomx jekk ma jidhrux fil-lista: claude-sonnet-5-5, gpt-6-luna.

Anki jekk il-gateway ma jiċċekkjax iċ-ċavetta, xorta trid iddaħħal valur għal apiKey. Tista’ tuża sensiela ta’ karattri bħala placeholder li tintuża biss fuq dan il-kompjuter. Tikkommettix iċ-ċavetta reali fir-repożitorju.

Daħħal il-konfigurazzjoni tal-għodda

Provider jista’ jitqies bħala sett ta’ settings tal-konnessjoni li OpenClaw juża biex isib is-servizz tal-mudell. Hawnhekk il-Provider jissejjaħ omniproxy.

Ħaddem il-kmand li ġej fit-terminal u ibdel l-indirizz, iċ-ċavetta u ż-żewġ Model IDs bil-valuri tiegħek:

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

Dan il-kmand jikteb il-Provider u l-lista tal-mudelli fil-konfigurazzjoni. Wara li l-kmand jirnexxi, m’hemmx għalfejn terġa’ tibda Gateway.

Imbagħad speċifika l-mudell awtomatiku. Ir-referenza tal-mudell hija magħmula minn omniproxy/ u l-Model ID; żomm is-slashes kollha li jkunu diġà fl-ID. Jekk l-ID fil-lista tal-mudelli jkun itwal mill-isem qasir hawn taħt, uża l-valur sħiħ mil-lista:

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

Tista’ tħalli barra reasoning, input, cost, contextWindow u maxTokens. Meta dawn ma jiġux speċifikati, il-mudell tat-test jiġi ttrattat bil-mod awtomatiku.

L-istess settings jistgħu jinkitbu direttament fil-fajl tal-konfigurazzjoni. Fil-konfigurazzjoni ewlenija, il-Provider jinsab taħt models.providers. Kull agent jista’ jkollu wkoll il-models.json tiegħu; agent huwa l-istanza tal-assistent li effettivament tirċievi l-kompiti u ssejjaħ il-mudell. Il-fajl jinsab f’agent/models.json fid-direttorju tal-agent korrispondenti taħt ~/.openclaw/agents/.

Jekk dan il-models.json ikun fih baseUrl mhux vojt, dan jissostitwixxi l-indirizz fil-konfigurazzjoni ewlenija.

Iċċekkja l-installazzjoni

Tliet kmandi

openclaw --version
openclaw doctor
gateway status

Konfigurazzjoni

models.providers

baseUrl għandu jispiċċa b'/v1
api juża completions
Għall-mudell trid tispeċifika mill-inqas id

Għażla

provider/mudell

Uża din ir-referenza għal primary
Preferibbilment uża varjabbli tal-ambjent għaċ-ċavetta
Uża l-lista tal-gateway bħala referenza

L-ewwel ikkonferma li l-kmand jista’ jinstab, imbagħad ikteb l-indirizz u l-mudell. Ir-referenza tal-mudell trid tinkludi l-isem tal-Provider.

Ivverifika kompitu reali

Mur f’direttorju ta’ proġett normali u ibgħat messaġġ qasir ħafna. Ibdel ir-referenza tal-mudell fil-kmand bil-Model ID sħiħ tiegħek:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Wieġeb b’kelma waħda."

--local ifisser li dan il-kompitu tal-agent jitħaddem lokalment, --model jispeċifika l-mudell għal din l-eżekuzzjoni, u --timeout 300 ifisser li wieħed jistenna sa massimu ta’ 300 sekonda.

Fit-terminal trid tidher tweġiba reali mill-mudell. Fl-2026-10-09, OpenClaw 2026.9.9 irċieva tweġiba b’dan il-kmand. L-ewwel sejħa tista’ tieħu minuta jew tnejn.

Jekk jidher l-iżball oriġinali Request timed out before a response was generated, l-ewwel żid il-valur ta’ --timeout u erġa’ ibgħat it-talba. Dan normalment ifisser li l-ħin ta’ stennija ma kienx biżżejjed, u mhux bilfors li l-indirizz huwa ħażin.

Wara li tirnexxi t-tweġiba qasira, itlob lill-agent jaqra fajl lokali li tispeċifika int. Imbagħad iftaħ ir-rekords tas-sejħiet ta’ OmniProxy u kkonferma s-sors u l-Model ID fir-rekord. Il-fatt li jidher biss in-numru tal-verżjoni jew li doctor jagħti output ma jfissirx li l-konnessjoni mal-mudell ġiet ikkonfigurata kompletament.

Installazzjoni

Il-kmand jirrispondi

Jista' juri n-numru tal-verżjoni
doctor ma jsib ebda problema li twaqqaf it-tħaddim
L-istatus tal-Gateway jista' jinqara

Kompitu

Wettaq kompitu żgħir

Pereżempju, qara fajl lokali
It-tweġiba mhijiex żball
Ir-referenza tal-mudell hija korretta

Reġistru

Jidher fil-gateway

Is-sors huwa OpenClaw
L-ID tal-mudell jaqbel
Iċ-ċavetta ma daħlitx fir-repożitorju

Wara li l-kmand tal-verżjoni jagħti output, trid tirċievi wkoll tweġiba reali.

Żbalji komuni

openclaw ma jinstabx: żid id-direttorju globali bin ta’ npm ma’ PATH, imbagħad erġa’ iftaħ it-terminal. Meta tinstalla f’direttorju speċifiku, ħaddem il-programm mid-direttorju bin tiegħu.
node -v huwa inqas minn 24.16: m’hemmx għalfejn tneħħi l-verżjoni l-qadima l-ewwel. Iċċekkja l-verżjoni ta’ Node imħejjija mill-iskript tal-installazzjoni, jew uża 24.16+ jew 26.1+ kif indikat fil-paġna tal-installazzjoni. Huwa rrakkomandat Node 26.
Il-mudell ma jidhirx: il-mudell irid ikun fl-array models taħt models.providers, u jrid ikollu mill-inqas l-istess id. Jekk tikteb biss agents.defaults.models, mudell ġdid ma jiġix irreġistrat separatament.
Jiġi rritornat 400 u tissemma r-rwol developer: meta l-host tal-indirizz ma jkunx api.openai.com, żomm il-valur awtomatiku u tissettjax supportsDeveloperRole għal true. Jekk jiġi ssettjat għal true, xorta jiġi sostitwit.
Jiskadi l-ħin malajr: żid --timeout għal aktar minn 300 sekonda u tibdilx l-indirizz għalissa.
Għażilt gpt-6-luna iżda s-sejħiet tal-għodod ifallu: dan jappoġġa Chat Completions; is-sejħiet tal-funzjonijiet fi Chat Completions huma appoġġati biss meta reasoning_effort ikun none. Jekk l-ID fil-lista jkun differenti, segwi dak tal-lista.
Ma tistax tikkonnettja mal-indirizz: ikkonferma li OmniProxy qed jaħdem, li baseUrl jispiċċa b’/v1, u li l-indirizz miktub fil-konfigurazzjoni huwa aċċessibbli. Indirizzi privati oħra jridu jingħataw aċċess separatament.
Wara l-konfigurazzjoni xorta jintuża indirizz ieħor: iċċekkja jekk il-models.json ta’ dak l-agent fihx baseUrl differenti.

Referenzi uffiċjali

Għall-passi tal-installazzjoni, ara OpenClaw install. Għall-konfigurazzjoni ta’ Provider personalizzat, ara Custom providers u oqsma tal-konfigurazzjoni. Tista’ tqabbel il-Model IDs użati fl-eżempju ma’ ħarsa ġenerali lejn il-mudelli Claude u GPT-6 Luna.

Ibdel kull placeholder b'valuri mill-konfigurazzjoni personali tiegħek ta' OmniProxy. Qatt ma npubblika key reali.

Risultat salvat jew HTTP 200 waħdu ma jipprovax kompatibilità sħiħa tal-Agent. Iċċekkja s-sors u l-mudell fir-rekord tat-talba ta' OmniProxy.

Sorsi uffiċjali · OpenClaw ↗