OpenClawin asennus ja OmniProxyn määrittäminen

OpenClaw on omalle tietokoneellesi asennettava tekoälyavustaja. Voit keskustella sen kanssa suoraan Telegramin, Discord-sovelluksen, WhatsAppin tai Feishun kautta ilman, että sinun tarvitsee pitää erillistä chat-ikkunaa auki. Keskustelut ja lokitiedot pysyvät tällä tietokoneella, ja se voi jatkaa seuraavien vaiheiden suorittamista paikallisesti.

Ennen kuin aloitat

OpenClaw vaatii Node 24.16 tai uudemman version. Voit käyttää myös Node 26.1 tai uudempaa, ja Node 26 on suositeltu. Node tarjoaa OpenClawin vaatiman suoritusympäristön.

Se voidaan asentaa macOS-, Linux- ja Windows-järjestelmiin. Jos tietokoneessa ei ole sopivaa Node-versiota, asennusskripti valmistelee sellaisen automaattisesti: Node 26 macOS:lle ja Node 24 LTS Linuxille. pnpm-työkalua tarvitaan vain, jos OpenClaw käännetään lähdekoodista.

Jos vanhempi Node-versio on jo asennettu, sitä ei tarvitse poistaa ensin. Testauksessa 9.10.2026 tämän tietokoneen järjestelmän Node-versio oli 24.2.0, mikä on alle vaaditun 24.16:n, ja ei-interaktiivinen asennusskripti valmisteli Node 24.21.0:n automaattisesti.

Haluatko ikkunan

Työpöytäkumppani

• Käytä Hub-asennusohjelmaa Windowsissa
• Käytä GitHub DMG -tiedostoa macOS:ssä
• Paikallinen Gateway voidaan asentaa alkuasetusten yhteydessä

Virallisesti suositeltu

Asennusskripti

• macOS Linux WSL2
• Käytä PowerShellia Windowsissa
• Voit lisätä --no-onboard

Node on jo asennettu

Paketinhallinta

• npm pnpm tai bun
• Suorita sitten onboard
• Katso Node-versio asennussivulta

Asennus ja ensimmäinen käynnistys

Voit asentaa työpöytäkumppanin graafisella ikkunalla tai asentaa sen suoraan päätteen kautta. Gateway on paikallinen palvelu, joka vastaa viestien vastaanottamisesta, mallien kutsumisesta ja tulosten palauttamisesta. Voit määrittää sen, kun avaat työpöytäkumppanin ensimmäistä kertaa.

Jos haluat ikkunan

• Windows: Lataa ja suorita OpenClawCompanion-Setup-x64.exe tai OpenClawCompanion-Setup-arm64.exe. Asennusohjelma on allekirjoitettu ja sisältää asetukset, ilmoitusalueen tilan, chatin ja node-tilat.
• macOS: Lataa OpenClaw .dmg OpenClawin GitHub-julkaisuista. Suosi dmg-tiedostoa, vaikka voit käyttää myös .zip. Avaa OpenClaw.app asennuksen jälkeen. Jos tämä versio ei sisällä macOS-tiedostoa, seuraa macOS-sovellussivun ohjeita.

Kun avaat sen ensimmäistä kertaa, voit antaa OpenClawin valmistella Gatewayn tälle tietokoneelle tai yhdistää olemassa olevaan etä-Gatewayhin.

Asennus päätteen kautta

Käytä macOS-, Linux- ja WSL2-järjestelmissä:

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

Käytä Windows PowerShellissa:

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

Skripti tunnistaa nykyisen järjestelmän, asentaa Noden tarvittaessa, asentaa OpenClawin ja käynnistää sitten alkuasetusprosessin. Käyttöönotto-ohjelma opastaa sinut ensimmäisen kerran asetusten läpi.

Jos et halua aloittaa käyttöönottoa vielä, käytä sen sijaan seuraavaa macOS-, Linux- ja WSL2-järjestelmissä:

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

Käytä Windowsissa virallista -NoOnboard valintaa:

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

Jos hallinnoit Nodea jo itse, voit käyttää myös npm-, pnpm- tai bun-työkaluja. Suorita npm 12:lla tai npm 11.16:lla ja uudemmilla:

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

Poista npm 11.15:llä ja aiemmilla --allow-scripts=openclaw. Kun käytät pnpm-työkalua, lisää --allow-build=openclaw. Katso tarkat erot asennussivulta.

Suorita asennuksen jälkeen nämä kolme komentoa järjestyksessä:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version näyttää version, openclaw doctor tarkistaa yleiset ympäristöongelmat ja openclaw gateway status näyttää, onko Gateway käynnissä. Perusasennus on valmis vasta, kun kaikki kolme komentoa tuottavat normaalin tulosteen.

Jos pääte ilmoittaa, ettei se löydä openclaw, npm:n globaali bin-hakemisto puuttuu yleensä PATH-muuttujasta. PATH on luettelo sijainneista, joista pääte etsii ohjelmia. Vertaa tulosteita: node -v, npm prefix -gja echo "$PATH", lisää vastaava bin-hakemisto PATH-muuttujaan ja avaa pääte uudelleen.

Jos ~/.openclaw sisältää jo käytössä olevan konfiguraation, oletusasennusskripti käyttää kyseistä hakemistoa. Jos haluat asentaa erillisen kopion muuttamatta olemassa olevaa konfiguraatiota, suorita ei-interaktiivinen skripti ja määritä uusi hakemisto:

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

--no-onboard on tämän skriptin oletuskäyttäytyminen. 9.10.2026 tämä komento asensi OpenClaw 2026.9.9 -version. Suorita asennuksen jälkeen openclaw suoritettava tiedosto hakemiston bin kansiosta.

Hae yhteysarvot OmniProxysta

Varmista ensin, että OmniProxy on käynnissä, avaa sitten sen malliluettelo ja valmistele seuraavat kolme arvoa:

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 on osoite, johon OpenClaw lähettää mallipyynnöt, ja sen on päätyttävä /v1. Kun yhdistät OmniProxyyn, käytä openai-completions kohteelle api. Muuta se muotoon openai-responses vain, jos malli todella toimii rajapinnan /v1/responses kautta.

Mallin tunniste (Model ID) on mallin täydellinen tunniste luettelossa. Kopioi se täsmälleen sellaisena kuin se näkyy, mukaan lukien mahdolliset vinoviivat. Seuraavat kaksi nimeä ovat vain viitteitä palveluntarjoajan dokumentaatiosta 9.10.2026 alkaen; älä käytä niitä, jos ne eivät näy luettelossa: claude-sonnet-5-5, gpt-6-luna.

Vaikka yhdyskäytävä ei validoisi avainta, apiKey on silti sisällettävä arvo. Voit käyttää paikkamerkkijonoa, jota käytetään vain tällä tietokoneella. Älä tallenna oikeaa avainta arkistoon.

Syötä työkalun konfiguraatio

Palveluntarjoaja (Provider) voidaan ymmärtää joukkona yhteysasetuksia, joita OpenClaw käyttää mallipalvelun paikantamiseen. Tässä palveluntarjoajan nimi on omniproxy.

Suorita seuraava komento päätteessä korvaten osoite, avain ja kaksi mallin tunnistetta omilla arvoillasi:

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

Tämä komento kirjoittaa palveluntarjoajan ja malliluettelon konfiguraatioon. Gatewayta ei tarvitse käynnistää uudelleen komennon onnistumisen jälkeen.

Seuraavaksi määritä oletusmalli. Malliviite koostuu omniproxy/ ja sitä seuraavasta mallin tunnisteesta. Säilytä kaikki tunnisteessa jo olevat vinoviivat. Jos malliluettelon tunniste on pidempi kuin alla oleva lyhyt nimi, käytä luettelon täydellistä arvoa:

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

reasoning, input, cost, contextWindowja maxTokens voidaan kaikki jättää pois. Kun niitä ei anneta, tekstimalleja käsitellään oletusarvoilla.

Voit myös kirjoittaa samat asetukset suoraan konfiguraatiotiedostoon. Pääkonfiguraatiossa palveluntarjoaja sijaitsee kohdassa models.providers. Jokaisella agentilla voi myös olla oma models.json; agentti on avustaja-instanssi, joka todellisuudessa vastaanottaa tehtäviä ja kutsuu malleja. Tiedosto sijaitsee kohdassa agent/models.json vastaavan agenttihakemiston alla kohdassa ~/.openclaw/agents/.

Jos tämä models.json sisältää ei-tyhjän baseUrl, se ohittaa pääkonfiguraation osoitteen.

Tarkista asennus

Kolme komentoa

• openclaw --version
• openclaw doctor
• gateway status

Konfiguraatio

models.providers

• baseUrl päättyy /v1
• Aseta api arvoon completions
• Määritä vähintään mallin tunniste

Valitse

provider/model

• Käytä tätä viitettä ensisijaisena
• Suosi ympäristömuuttujaa avaimelle
• Käytä yhdyskäytäväluetteloa totuuden lähteenä

Vahvista todellinen tehtävä

Siirry tavalliseen projektihakemistoon ja lähetä hyvin lyhyt viesti. Korvaa komennon malliviite täydellisellä mallin tunnisteellasi:

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

--local suorittaa tämän agenttitehtävän paikallisesti, --model määrittää tässä ajossa käytettävän mallin ja --timeout 300 asettaa enimmäisodotusajaksi 300 sekuntia.

Todellisen mallivastauksen on ilmestyttävä päätteeseen. 9.10.2026 OpenClaw 2026.9.9 vastaanotti vastauksen tällä komennolla. Ensimmäinen kutsu voi kestää minuutin tai kaksi.

Jos alkuperäinen virhe Request timed out before a response was generated ilmestyy, lisää --timeout ja lähetä pyyntö uudelleen. Tämä tarkoittaa yleensä, että odotusaika ei ollut riittävä, eikä se välttämättä tarkoita, että osoite on väärä.

Kun lyhyt vastaus onnistuu, pyydä sitä lukemaan määrittämäsi paikallinen tiedosto. Avaa sitten OmniProxyn pyyntölokit ja vahvista tietueessa näkyvä lähde ja mallin tunniste. Vain version tai doctor-komennon tuloste ei tarkoita, että malliyhteys on määritetty täysin.

Asennus

Komento vastaa

• Versionumero näytetään
• doctor ei raportoi esteitä
• Gatewayn tila on luettavissa

Tehtävä

Se suoritti pienen tehtävän

• Esimerkiksi paikallisen tiedoston lukeminen
• Vastaus ei ole virhe
• Malliviite on oikea

Lokit

Näkyvissä yhdyskäytävässä

• Lähde on OpenClaw
• Mallin tunniste täsmää
• Avainta ei lisätty arkistoon

Yleiset virheet

• Ei löydy openclaw: Lisää npm:n globaali bin-hakemisto PATH-muuttujaan ja avaa pääte uudelleen. Jos asensit tiettyyn hakemistoon, suorita suoritettava tiedosto kyseisen hakemiston bin kansiosta.
• node -v on alle 24.16: Vanhaa versiota ei tarvitse poistaa ensin. Tarkista asennusskriptin valmistelema Node-versio tai käytä 24.16+ tai 26.1+ versiota asennussivun ohjeiden mukaisesti. Node 26 on suositeltu.
• Malli ei näy: Mallin on oltava mukana models taulukossa kohdassa models.providers ja sillä on oltava vähintään sama id. Vain agents.defaults.models asettaminen ei rekisteröi uutta mallia itsestään.
• 400-vastaus mainitsee kehittäjäroolin: Kun osoitteen isäntä ei ole api.openai.com, pidä oletusarvo äläkä aseta supportsDeveloperRole arvoon true. Vaikka se asetettaisiin arvoon true, se ohitetaan silti.
• Se aikakatkaistaan nopeasti: Lisää --timeout yli 300 sekuntiin ennen osoitteen muuttamista.
• Työkalukutsut epäonnistuvat valinnan jälkeen gpt-6-luna: Se tukee Chat Completions -toimintoa; funktioiden kutsuminen Chat Completionsissa on tuettu vain, kun reasoning_effort on none. Jos luettelon tunniste eroaa tästä, käytä luettelossa näkyvää tunnistetta.
• Osoitteeseen ei saada yhteyttä: Varmista, että OmniProxy on käynnissä, että baseUrl päättyy /v1ja että konfiguraatioon kirjoitettu osoite on käytettävissä. Muut yksityisverkon osoitteet on sallittava erikseen.
• Pyynnöt menevät edelleen toiseen osoitteeseen konfiguroinnin jälkeen: Tarkista, sisältääkö kyseisen agentin models.json eri baseUrl.

Viralliset viitteet

Katso asennusvaiheet kohdasta OpenClaw install. Katso mukautetun palveluntarjoajan konfiguraatio kohdasta Custom providers ja configuration fields. Vertaa esimerkeissä käytettyjä mallitunnisteita kohtiin Claude model overview ja GPT-6 Luna.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · OpenClaw ↗