OpenClaw: mikä se on, kuinka se asennetaan ja yhdistetään Telegramiin

OpenClaw ilmestyi syötteeseeni viime talvena, kun projekti vaihtoi nimeään kahdesti viikossa ja keräsi satojatuhansia tähtiä GitHubissa. Sen jälkeen yhä useammat ovat etsineet aiheilla ”openclaw installation” ja ”openclaw telegram”.

Käyn alla läpi virallisen dokumentaation: mikä tämä työkalu on, miten se eroaa Claude Codesta, kuinka se asennetaan Windowsiin, macOS:ään tai Linuxiin, kuinka valitaan malli ja kuinka yhdistetään Telegram-botti. Käsittelen myös tietoturvaa erikseen, sillä OpenClaw on ollut osallisena parissa paljon huomiota saaneessa tapauksessa.

Lue, kuinka palvelua käytetään Ailootin dokumentaatiosta.

Mikä OpenClaw on selkokielellä?#

OpenClaw yhdistää tekoälymallin Telegram-bottiisi. Kun tarvittavat työkalut ja oikeudet on määritetty, se voi tiivistää viestejä tai ajastaa muistutuksen. Yhdyskäytäväprosessi ja paikalliset asetukset toimivat tietokoneellasi tai palvelimellasi. Tämä ei tee kaikista keskusteluista paikallisia: pilvimallin valitseminen lähettää pyynnön ja tarvittavan keskustelukontekstin kyseiselle palveluntarjoajalle. Ailootin kautta yhdistettäessä pyyntö kulkee Ailootin kautta valitulle mallipalveluntarjoajalle. Paikallinen päättely vaatii paikallisen mallin ilman pilvivaravaihtoehtoa; Telegram-viestit kulkevat silti Telegramin kautta, ja käytössä olevat työkalut voivat olla yhteydessä muihin palveluihin.

Projektia kehittää avoimen lähdekoodin OpenClaw-yhteisö. GitHub-repositorio luotiin 24. marraskuuta 2025, ja 22. elokuuta 2026 sillä oli 387 tuhatta tähteä ja 81 tuhatta forkia – yksi vuoden nopeimmin kasvavista avoimista projekteista. Ohjelmointikieli on TypeScript.

Projektilla on hauska nimihistoria, joka kannattaa tuntea, jotta vanhemmat artikkelit eivät hämmentäisi. Se alkoi Warelayna, WhatsApp-yhdyskäytävänä. Sitten siitä tuli Clawdbot. Tammikuussa 2026 Anthropic pyysi nimen vaihtamista tavaramerkin vuoksi, ja projekti käytti pari päivää nimeä Moltbot. 30. tammikuuta 2026 se sai lopullisen nimensä: OpenClaw. Jos siis törmäät ”Clawdbot”- tai ”Moltbot”-ohjeisiin, kyseessä on sama projekti; artikkelit vain kirjoitettiin ennen uudelleennimeämistä.

Projektin maskotti on hummeri Molty, ja ”kuoren vaihtamisesta” tuli jokaisen uudelleennimeämisen virallinen vertauskuva.

Miten OpenClaw eroaa Claude Codesta ja Hermes Agentista?#

Minulta kysytään tästä erosta jatkuvasti, sillä ulkopuolelta kaikki näyttävät ”tekoälyagenteilta”. Tässä vertailutaulukko:

Näin taulukkoa kannattaa lukea. Käytän Claude Codea ohjelmistokehitykseen: se on parhaimmillaan silloin, kun tarvitset tehokkaan mallin ja työskentelet koodin parissa. OpenClaw ja Hermes ovat eri tarkoitukseen: agentille, joka toimii koko ajan, hengailee Telegramissa, muistaa eilisen keskustelun ja hoitaa tehtäviä aikataulun mukaan. OpenClawin ja Hermeksen valinta on hienovaraisempi; saatavilla on jo Hermes-opas asennukseen ja määritykseen.

Jos olet vasta valitsemassa työkalua, aloita yleiskatsauksesta: millaisilla työkaluilla ihmiset koodaavat vuonna 2026 ja mitä tehtäviä kannattaa delegoida tekoälyagentille. Olen kirjoittanut myös erillisen artikkelin Claude Coden asentamisesta.

Mitä tarvitset ennen OpenClawin asentamista?#

Tarkista Node-versio etukäteen – se on ainoa ehdoton vaatimus:

node --version

Tuetut versiot ovat 22.22.3+, 24.15+ ja 25.9+; Node 26 on suositeltu. Jos komento palauttaa ”command not found” tai versio on vanha, älä huoli: virallinen asennusohjelma lataa sinulle tuoreen Node-version, joten sinun ei tarvitse asentaa mitään käsin.

Jäljellä on kysymys mallista. OpenClaw ei ajattele itsekseen: se kutsuu valitsemaasi mallia. Tässä ovat vaihtoehdot kustannusten kannalta: Anthropicin, OpenAI:n tai Googlen avain – maksat palveluntarjoajalle todellisesta käytöstä; tai paikallinen malli Ollaman kautta – rahallisesti ilmainen, mutta laitteistolle vaativa. Käsittelen molemmat vaihtoehdot alla omissa osioissaan.

Kuinka OpenClaw asennetaan macOS:ään ja Linuxiin?#

Suositeltu tapa on käyttää virallista asennusohjelmaa:

1. Suorita asennusohjelma

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

   Skripti tunnistaa käyttöjärjestelmäsi, tarkistaa Noden (ja asentaa sen tarvittaessa), asentaa OpenClawin ja avaa sitten ohjatun asetustoiminnon. Jos haluat tutustua ohjelmaan ennen ohjatun toiminnon käynnistämistä, lisää lippu: bash -s -- --no-onboard.

2. Tarkista, että kaikki asentui

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Ensimmäinen komento näyttää version, toinen tarkistaa määritykset ja kolmas vahvistaa, että yhdyskäytävä toimii ja kuuntelee porttia 18789.

Jos käytät npm:ää ja haluat hallita asennusta itse:

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

Tässä on tuore sudenkuoppa, jota käsitellään dokumentaation erillisessä luvussa. npm 12 estää oletuksena pakettien asennusskriptit, ja ilman lippua --allow-scripts=openclaw asennus keskeytyy allowScripts-viestiin. npm 11.15:ssä ja sitä vanhemmissa versioissa lippua ei tarvita – tällaista rajoitusta ei vielä ole. Tarkista versiosi komennolla: npm --version.

Toisen komennon lippu --install-daemon määrittää automaattisen käynnistyksen: macOS:ssä se on LaunchAgent ja Linuxissa systemd-palvelu. Se käynnistää yhdyskäytävän uudelleenkäynnistyksen tai kirjautumisen jälkeen palvelunhallinnan ehtojen mukaisesti. Se ei estä lepotilaa eikä pidä yhdyskäytävää käynnissä sammutetulla koneella. Telegram-vastaukset edellyttävät, että kone pysyy hereillä ja verkkoyhteydessä. Käytä jatkuvasti päällä olevaa palvelinta, jos tarvitset vastauksia kannettavan nukkuessa tai ollessa sammutettuna.

Kuinka OpenClaw asennetaan Windowsiin?#

Ensimmäinen vaihtoehto sopii niille, jotka suosivat ikkunoita päätteen sijaan. Windows Hub on natiivi OpenClaw-sovellus Windows 10:lle (20H2+) ja Windows 11:lle, ja se on tällä hetkellä beetavaiheessa. Siirry Windows Hubin julkaisut-sivulle ja lataa prosessorillesi sopiva asennusohjelma: OpenClawCompanion-Setup-x64.exe tavallisille tietokoneille tai arm64 ARM-laitteille. Asennuksen jälkeen OpenClaw Companion näkyy Käynnistä-valikossa, ja siinä on ilmoitusalueen kuvake, chat-ikkuna ja asetukset.

Ensimmäisellä käynnistyskerralla sovellus tarjoaa vaihtoehdon ”Set up locally” – hyväksy se. Sovellus luo oman WSL-ympäristön nimeltä OpenClawGateway, asentaa yhdyskäytävän sen sisään ja muodostaa siihen yhteyden. Se ei koske nykyiseen Ubuntu-asennukseesi, jos sinulla on sellainen.

Toinen vaihtoehto on PowerShellin kautta:

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

Ensimmäinen rivi asentaa OpenClawin; toinen määrittää automaattisen käynnistyksen Windows Task Schedulerin kautta. Jos tietokoneesi käytäntö estää tehtävien luomisen, OpenClaw siirtyy automaattisesti vararatkaisuun: käynnistyskansion pikakuvakkeeseen, jolloin yhdyskäytävä käynnistyy sisäänkirjautuessasi.

Kolmas vaihtoehto on WSL2, jota dokumentaatio kutsuu Windowsin yhteensopivimmaksi suoritusympäristöksi. Asenna Ubuntu, ota systemd käyttöön ja noudata sitten edellisen osion Linux-ohjeita:

wsl --install -d Ubuntu-24.04

Ota WSL:ssä systemd käyttöön tiedostossa /etc/wsl.conf ([boot]-osiossa rivillä systemd=true), käynnistä WSL uudelleen suorittamalla wsl --shutdown PowerShellissä ja asenna sitten OpenClaw Linux-komennolla. Jos sanat ”jakelu” ja ”systemd” eivät sano sinulle mitään, käytä Windows Hubia; se hoitaa kaiken tämän puolestasi.

Kuinka valitset mallin ja suoritat alkuasetukset loppuun?#

Malli on avustajan moottori. Ohjatussa asetustoiminnossa on luettelo palveluntarjoajista; tässä on kolme käytännöllistä vaihtoehtoa:

Anthropicissa on kätevä yksityiskohta: jos Claude Code on jo asennettu koneellesi ja olet kirjautunut sisään, OpenClaw voi käyttää kyseistä kirjautumista. Suorita ensin koneella claude auth login ja pyydä sitten OpenClawia käyttämään sitä:

openclaw models auth login --provider anthropic --method cli --set-default

Jos yhdyskäytävä toimii taustapalveluna (kuten se tekee lipun --install-daemon kanssa), avaimen on oltava palvelun käytettävissä. Lisää se tiedostoon ~/.openclaw/.env – ohjattu toiminto tekee tämän puolestasi, joten tiedostoa ei tarvitse muokata käsin. Käynnistä muutosten jälkeen uudelleen ja tarkista tila:

openclaw gateway restart
openclaw models status

Jos maksaminen on hankalaa, paikallinen malli Ollama-osiosta on sopiva vaihtoehto.

Kuinka yhdistät OpenClawin Telegramiin?#

Telegram on nopein yhdistettävä kanava: tarvitset vain botin tokenin, eikä yritystilin vahvistusta vaadita. Dokumentaation mukaan se on helpoin tapa aloittaa viestittely avustajasi kanssa puhelimesta. Tässä koko prosessi:

1. Luo botti BotFatherilla

   Avaa Telegram-keskustelu käyttäjän @BotFather kanssa (varmista, että käyttäjänimi on täsmälleen tämä – väärennöksiä on paljon), lähetä /newbot ja valitse nimi sekä käyttäjänimi, joka päättyy sanaan bot. Saat vastauksena tokenin, esimerkiksi 123456789:ABCdef... – se on bottisi avain, joten säilytä sitä kuin salasanaa.

2. Syötä token OpenClawiin

   Helpoin tapa on käyttää ohjattua toimintoa: suorita openclaw configure ja valitse Telegram-kanava. Vaihtoehtoisesti voit käyttää asetusta channels.telegram.botToken tai ympäristömuuttujaa TELEGRAM_BOT_TOKEN. Dokumentaatiossa sanotaan erikseen, ettei komentoa openclaw channels login telegram ole olemassa; Telegram yhdistetään vain tokenin avulla.

3. Käynnistä yhdyskäytävä ja lähetä botille viesti

   openclaw gateway
   

   Avaa bottisi Telegramissa ja lähetä sille jotakin. Se vastaa kahdeksanmerkkisellä parituskoodilla. Tämä on suojatoimi: viestejä ei käsitellä, ennen kuin hyväksyt lähettäjän.

4. Hyväksy itsesi

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Koodi on voimassa tunnin, joten älä odota liian pitkään. Ensimmäisestä hyväksytystä lähettäjästä tulee automaattisesti etuoikeutettujen komentojen omistaja.

Kaksi hankalaa kohtaa aiheuttaa usein ongelmia.

Ensimmäinen liittyy ryhmiin. OpenClaw estää kaikki ryhmät oletuksena: sinun on sallittava botti erikseen asetuksissa channels.telegram.groups ja jätettävä tila requireMention: true käyttöön ryhmässä. Silloin botti vastaa vain, kun sitä kutsutaan käyttäjänimellä, eikä se sekaannu yleiseen keskusteluun. Telegramissa on myös oma bottien yksityisyystila: ryhmässä botti näkee oletuksena vain komennot. Poista tila käytöstä komennolla /setprivacy BotFatherin kautta. Muutoksen jälkeen botti täytyy poistaa ryhmästä ja lisätä sinne uudelleen, muuten Telegram ei ota asetusta käyttöön.

Toinen huomio on, ettei pääsyä pidä avata kaikille. Asetuksissa on tila dmPolicy: "open", jonka käyttöoikeusluettelossa on asteriski: kuka tahansa, joka löytää botin käyttäjänimen perusteella, voi ohjata sitä. Henkilökohtaisen avustajan tapauksessa tämä antaa suoraan jollekulle toiselle mahdollisuuden hallita konettasi. Pidä koodilla tehtävä paritus käytössä tai lisää numeerinen tunnuksesi kohtaan allowFrom.

Kuinka OpenClawia käytetään paikallisella Ollama-mallilla?#

Tämä vaihtoehto pitää mallin päättelyn omalla laitteistollasi, kun valitset vain paikallisen reitin ilman pilvivaravaihtoehtoa, eikä se tarvitse maksullista mallipäätepistettä. Koko Telegram-työnkulku ei silti ole paikallinen: viestit kulkevat Telegramin kautta, ja käytössä olevat verkkotyökalut voivat lähettää tietoja muihin palveluihin.

1. Asenna Ollama

   Lataa asennusohjelma osoitteesta ollama.com/download – saatavilla on versiot macOS:lle, Windowsille ja Linuxille.

2. Lataa malli

   ollama pull gemma4
   

3. Yhdistä Ollama OpenClawiin

   openclaw onboard
   

   Valitse Ollama-palveluntarjoaja ja tila: Local only (omat mallisi), Cloud only (ollama.comin mallit) tai Cloud + Local. Ohjattu toiminto löytää paikallisen palvelimen ja näyttää asennetut mallit.

4. Tarkista

   openclaw models list --provider ollama
   

Tässä on rehellinen varaus, jota ilman tämä osio kuulostaisi mainokselta. OpenClawin dokumentaatiossa sanotaan suoraan, että paikallisen mallin mukava käyttö agenttina vaatii kahden täyteen varustetun Mac Studion tasoista laitteistoa, kun taas 24 Gt:n näytönohjain pystyy käsittelemään vain kevyitä pyyntöjä viiveellä. Pienet ja voimakkaasti pakatut mallit katkaisevat kontekstia ja kestävät heikommin muiden tekstiin piilotettuja haitallisia ohjeita. Arkikielellä: paikallinen malli hyvällä kannettavalla riittää ”kokeiluun ja sen ymmärtämiseen, mistä on kyse”, mutta pilvimalli on edelleen paljon luotettavampi päivittäiseen työskentelyyn työkaluja käyttävän avustajan kanssa.

Vielä yksi varoitus dokumentaatiosta kaikille, jotka rakentavat WSL2 + Ollama + NVIDIA GPU -kokoonpanoa: virallinen Linuxin Ollama-asennusohjelma ottaa automaattisen käynnistyksen käyttöön ”always”-uudelleenkäynnistyskäytännöllä, ja WSL2:ssa GPU:n kanssa tämä voi aiheuttaa koneelle uudelleenkäynnistyssilmukan. Ratkaisu on poistaa palvelun automaattinen käynnistys käytöstä. Jos törmäät tähän ongelmaan, katso dokumentaation Ollama-sivun vianmääritysosio.

Kuinka turvallista OpenClawin käyttö on?#

Aloitan pääasiasta, jota kaikki eivät ymmärrä. OpenClaw pääsee käsiksi koneeseesi: tiedostoihin, komentoihin ja selaimeen. Dokumentaatio ilmaisee asian suoraan: projekti on suunniteltu yhdelle luotetulle käyttäjälle, eikä botille pidä antaa ulkopuolisten pääsyä. Jos joku voi lähettää viestejä agentillesi, hän voi käyttää sitä toimiakseen tietokoneellasi.

Käytännön vähimmäistoimet:

1. Pidä koodilla tehtävä paritus käytössä tai käytä käyttöoikeusluetteloa – kerroin sen määrittämisestä Telegram-osiossa.
2. Älä altista yhdyskäytävää ulkopuolelle, ellet tarvitse sitä. Oletuksena se kuuntelee vain omalla koneellasi; pidä se sellaisena.
3. Suorita sisäänrakennettu tarkistus kaikkien määritysmuutosten jälkeen:

openclaw security audit

Se tarkistaa, onko käyttö avoin, työkalujen käyttöoikeudet liian laajat, tokenit heikkoja tai portit näkyvissä. Lipulla --fix osa havainnoista voidaan korjata automaattisesti.

Erillinen huomio huijauksista – tämä ei ole teoreettinen riski. Kun projekti vaihtoi nimeään hätiköidysti tammikuussa 2026, kaappaajabotit valtasivat vanhat osoitteet sekunneissa ja julkaisivat heti kryptolompakon; vale-”OpenClaw-kehittäjät” alkoivat mainostaa token-huijausta. Tästä seuraa kaksi ehdotonta sääntöä. Lataa OpenClaw vain osoitteesta openclaw.ai tai github.com/openclaw/openclaw. Projektilla ei ole kryptovaluuttaa: mikä tahansa ”OpenClaw-token” on huijaus. Älä lähetä sille rahaa missään olosuhteissa.

Mitä OpenClaw voi tehdä asennuksen jälkeen?#

Kokeilisin seuraavia asioita tässä järjestyksessä:

1. Yhdyskäytävä ja malli. Suorita openclaw gateway status ja avaa sitten openclaw dashboard. Ladattu paneeli vahvistaa Control UI:n olevan tavoitettavissa. Lähetä sen keskusteluun ”Vastaa tekstillä: model connection test” ja tarkista AI-vastauksen saapuminen; sivun lataaminen ei yksin testaa mallia.
2. Telegram ja tarkoitettu tehtävä. Määritä botti ja hyväksy oma parituksesi, lähetä sitten uusi viesti kyseiselle botille Telegramissa ja tarkista vastauksen saapuminen sinne. Kokeile sen jälkeen yhtä rajattua tehtävää, jolla on näkyvä tulos, kuten yhteenvedon tekemistä vaarattomasta testikansiosta, jonka lukemiseen olet antanut luvan. Tarkista muistutuksesta erikseen tallennettu aikataulu ja toimitettu muistutus. Kojelaudan vastaus ei osoita Telegram-toimitusta tai ajastettua suoritusta.
3. Ajastetut tehtävät. Avustaja voi suorittaa töitä aikataulun mukaan – esimerkiksi aamuyhteenvedon Telegramissa tai säännölliset sähköpostitarkistukset. Siksi yhdyskäytävän pitää olla käynnissä ympäri vuorokauden.
4. Muisti. OpenClaw tallentaa pitkäaikaisen muistin tavallisina Markdown-tiedostoina työkansioonsa: kuka olet, kuinka sinulle vastataan ja mitä se on muistanut aiemmista keskusteluista. Voit avata tiedostot ja lukea ne itse – mitään mustaa laatikkoa ei ole.
5. Taidoilla laajentaminen. Projektiin on saatavilla valmiita taitoja ja lisäosia. Jonkun muun taito on jonkun muun koodia koneellasi, joten tarkista se huolellisesti ennen käyttöä.

Tässä on yksi sääntö: älä ota kaikkea käyttöön kerralla. Aloita yhdellä vakaalla keskustelulla, sitten Telegramilla ja vasta sen jälkeen aikatauluilla. Näin jokainen ongelma tulee esiin omassa vaiheessaan sen sijaan, että ”kaikki meni rikki, enkä tiedä missä”.

Mitä tehdä, jos asennus menee pieleen?#

Käydään läpi kolme tavallista tilannetta.

”openclaw: command not found” heti asennuksen jälkeen. Syynä on lähes aina polkuongelma: globaalien npm-pakettien kansio puuttuu päätteesi PATH-muuttujasta. Dokumentaation diagnostiikkakomennot ovat:

node -v
npm prefix -g
echo "$PATH"

Toisen komennon polun pitäisi näkyä kolmannen tuloksessa. Jos se ei näy, lisää se komentotulkin asetuksiin tai sulje pääte ja avaa se uudelleen: joskus Node-polku tulee näkyviin vasta uudessa istunnossa asennuksen jälkeen.

Yhdyskäytävä toimii, mutta avustaja on hiljaa. Dokumentaation UKK:ssa kuvattu oire: ensimmäiseen viestiin ei tule vastausta ja tokenlaskuri näyttää nollaa. Tämä tarkoittaa, ettei agentti ole edes käynnistynyt – useimmiten mallia ei ole määritetty. Tarkista asiat tässä järjestyksessä:

openclaw gateway restart
openclaw status
openclaw models status

Jos malli on määritetty eikä vastausta silti tule, openclaw logs --follow näyttää reaaliaikaisen lokin ja sen, missä toiminta jumittuu.

Telegram-botti ei vastaa. Tarkista tässä järjestyksessä: kuuluuko token botille, jolle viestit; onko yhdyskäytävä käynnissä (openclaw gateway status); ja onko parituksesi hyväksytty (openclaw pairing list telegram). Parituskoodi on voimassa tunnin – jos lähetit botille viestin eilen, lähetä uusi viesti ja hyväksy uusi koodi.

Jos olet täysin jumissa, dokumentaatio ehdottaa jotakin odottamatonta mutta järkevää: anna diagnostiikkatiedot paikalliselle tekoälyagentille, joka näkee koneesi. Claude Code tai Codex pystyy ymmärtämään määrityksen tukikeskustelua nopeammin, kun sille antaa komentojen openclaw status --all ja openclaw doctor tulosteet. Kehä sulkeutuu – tekoäly korjaa tekoälyä.

Mitä muuta OpenClawista kysytään?#

Tutustu Ailootiin.