Instalarea OpenClaw și configurarea OmniProxy

OpenClaw este un asistent AI instalat pe propriul tău computer. Poți comunica cu acesta direct prin Telegram, Discord, WhatsApp sau Feishu fără a menține deschisă o altă fereastră de chat. Conversațiile și înregistrările rămân pe acest computer și acesta poate continua să execute pașii următori local.

Înainte de a începe

OpenClaw necesită Node 24.16 sau o versiune ulterioară. Poți utiliza, de asemenea, Node 26.1 sau o versiune ulterioară, fiind recomandat Node 26. Node oferă mediul de execuție necesar pentru OpenClaw.

Poate fi instalat pe macOS, Linux și Windows. Dacă computerul nu are o versiune adecvată de Node, scriptul de instalare va pregăti una automat: Node 26 pe macOS și Node 24 LTS pe Linux. pnpm este necesar doar atunci când construiești OpenClaw din sursă.

Dacă o versiune mai veche de Node este deja instalată, nu trebuie să o dezinstalezi mai întâi. În timpul testelor din 09-10-2026, versiunea de Node a sistemului de pe acest computer era 24.2.0, sub cerința de 24.16, iar scriptul de instalare non-interactiv a pregătit automat Node 24.21.0.

Dorești o fereastră

Companion desktop

• Folosește instalatorul Hub pe Windows
• Folosește DMG-ul de pe GitHub pe macOS
• Gateway-ul local poate fi instalat în timpul configurării inițiale

Recomandat oficial

Script de instalare

• macOS Linux WSL2
• Folosește PowerShell pe Windows
• Poți adăuga --no-onboard

Node deja instalat

Manager de pachete

• npm pnpm sau bun
• Apoi rulează onboard
• Vezi pagina de instalare pentru versiunea de Node

Instalare și prima lansare

Poți instala companionul desktop cu o fereastră grafică sau poți instala direct prin terminal. Gateway este serviciul local responsabil pentru primirea mesajelor, apelarea modelelor și returnarea rezultatelor. Îl poți configura la prima deschidere a companionului desktop.

Dacă dorești o fereastră

• Windows: Descarcă și rulează OpenClawCompanion-Setup-x64.exe sau OpenClawCompanion-Setup-arm64.exe. Instalatorul este semnat și include setări, starea din tray, chat și moduri node.
• macOS: Descarcă OpenClaw .dmg din release-urile GitHub ale OpenClaw. Preferă dmg-ul, deși poți folosi și .zip. Deschide OpenClaw.app după instalare. Dacă această versiune nu include un fișier macOS, urmează pagina aplicației macOS.

Când îl deschizi pentru prima dată, poți lăsa OpenClaw să pregătească Gateway pe acest computer sau să te conectezi la un Gateway remote existent.

Instalare prin terminal

Pentru macOS, Linux și WSL2, folosește:

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

Pentru Windows PowerShell, folosește:

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

Scriptul detectează sistemul curent, instalează Node când este necesar, instalează OpenClaw și apoi pornește procesul inițial de onboarding. Fluxul de onboarding te ghidează prin configurarea inițială.

Dacă nu dorești să începi onboarding-ul încă, folosește în schimb următoarele pe macOS, Linux și WSL2:

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

Pe Windows, folosește opțiunea oficială -NoOnboard :

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

Dacă gestionezi deja Node singur, poți folosi și npm, pnpm sau bun. Cu npm 12 sau npm 11.16 și versiuni ulterioare, rulează:

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

Pentru npm 11.15 și versiuni anterioare, elimină --allow-scripts=openclaw. Când folosești pnpm, adaugă --allow-build=openclaw. Consultă pagina de instalare pentru diferențele exacte.

După instalare, rulează aceste trei comenzi în ordine:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version afișează versiunea, openclaw doctor verifică problemele comune de mediu și openclaw gateway status arată dacă Gateway rulează. Instalarea de bază este completă doar când toate cele trei comenzi produc o ieșire normală.

Dacă terminalul raportează că nu poate găsi openclaw, directorul global bin npm lipsește de obicei din PATH. PATH este lista de locații unde terminalul caută programe. Compară ieșirea node -v, npm prefix -gși echo "$PATH", adaugă directorul bin corespunzător la PATH și apoi redeschide terminalul.

Dacă ~/.openclaw conține deja o configurație utilizată în prezent, scriptul de instalare implicit va folosi acel director. Pentru a instala o copie separată fără a modifica configurația existentă, rulează scriptul non-interactiv și specifică un director nou:

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

--no-onboard este comportamentul implicit al acestui script. La data de 09-10-2026, această comandă a instalat OpenClaw 2026.9.9. După instalare, rulează executabilul openclaw din folderul bin al directorului.

Obținerea valorilor de conexiune de la OmniProxy

Confirmă mai întâi că OmniProxy rulează, apoi deschide lista sa de modele și pregătește următoarele trei valori:

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 este adresa către care OpenClaw trimite cererile de model și trebuie să se termine cu /v1. Când te conectezi la OmniProxy, folosește openai-completions pentru api. Schimbă-l în openai-responses doar dacă modelul funcționează efectiv prin /v1/responses.

ID-ul Modelului este identificatorul complet al modelului din listă. Copiază-l exact așa cum apare, incluzând orice slash-uri. Următoarele două nume sunt doar referințe din documentația furnizorului la data de 09-10-2026; nu le folosi dacă nu apar în listă: claude-sonnet-5-5, gpt-6-luna.

Chiar dacă gateway-ul nu validează cheia, apiKey trebuie să conțină totuși o valoare. Poți folosi un șir de tip placeholder care este utilizat doar pe acest computer. Nu introduce o cheie reală într-un depozit (repository).

Introducerea configurației instrumentului

Un Furnizor (Provider) poate fi înțeles ca un set de setări de conexiune pe care OpenClaw le folosește pentru a localiza un serviciu de model. Aici, Furnizorul este numit omniproxy.

Rulează următoarea comandă în terminal, înlocuind adresa, cheia și cele două ID-uri de model cu propriile tale valori:

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

Această comandă scrie Furnizorul și lista de modele în configurație. Nu trebuie să repornești Gateway după ce comanda reușește.

În continuare, specifică modelul implicit. Referința modelului constă în omniproxy/ urmat de ID-ul modelului. Păstrează fiecare slash deja prezent în ID. Dacă ID-ul din lista de modele este mai lung decât numele scurt de mai jos, folosește valoarea completă din listă:

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

reasoning, input, cost, contextWindowși maxTokens pot fi omise. Când nu sunt furnizate, modelele de text sunt gestionate folosind valorile implicite.

Poți scrie aceleași setări direct în fișierul de configurare. În configurația principală, Furnizorul se află sub models.providers. Fiecare agent poate avea, de asemenea, propriul models.json; un agent este o instanță de asistent care primește efectiv sarcini și apelează modele. Fișierul se află la agent/models.json în interiorul directorului corespunzător agentului sub ~/.openclaw/agents/.

Dacă acest models.json conține un baseUrlnon-gol, acesta suprascrie adresa din configurația principală.

Verifică instalarea

Trei comenzi

• openclaw --version
• openclaw doctor
• gateway status

Configurare

models.providers

• baseUrl se termină cu /v1
• Setează api la completions
• Specifică cel puțin id-ul modelului

Selectează

provider/model

• Folosește această referință pentru principal
• Preferă o variabilă de mediu pentru cheie
• Folosește lista gateway-ului ca sursă de adevăr

Verificarea unei sarcini reale

Intră într-un director de proiect obișnuit și trimite un mesaj foarte scurt. Înlocuiește referința modelului din comandă cu ID-ul tău complet de Model:

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

--local rulează această sarcină de agent local, --model specifică modelul de utilizat pentru această rulare și --timeout 300 setează timpul maxim de așteptare la 300 de secunde.

Un răspuns real de la model trebuie să apară în terminal. La data de 09-10-2026, OpenClaw 2026.9.9 a primit un răspuns folosind această comandă. Prima apelare poate dura unul sau două minute.

Dacă apare eroarea originală Request timed out before a response was generated , crește --timeout și trimite cererea din nou. Acest lucru înseamnă de obicei că timpul de așteptare a fost insuficient și nu indică neapărat că adresa este incorectă.

După ce răspunsul scurt reușește, cere-i să citească un fișier local pe care îl specifici. Apoi deschide înregistrările de cereri ale OmniProxy și confirmă sursa și ID-ul modelului afișate în înregistrare. Ieșirea doar din comanda de versiune sau doctor nu înseamnă că conexiunea modelului a fost configurată complet.

Instalare

Comanda răspunde

• Numărul versiunii este afișat
• doctor nu raportează blocaje
• Starea Gateway este lizibilă

Sarcină

A finalizat o sarcină mică

• De exemplu, citește un fișier local
• Răspunsul nu este o eroare
• Referința modelului este corectă

Jurnale

Vizibil în gateway

• Sursa este OpenClaw
• ID-ul modelului se potrivește
• Cheia nu a fost adăugată în depozit

Erori comune

• Nu se poate găsi openclaw: Adaugă directorul global bin npm la PATH, apoi redeschide terminalul. Dacă ai instalat într-un director specificat, rulează executabilul din folderul bin al acelui director.
• node -v este sub 24.16: Nu trebuie să dezinstalezi versiunea veche mai întâi. Verifică versiunea de Node pregătită de scriptul de instalare sau folosește 24.16+ sau 26.1+ așa cum este descris pe pagina de instalare. Node 26 este recomandat.
• Modelul nu apare: Modelul trebuie să fie inclus în matricea models sub models.providers și trebuie să aibă cel puțin același id. Setarea doar a agents.defaults.models nu înregistrează un model nou de la sine.
• Un răspuns 400 menționează rolul de dezvoltator: Când gazda adresei nu este api.openai.com, păstrează valoarea implicită și nu seta supportsDeveloperRole la true. Chiar dacă este setat la true, va fi totuși suprascris.
• Expiră rapid (timeout): Crește --timeout la mai mult de 300 de secunde înainte de a schimba adresa.
• Apelurile de instrumente eșuează după selectarea gpt-6-luna: Suportă Chat Completions; apelarea funcțiilor în Chat Completions este suportată doar când reasoning_effort este none. Dacă ID-ul din listă diferă de acesta, folosește ID-ul afișat în listă.
• Adresa nu poate fi accesată: Confirmă că OmniProxy rulează, că baseUrl se termină cu /v1, și că adresa scrisă în configurație este accesibilă. Alte adrese de rețea privată trebuie permise separat.
• Cererile merg în continuare la o altă adresă după configurare: Verifică dacă models.json al acelui agent conține un baseUrl.

diferit.

Referințe oficiale

Pentru pașii de instalare, vezi OpenClaw install. Pentru configurarea personalizată a Furnizorului, vezi Custom providers și configuration fields. Pentru ID-urile de model folosite în exemple, compară cu Claude model overview și GPT-6 Luna.

Înlocuiește fiecare spațiu rezervat cu valori din propria ta configurare OmniProxy. Nu publica niciodată o cheie reală.

Un rezultat salvat sau HTTP 200 singur nu dovedește compatibilitatea completă a Agentului. Verifică sursa și modelul în înregistrarea de apeluri OmniProxy.

Surse oficiale · OpenClaw ↗