OpenClaw instalēšana un OmniProxy konfigurēšana

OpenClaw ir AI asistents, kas tiek instalēts jūsu datorā. Varat ar to sazināties tieši, izmantojot Telegram, Discord, WhatsApp vai Feishu, neuzturot atvērtu citu tērzēšanas logu. Sarunas un ieraksti paliek šajā datorā, un tas var turpināt veikt turpmākās darbības lokāli.

Pirms sākat

OpenClaw nepieciešama Node 24.16 vai jaunāka versija. Varat izmantot arī Node 26.1 vai jaunāku versiju; ieteicama ir Node 26. Node nodrošina izpildlaika vidi, kas nepieciešama OpenClaw.

To var instalēt macOS, Linux un Windows. Ja datorā nav piemērotas Node versijas, instalēšanas skripts to sagatavos automātiski: Node 26 operētājsistēmā macOS un Node 24 LTS operētājsistēmā Linux. pnpm ir nepieciešams tikai tad, ja OpenClaw tiek kompilēts no pirmkoda.

Ja jau ir instalēta vecāka Node versija, vispirms nav nepieciešams to atinstalēt. Pārbaudes laikā 2026-10-09 sistēmas Node versija šajā datorā bija 24.2.0, kas ir zemāka par nepieciešamo 24.16, un neinteraktīvais instalēšanas skripts automātiski sagatavoja Node 24.21.0.

Vēlaties logu

Darbvirsmas palīgs

• Izmantojiet Hub instalētāju operētājsistēmā Windows
• Izmantojiet GitHub DMG operētājsistēmā macOS
• Lokālo Gateway var instalēt sākotnējās iestatīšanas laikā

Oficiāli ieteicams

Instalēšanas skripts

• macOS Linux WSL2
• Izmantojiet PowerShell operētājsistēmā Windows
• Varat pievienot --no-onboard

Node jau ir instalēta

Pakotņu pārvaldnieks

• npm pnpm vai bun
• Pēc tam palaidiet onboard
• Skatiet instalēšanas lapu, lai uzzinātu Node versiju

Instalēšana un pirmā palaišana

Varat instalēt darbvirsmas palīgu ar grafisku logu vai instalēt tieši caur termināli. Gateway ir lokālais pakalpojums, kas atbild par ziņojumu saņemšanu, modeļu izsaukšanu un rezultātu atgriešanu. Varat to iestatīt, pirmo reizi atverot darbvirsmas palīgu.

Ja vēlaties logu

• Windows: Lejupielādējiet un palaidiet OpenClawCompanion-Setup-x64.exe vai OpenClawCompanion-Setup-arm64.exe. Instalētājs ir parakstīts un ietver iestatījumus, statusu sistēmas teknē, tērzēšanu un mezgla režīmus.
• macOS: Lejupielādējiet OpenClaw .dmg no OpenClaw GitHub laidieniem. Priekšroku dodiet dmg, lai gan varat izmantot arī .zip. Pēc instalēšanas atveriet OpenClaw.app. Ja šajā versijā nav iekļauts macOS fails, sekojiet macOS lietotnes lapai.

Pirmo reizi atverot, varat ļaut OpenClaw sagatavot Gateway šajā datorā vai izveidot savienojumu ar esošu attālo Gateway.

Instalēšana caur termināli

Operētājsistēmām macOS, Linux un WSL2 izmantojiet:

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

Windows PowerShell izmantojiet:

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

Skripts nosaka pašreizējo sistēmu, vajadzības gadījumā instalē Node, instalē OpenClaw un pēc tam sāk sākotnējo ievadprocesu. Ievadprocess palīdz veikt pirmo iestatīšanu.

Ja vēl nevēlaties sākt ievadprocesu, tā vietā izmantojiet šo operētājsistēmās macOS, Linux un WSL2:

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

Windows sistēmā izmantojiet oficiālo -NoOnboard opciju:

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

Ja jau pats pārvaldāt Node, varat izmantot arī npm, pnpm vai bun. Ar npm 12 vai npm 11.16 un jaunāku versiju palaidiet:

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

Ja izmantojat npm 11.15 vai vecāku, noņemiet --allow-scripts=openclaw. Izmantojot pnpm, pievienojiet --allow-build=openclaw. Skatiet instalēšanas lapu, lai uzzinātu precīzas atšķirības.

Pēc instalēšanas palaidiet šīs trīs komandas secībā:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version parāda versiju, openclaw doctor pārbauda izplatītākās vides problēmas un openclaw gateway status parāda, vai Gateway darbojas. Pamata instalēšana ir pabeigta tikai tad, ja visas trīs komandas sniedz normālu izvadi.

Ja terminālis ziņo, ka nevar atrast openclaw, npm globālais bin direktorijs parasti trūkst PATH. PATH ir to vietu saraksts, kurās terminālis meklē programmas. Salīdziniet izvadi no node -v, npm prefix -g, un echo "$PATH", pievienojiet atbilstošo bin direktoriju PATH un pēc tam atkārtoti atveriet termināli.

Ja ~/.openclaw jau satur pašlaik izmantoto konfigurāciju, noklusējuma instalēšanas skripts izmantos šo direktoriju. Lai instalētu atsevišķu kopiju, nemainot esošo konfigurāciju, palaidiet neinteraktīvo skriptu un norādiet jaunu direktoriju:

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

--no-onboard ir šī skripta noklusējuma darbība. 2026-10-09 šī komanda instalēja OpenClaw 2026.9.9. Pēc instalēšanas palaidiet openclaw izpildāmo failu no direktorija bin mapes.

Savienojuma vērtību iegūšana no OmniProxy

Vispirms pārliecinieties, ka OmniProxy darbojas, pēc tam atveriet tā modeļu sarakstu un sagatavojiet šādas trīs vērtības:

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 ir adrese, uz kuru OpenClaw sūta modeļu pieprasījumus, un tai jābeidzas ar /v1. Veidojot savienojumu ar OmniProxy, izmantojiet openai-completions priekš api. Mainiet to uz openai-responses tikai tad, ja modelis faktiski darbojas caur /v1/responses.

Modeļa ID ir modeļa pilnais identifikators sarakstā. Kopējiet to precīzi tā, kā parādīts, ieskaitot slīpsvītras. Šie divi nosaukumi ir tikai atsauces no pakalpojumu sniedzēja dokumentācijas uz 2026-10-09; neizmantojiet tos, ja tie nav redzami sarakstā: claude-sonnet-5-5, gpt-6-luna.

Pat ja vārteja nevalidē atslēgu, apiKey joprojām ir jāsatur vērtība. Varat izmantot viettura virkni, kas tiek izmantota tikai šajā datorā. Neievietojiet īstu atslēgu repozitorijā.

Rīka konfigurācijas ievadīšana

Pakalpojumu sniedzēju (Provider) var saprast kā savienojuma iestatījumu kopu, ko OpenClaw izmanto, lai atrastu modeļa pakalpojumu. Šeit pakalpojumu sniedzējs ir nosaukts par omniproxy.

Palaidiet šo komandu terminālī, aizstājot adresi, atslēgu un divus modeļu ID ar savām vērtībām:

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

Šī komanda ieraksta pakalpojumu sniedzēju un modeļu sarakstu konfigurācijā. Pēc komandas izpildes Gateway nav jārestartē.

Pēc tam norādiet noklusējuma modeli. Modeļa atsauce sastāv no omniproxy/ kam seko modeļa ID. Saglabājiet katru slīpsvītru, kas jau ir ID. Ja ID modeļu sarakstā ir garāks par īso nosaukumu zemāk, izmantojiet pilno vērtību no saraksta:

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

reasoning, input, cost, contextWindow, un maxTokens var izlaist. Ja tie nav norādīti, teksta modeļi tiek apstrādāti, izmantojot noklusējuma iestatījumus.

Varat arī ierakstīt tos pašus iestatījumus tieši konfigurācijas failā. Galvenajā konfigurācijā pakalpojumu sniedzējs atrodas zem models.providers. Katram aģentam var būt arī savs models.json; aģents ir asistenta instance, kas faktiski saņem uzdevumus un izsauc modeļus. Fails atrodas agent/models.json atbilstošajā aģenta direktorijā zem ~/.openclaw/agents/.

Ja šis models.json satur ne-tukšu baseUrl, tas ignorē adresi galvenajā konfigurācijā.

Pārbaudīt instalēšanu

Trīs komandas

• openclaw --version
• openclaw doctor
• gateway status

Konfigurācija

models.providers

• baseUrl beidzas ar /v1
• Iestatīt api uz completions
• Norādiet vismaz modeļa id

Atlasīt

provider/model

• Izmantojiet šo atsauci primārajam
• Dodiet priekšroku vides mainīgajam atslēgai
• Izmantojiet vārtejas sarakstu kā patiesības avotu

Reāla uzdevuma pārbaude

Ieejiet parastā projekta direktorijā un nosūtiet ļoti īsu ziņojumu. Aizstājiet modeļa atsauci komandā ar savu pilno modeļa ID:

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

--local palaiž šo aģenta uzdevumu lokāli, --model norāda modeli, ko izmantot šai palaišanas reizei, un --timeout 300 iestata maksimālo gaidīšanas laiku uz 300 sekundēm.

Terminālī jāparādās faktiskajai modeļa atbildei. 2026-10-09 OpenClaw 2026.9.9 saņēma atbildi, izmantojot šo komandu. Pirmais izsaukums var aizņemt vienu vai divas minūtes.

Ja parādās sākotnējā kļūda Request timed out before a response was generated , palieliniet --timeout un nosūtiet pieprasījumu vēlreiz. Tas parasti nozīmē, ka gaidīšanas laiks bija nepietiekams, un tas ne vienmēr norāda, ka adrese ir nepareiza.

Pēc tam, kad īsā atbilde ir veiksmīga, palūdziet tam izlasīt jūsu norādīto lokālo failu. Pēc tam atveriet OmniProxy pieprasījumu ierakstus un apstipriniet ierakstā redzamo avotu un modeļa ID. Izvade tikai no versijas komandas vai doctor nenozīmē, ka modeļa savienojums ir pilnībā konfigurēts.

Instalēšana

Komanda atbild

• Tiek parādīts versijas numurs
• doctor ziņo par problēmu neesamību
• Gateway statuss ir nolasāms

Uzdevums

Tas pabeidza nelielu uzdevumu

• Piemēram, izlasīt lokālu failu
• Atbilde nav kļūda
• Modeļa atsauce ir pareiza

Žurnāli

Redzams vārtejā

• Avots ir OpenClaw
• Modeļa ID sakrīt
• Atslēga netika pievienota repozitorijam

Biežākās kļūdas

• Nevar atrast openclaw: Pievienojiet npm globālo bin direktoriju PATH, pēc tam atkārtoti atveriet termināli. Ja instalējāt norādītā direktorijā, palaidiet izpildāmo failu no šī direktorija bin mapes.
• node -v ir zemāka par 24.16: Vispirms nav nepieciešams atinstalēt veco versiju. Pārbaudiet instalēšanas skripta sagatavoto Node versiju vai izmantojiet 24.16+ vai 26.1+, kā aprakstīts instalēšanas lapā. Ieteicama ir Node 26.
• Modelis neparādās: Modelim jābūt iekļautam models masīvā zem models.providers un tam jābūt vismaz tādam pašam id. Tikai agents.defaults.models iestatīšana pati par sevi nereģistrē jaunu modeli.
• 400 atbilde piemin izstrādātāja lomu: Kad adreses resursdators nav api.openai.com, saglabājiet noklusējumu un neiestatiet supportsDeveloperRole uz true. Pat ja tas ir iestatīts uz true, tas tiks ignorēts.
• Tas ātri noildzina: Palieliniet --timeout līdz vairāk nekā 300 sekundēm pirms adreses maiņas.
• Rīku izsaukumi neizdodas pēc gpt-6-lunaatlasīšanas: Tas atbalsta Chat Completions; funkciju izsaukšana Chat Completions tiek atbalstīta tikai tad, kad reasoning_effort ir none. Ja ID sarakstā atšķiras no šī, izmantojiet sarakstā redzamo ID.
• Adrese nav sasniedzama: Pārliecinieties, ka OmniProxy darbojas, ka baseUrl beidzas ar /v1, un ka konfigurācijā ierakstītā adrese ir pieejama. Citas privātā tīkla adreses ir jāatļauj atsevišķi.
• Pieprasījumi joprojām dodas uz citu adresi pēc konfigurācijas: Pārbaudiet, vai šī aģenta models.json satur citu baseUrl.

Oficiālās atsauces

Instalēšanas soļus skatiet OpenClaw install. Pielāgotu pakalpojumu sniedzēja konfigurāciju skatiet Custom providers un configuration fields. Lai uzzinātu piemēros izmantotos modeļu ID, salīdziniet ar Claude model overview un GPT-6 Luna.

Aizstājiet katru vietniekvērtību ar vērtībām no sava OmniProxy konfigurācijas. Nekad nepublicējiet patieso atslēgu.

Saglabāts rezultāts vai HTTP 200 pats par sevi nepierāda pilnu aģenta saderību. Pārbaudiet avotu un modeli OmniProxy zvanu ierakstā.

Oficiālie avoti · OpenClaw ↗