OpenClaw on avoimen lähdekoodin tekoälyavustaja, jonka voi asentaa omalle tietokoneelle. Tämä opas käy läpi koko käyttöönoton alusta loppuun ja antaa jokaisen komennon erikseen Windowsille, macOS:lle ja Linuxille, jotta voit seurata suoraan oman koneesi ohjetta. Opas on kirjoitettu lukijalle, joka ei ole aiemmin asentanut komentorivityökaluja: jokainen erikoistermi selitetään heti, kun se tulee vastaan.
Mitä OpenClaw on ja mitä käyttöönotto vaatii?
OpenClaw koostuu kolmesta osasta. Gateway on taustalla pyörivä palvelinohjelma, joka pitää yhteyden tekoälymalliin ja hoitaa varsinaiset tehtävät. Control UI on selaimessa aukeava hallintapaneeli, jossa avustajan kanssa jutellaan ja asetuksia muutetaan. Kanavat yhdistävät avustajan valmiisiin viestisovelluksiin, kuten Telegramiin, WhatsAppiin, Discordiin ja Slackiin. Päätteeseen kirjoitettava openclaw-komento ohjaa kaikkia näitä osia.
OpenClaw ei sisällä omaa kielimallia, vaan se yhdistetään joko valmiiseen verkkopalveluun tai koneella itse pyörivään malliin. Käyttöönotto onnistuu, kun koneelta löytyy kolme asiaa:
- Node.js 24.16 tai uudempi (suositeltu versio 26.1 tai uudempi). Node.js on ajoympäristö, jolla OpenClaw’n ohjelmakoodi ajetaan. Virallinen asennusohjelma osaa asentaa sen puolestasi, jos sitä ei ole valmiina.
- Yksi yhteys tekoälymalliin — joko palveluntarjoajan maksullinen rajapinta-avain eli API-avain, olemassa oleva Claude Code- tai Codex-kirjautuminen tai koneella pyörivä paikallinen malli esimerkiksi Ollaman tai LM Studion kautta.
- Tuettu käyttöjärjestelmä — Windows 10 (versio 20H2 tai uudempi) tai Windows 11, macOS 15.0 tai uudempi työpöytäsovellukselle (komentorivityökalut toimivat macOS 13.5:stä alkaen) ja mikä tahansa tavallinen Linux-jakelu, jossa on systemd-palvelunhallinta.
Päätteellä tarkoitetaan tekstipohjaista komentoikkunaa: Windowsilla se on PowerShell, macOS:lla Terminal ja Linuxilla pääte. Kaikki tässä oppaassa annetut komennot kirjoitetaan tähän ikkunaan ja vahvistetaan Enter-näppäimellä.
Vaihe 1: Asenna OpenClaw omalle koneelle
Nopein tapa on virallinen asennuskomento. Se tunnistaa käyttöjärjestelmän, asentaa Node.js:n tarvittaessa, asentaa OpenClaw’n ja käynnistää perässä asennusvelhon.
- Windows: avaa PowerShell ja aja
iwr -useb https://openclaw.ai/install.ps1 | iex. Jos haluat tavallisen työpöytäsovelluksen, lataa sen sijaan Windows Hub -kumppanisovellus (OpenClawCompanion-Setup-x64.exetai ARM-koneelleOpenClawCompanion-Setup-arm64.exe) Windows Hubin julkaisusivulta ja asenna se kaksoisklikkaamalla. Kolmas vaihtoehto on WSL2 eli Windowsin sisällä ajettava Linux-ympäristö, jos haluat kaikkein Linux-yhteensopivimman version. - macOS: avaa Terminal ja aja
curl -fsSL https://openclaw.ai/install.sh | bash. Työpöytäsovelluksen saat lataamallaOpenClaw-<version>.dmg-tiedoston OpenClaw’n GitHub-julkaisuista ja asentamalla sen tavalliseen tapaan. - Linux: avaa pääte ja aja sama komento
curl -fsSL https://openclaw.ai/install.sh | bash.
Jos haluat asentaa vain komentorivityökalun ilman asennusvelhoa, lisää komentoon Windowsilla -NoOnboard ja macOS:lla tai Linuxilla --no-onboard. Voit myös asentaa OpenClaw’n npm-paketinhallinnalla kaikilla kolmella käyttöjärjestelmällä: npm install -g openclaw@latest --allow-scripts=openclaw. Silloin Node.js pitää olla valmiiksi asennettuna — Windowsilla winget install OpenJS.NodeJS.LTS, macOS:lla brew install node ja Linuxilla (Ubuntu tai Debian) NodeSource-asennusohjelmalla.
Vaihe 2: Valitse ja varmista tekoäly-yhteys
Asennuksen lopuksi aukeaa asennusvelho. Se tarjoaa Quick start -aloitusta, joka etsii koneelta valmiin tekoäly-yhteyden, kokeilee sitä oikealla kysymyksellä ja avaa sen jälkeen hallintapaneelin. Custom setup puolestaan käy läpi kaikki asetukset kysymys kerrallaan.
- Windows: asennusvelho aukeaa automaattisesti PowerShellissä, tai Windows Hubissa valitset ensimmäisellä käynnillä Set up locally. Myöhemmin velhon saa auki komennolla
openclaw onboard. - macOS: OpenClaw.app kysyy ensimmäisellä käynnillä, asennetaanko Gateway tälle Macille vai yhdistetäänkö jo olemassa olevaan; komentoriviltä sama velho aukeaa komennolla
openclaw onboard. - Linux: aja päätteessä
openclaw onboard. Linux-työpöytäsovelluksessa polku on Get started ja sen jälkeen On this computer.
Yhteydeksi kelpaa palveluntarjoajan rajapinta-avain, valmis kirjautuminen esimerkiksi ChatGPT- tai Claude-tilillä tai koneella itse pyörivä malli. Kirjautumiset käyttävät OAuth-menetelmää, jossa salasanaa ei anneta OpenClaw’lle, vaan kirjautuminen tapahtuu palvelun omalla sivulla ja avustaja saa vain sen luvan, jonka itse hyväksyt. Velho testaa valitun yhteyden oikealla vastauksella ennen kuin asetus tallennetaan, joten virheellinen avain huomataan heti. Jos haluat jatkaa myöhemmin, valitse Skip for now; asetukset saa takaisin komennolla openclaw configure. Samalla komennolla vaihdat mallin myöhemmin — se toimii samoin Windowsilla, macOS:lla ja Linuxilla.
Vaihe 3: Jätä Gateway pyörimään taustalle
Quick start pitää Gatewayta käynnissä siinä päätteessä, josta sen käynnistit: jos suljet ikkunan tai painat Ctrl+C, avustaja lakkaa vastaamasta. Pysyvään käyttöön Gateway kannattaa asentaa taustapalveluksi, joka käynnistyy itsestään.
- Windows: aja
openclaw gateway install. Se perustaa ajastetun tehtävän (Scheduled Task), joka käynnistää Gatewayn automaattisesti ja pitää sen piilossa ilman avointa konsoli-ikkunaa. Jos tehtävän luonti estyy, OpenClaw siirtyy käyttäjän käynnistyskansion pikakuvakkeeseen. - macOS: sama komento
openclaw gateway installasentaa LaunchAgent-palvelun, jonka macOS käynnistää kirjautuessasi. - Linux: sama komento asentaa systemd-käyttäjäpalvelun. Sen tilan voit tarkistaa komennolla
systemctl --user status openclaw-gateway.service.
Tarkista sitten, että Gateway on pystyssä komennolla openclaw gateway status. Vastauksessa näkyy, että Gateway kuuntelee porttia 18789. Portti on kuin oven numero, josta selain ja muut ohjelmat löytävät palvelun. Avaa hallintapaneeli komennolla openclaw dashboard — se toimii samalla tavalla kaikilla kolmella käyttöjärjestelmällä. Jos jokin ei toimi, openclaw doctor käy läpi asennuksen ja kertoo, mikä on vialla.
Vaihe 4: Kokeile avustajaa ja yhdistä viestisovellus
Kirjoita hallintapaneelin keskustelukenttään lyhyt viesti. Jos saat vastauksen, käyttöönotto on valmis. Sen jälkeen avustajan voi tuoda tuttuun viestisovellukseen, jolloin sitä voi käyttää myös puhelimesta.
- Windows: aja PowerShellissä
openclaw channels add telegramja liitä kehotteeseen bottitunnus, jonka saat Telegramin BotFather-palvelusta. Windows Hub -sovellus voi lisäksi liittyä solmuksi, jolloin avustaja voi käyttää koneen ominaisuuksia — kuvakaappauksia, kameraa, ilmoituksia ja komentojen suoritusta — erillisen luvan myöntämisen jälkeen. Hub voi myös tarjota samat ominaisuudet MCP-palvelimena muille ohjelmille. - macOS: sama komento Terminalissa:
openclaw channels add telegram. macOS-sovellus voi samoin liittyä solmuksi ja käyttää koneen ominaisuuksia, kun myönnät luvat kohdassa Dashboard → Settings → This Mac → Permissions. - Linux: sama komento päätteessä:
openclaw channels add telegram. Myös Linux-työpöytäsovellus voi liittyä solmuksi, mutta mikrofonin käyttö sen omassa ikkunassa ei ole vielä tuettu, joten puhekeskustelu kannattaa avata selaimessa.
Solmu tarkoittaa laitetta, joka on liitetty Gatewayhin ja tarjoaa sille omia kykyjään. Turvallisuussyistä jokainen uusi laite ja jokainen uusi komento hyväksytään erikseen: Gatewayn puolella käytössä ovat komennot openclaw devices list ja openclaw devices approve <tunniste>. MCP on puolestaan avoin standardi, jolla tekoälysovellus saa yhteyden ulkoisiin työkaluihin ja tietolähteisiin ilman erillistä räätälöintiä jokaiseen kohteeseen.
Jos jokin menee pieleen
- Komentoa
openclawei löydy — sama syy kaikilla kolmella: npm:n asennuskansio ei ole PATH-ympäristömuuttujassa. Windowsilla lisäänpm prefix -g-komennon tulostama polku järjestelmän ympäristömuuttujiin (Settings → System → Environment Variables). macOS:lla ja Linuxilla lisää tiedostoon~/.zshrctai~/.bashrcriviexport PATH="$(npm prefix -g)/bin:$PATH"ja avaa uusi pääte. - Node.js on liian vanha — asenna uusi versio: Windowsilla
winget install OpenJS.NodeJS.LTS, macOS:llabrew install node, Linuxilla NodeSource-ohjeen mukaisesti. Tarkista versio komennollanode -v. - npm-asennus antaa EACCES-virheen Linuxilla tai macOS:lla — npm:n globaali kansio ei ole kirjoitettavissa. Vaihda se omaan hakemistoon:
npm config set prefix "$HOME/.npm-global"ja lisääexport PATH="$HOME/.npm-global/bin:$PATH"tiedostoon~/.bashrctai~/.zshrc. - Paikallinen asennus epäonnistuu Windowsilla — yleisimpiä syitä ovat puuttuva WSL, estetty virtualisointi tai virustorjuntaohjelman keskeytys. Windows Hub kirjoittaa asennuslokin tiedostoon
%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt. Jos sovellus pyytää hyväksyntää, avoimet pyynnöt näkee komennollaopenclaw devices list. - OpenClaw.app ei käynnisty macOS:lla — sovellus vaatii macOS 15.0:n tai uudemman. Vanhemmalla macOS-versiolla käytä komentoriviasennusta.
- Portti 18789 on jo varattu — vaihda portti komennolla
openclaw configureja käynnistä Gateway uudelleen. Sama komento toimii Windowsilla, macOS:lla ja Linuxilla. - WSL-käyttö sammuu itsestään Windowsilla — ota käyttöön palvelun pitkäikäisyys komennolla
sudo loginctl enable-linger "$(whoami)"ja asenna pakettidbus-x11.
Lähteet
- OpenClaw-dokumentaatio: Getting started, docs.openclaw.ai/start/getting-started.
- OpenClaw-dokumentaatio: Install, docs.openclaw.ai/install.
- OpenClaw-dokumentaatio: Node.js, docs.openclaw.ai/install/node.
- OpenClaw-dokumentaatio: Onboarding (CLI), docs.openclaw.ai/start/wizard.
- OpenClaw-dokumentaatio: Windows, docs.openclaw.ai/platforms/windows.
- OpenClaw-dokumentaatio: macOS app, docs.openclaw.ai/platforms/macos.
- OpenClaw-dokumentaatio: Linux app, docs.openclaw.ai/platforms/linux.
- GitHub: openclaw/openclaw, github.com/openclaw/openclaw.
Vastaa