OpenClaw: mi ez, hogyan telepítsd, és hogyan csatlakoztasd a Telegramhoz

Az OpenClaw tavaly télen jelent meg a hírfolyamomban, amikor a projekt egy hét alatt kétszer változtatta meg a nevét, és több százezer csillagot szerzett a GitHubon. Azóta egyre többen keresnek rá az „openclaw telepítése” és az „openclaw telegram” kifejezésekre.

Az alábbiakban végigveszem a hivatalos dokumentációt: mi ez az eszköz, miben különbözik a Claude Code-tól, hogyan telepítheted Windowsra, macOS-re vagy Linuxra, hogyan választhatsz modellt, és hogyan csatlakoztathatsz egy Telegram-botot. A biztonságról külön is írok, mert az OpenClaw néhány nagy visszhangot kiváltó incidensben is érintett volt.

Ismerd meg, hogyan dolgozhatsz a szolgáltatással az Ailoot dokumentációjában.

Mi az OpenClaw közérthetően?#

Az OpenClaw egy AI-modellt kapcsol a Telegram-botodhoz. A megfelelő eszközök és jogosultságok beállításával üzeneteket összegezhet vagy emlékeztetőt ütemezhet. Az átjáró folyamata és helyi konfigurációja a számítógépeden vagy szervereden fut. Ettől még nem minden beszélgetés helyi: felhőmodell választásakor a kérés és a kapcsolódó beszélgetési kontextus az adott szolgáltatóhoz kerül. Ha Ailooton át csatlakozol, a kérés az Ailooton keresztül jut a választott modellszolgáltatóhoz. Helyi következtetéshez helyi modell és a felhős tartalék kikapcsolása kell; a Telegram-üzenetek továbbra is a Telegramon haladnak át, és az engedélyezett eszközök más szolgáltatásokat is elérhetnek.

A projektet az OpenClaw nyílt forráskódú közössége fejleszti. A GitHub-repozitórium 2025. november 24-én jött létre, és 2026. augusztus 22-én 387 ezer csillaggal és 81 ezer forkkal rendelkezett — az év egyik leggyorsabban növekvő nyílt projektje. A programozási nyelve TypeScript.

A projekt névadási története érdekes, és érdemes ismerni, hogy ne zavarjanak össze a régebbi cikkek. Warelay néven indult, WhatsApp-átjáróként. Később Clawdbot lett belőle. 2026 januárjában az Anthropic védjeggyel kapcsolatos okból névváltoztatást kért, a projekt pedig néhány napig Moltbot néven futott. 2026. január 30-án kapta meg a végleges nevét: OpenClaw. Ha tehát „Clawdbotról” vagy „Moltbotról” szóló útmutatóval találkozol, ugyanarról a projektről van szó; az adott cikk egyszerűen a névváltás előtt készült.

A projekt kabalafigurája Molty, a homár, a „vedlés” (a páncél lecserélése) pedig minden névváltás hivatalos metaforájává vált.

Miben különbözik az OpenClaw a Claude Code-tól és a Hermes Agenttől?#

Folyton kérdeznek erről a különbségről, mert kívülről mindegyik „AI-ügynöknek” tűnik. Íme az összehasonlító táblázat:

Így érdemes olvasni a táblázatot. Fejlesztéshez Claude Code-ot használok: akkor a legerősebb, ha nagy teljesítményű modellre van szükséged, és kóddal dolgozol. Az OpenClaw és a Hermes másra való: olyan ügynökhöz, amely folyamatosan fut, ott van a Telegramon, emlékszik a tegnapi beszélgetésre, és ütemezetten végzi el a feladatait. Az OpenClaw és a Hermes közötti választás árnyaltabb; már készült Hermes-útmutató telepítési és beállítási lépésekkel.

Ha csak eszközt választasz, kezdd az áttekintéssel: mivel programoznak az emberek 2026-ban, és milyen feladatokat érdemes AI-ügynökre bízni. A Claude Code telepítéséről is van egy külön cikkem.

Mire van szükség az OpenClaw telepítése előtt?#

Előre ellenőrizd a Node verzióját — ez az egyetlen szigorú követelmény:

node --version

A 22.22.3+, 24.15+ és 25.9+ verziók támogatottak; a Node 26 ajánlott. Ha a parancsra „command not found” üzenetet kapsz, vagy régi a verzió, ne aggódj: a hivatalos telepítő letölt neked egy új Node-verziót, így nem kell semmit kézzel telepítened.

A következő kérdés a modell. Az OpenClaw önmagában nem gondolkodik: az általad választott modellt hívja meg. Íme a költség szempontjából szóba jövő lehetőségek: Anthropic-, OpenAI- vagy Google-kulcs — ilyenkor a tényleges használat alapján fizetsz a szolgáltatónak; vagy helyi modell Ollamán keresztül — pénzbe nem kerül, de nagy teljesítményű hardvert igényel. Mindkét lehetőséget külön részben tárgyalom alább.

Hogyan telepítheted az OpenClawt macOS-re és Linuxra?#

Az ajánlott módszer a hivatalos telepítő:

1. Futtasd a telepítőt

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

   A szkript felismeri az operációs rendszert, ellenőrzi, hogy van-e Node (és szükség esetén telepíti), felteszi az OpenClawt, majd megnyitja a beállítási varázslót. Ha körülnéznél, mielőtt elindítod a varázslót, add meg ezt a kapcsolót: bash -s -- --no-onboard.

2. Ellenőrizd, hogy minden települt-e

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Az első parancs megmutatja a verziót, a második ellenőrzi a konfigurációt, a harmadik pedig megerősíti, hogy az átjáró fut, és a 18789-es porton figyel.

Ha npm-et használsz, és magad szeretnéd kezelni a telepítést:

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

Itt van egy újabb buktató, amelyről a dokumentáció külön fejezete szól. Az npm 12 alapértelmezés szerint blokkolja a csomagtelepítési szkripteket, és a --allow-scripts=openclaw kapcsoló nélkül a telepítés allowScripts üzenettel leáll. Az npm 11.15-ös és korábbi verzióiban nincs szükség a kapcsolóra — ott még nincs ilyen korlátozás. A verziódat ezzel ellenőrizheted: npm --version.

A második parancs --install-daemon kapcsolója beállítja az automatikus indítást: macOS-en LaunchAgentként, Linuxon systemd-szolgáltatásként. Így az átjáró újraindítás vagy bejelentkezés után elindulhat a szolgáltatáskezelő feltételei szerint. Ez nem akadályozza meg az alvó állapotot, és kikapcsolt gépen nem tartja futva az átjárót. A Telegram-válaszokhoz a gépnek ébren kell maradnia, működő hálózati kapcsolattal; ha alvó vagy kikapcsolt laptop mellett is válaszokra van szükséged, használj folyamatosan működő szervert.

Hogyan telepítheted az OpenClawt Windowsra?#

Az első lehetőség azoknak szól, akik a terminál helyett inkább ablakos alkalmazást használnának. A Windows Hub egy natív OpenClaw-alkalmazás Windows 10 (20H2+) és Windows 11 rendszerre; jelenleg bétaállapotban van. Nyisd meg a Windows Hub kiadások oldalát, és töltsd le a processzorodnak megfelelő telepítőt: OpenClawCompanion-Setup-x64.exe a hagyományos számítógépekhez, vagy arm64 ARM-hoz. Telepítés után az OpenClaw Companion megjelenik a Start menüben, tálcaikonnal, csevegőablakkal és beállításokkal.

Az első indításkor az alkalmazás felajánlja a „Set up locally” lehetőséget — fogadd el. Létrehoz egy OpenClawGateway nevű, különálló WSL-környezetet, telepíti benne az átjárót, és csatlakozik hozzá. A már meglévő Ubuntu-telepítésedhez nem nyúl hozzá, ha van ilyen.

A második lehetőség a PowerShell:

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

Az első sor telepíti az OpenClawt; a második beállítja az automatikus indulást a Windows Feladatütemezőn keresztül. Ha a számítógép házirendje blokkolja a feladat létrehozását, az OpenClaw magától átvált egy tartalék megoldásra: parancsikont helyez az Indítópult mappába, így az átjáró bejelentkezéskor elindul.

A harmadik lehetőség a WSL2, amelyet a dokumentáció a Windows legkompatibilisebb futtatókörnyezetének nevez. Telepítsd az Ubuntut, engedélyezd a systemd-t, majd kövesd az előző rész Linuxra vonatkozó utasításait:

wsl --install -d Ubuntu-24.04

A WSL-en belül engedélyezd a systemd-t az /etc/wsl.conf fájlban (a [boot] szakaszban, a systemd=true sorral), indítsd újra a WSL-t a PowerShellből kiadott wsl --shutdown paranccsal, majd telepítsd az OpenClawt a Linux-paranccsal. Ha a „disztribúció” és a „systemd” semmit sem mond neked, használd a Windows Hubot; az mindezt elvégzi helyetted.

Hogyan válassz modellt, és hogyan fejezd be az első beállítást?#

A modell az asszisztens motorja. A beállítási varázsló szolgáltatók listáját kínálja; íme három gyakorlati lehetőség:

Van egy kényelmes részlet az Anthropic esetében: ha a Claude Code már telepítve van a gépeden, és be vagy jelentkezve, az OpenClaw használhatja azt a bejelentkezést. Először futtasd a gépen a claude auth login parancsot, majd állítsd be az OpenClawt annak használatára:

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

Ha az átjáró háttérszolgáltatásként fut (így működik a --install-daemon kapcsolóval), a kulcsnak elérhetőnek kell lennie a szolgáltatás számára. Ehhez tedd a ~/.openclaw/.env fájlba — a varázsló ezt elvégzi helyetted, így nem kell kézzel szerkesztened a fájlt. A módosítások után indítsd újra, majd ellenőrizd:

openclaw gateway restart
openclaw models status

Ha gondot okoz a fizetés, az Ollama-ról szóló részben bemutatott helyi modell a megfelelő választás.

Hogyan csatlakoztathatod az OpenClawt a Telegramhoz?#

A Telegram a leggyorsabban csatlakoztatható csatorna: csak egy bot tokenje kell, üzleti fiók ellenőrzése nélkül. A dokumentáció szerint ez a legegyszerűbb módja annak, hogy telefonról üzenetet küldj az asszisztensednek. Íme a teljes folyamat:

1. Hozz létre botot a BotFatherrel

   Nyiss Telegram-beszélgetést a @BotFatherrel (ellenőrizd, hogy pontosan ez-e a felhasználónév — sok a hamis fiók), küldd el a /newbot parancsot, majd válassz nevet és bot végződésű felhasználónevet. Válaszul kapsz egy ilyen tokent: 123456789:ABCdef... — ez a bot kulcsa, ezért úgy őrizd, mint egy jelszót.

2. Írd be a tokent az OpenClawba

   A legegyszerűbb módszer a varázsló: futtasd az openclaw configure parancsot, és válaszd ki a Telegram-csatornát. Kézzel a channels.telegram.botToken beállításban vagy a TELEGRAM_BOT_TOKEN környezeti változóban adhatod meg. A dokumentáció külön kiemeli, hogy az openclaw channels login telegram parancs nem létezik; a Telegram kizárólag tokennel csatlakozik.

3. Indítsd el az átjárót, és írj a botnak

   openclaw gateway
   

   Nyisd meg a botot a Telegramban, és küldj neki valamit. Egy nyolc karakteres párosítási kóddal válaszol. Ez egy biztonsági intézkedés: az üzenetek feldolgozása csak a feladó jóváhagyása után kezdődik meg.

4. Hagyd jóvá saját magadat

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   A kód egy óráig érvényes, ezért ne várj túl sokáig. Az első jóváhagyott feladó automatikusan a kiemelt jogosultságú parancsok tulajdonosa lesz.

Két trükkös pont van, amibe sokan belefutnak.

Az első a csoportok kérdése. Az OpenClaw alapértelmezés szerint minden csoportot blokkol: a botot kifejezetten engedélyezned kell a channels.telegram.groups beállításban, és a csoportban bekapcsolva kell hagynod a requireMention: true módot. Így csak akkor válaszol, ha a felhasználónevével szólítják meg, és nem ugrik bele az általános beszélgetésbe. A Telegramnak saját botvédelmi módja is van: a bot csoportban alapértelmezés szerint csak a parancsokat látja. Kapcsold ki a @BotFatheren keresztül a /setprivacy paranccsal. A módosítás után el kell távolítanod a botot a csoportból, majd újra hozzá kell adnod; különben a Telegram nem alkalmazza a beállítást.

A második: ne nyisd meg a hozzáférést mindenkinek. A beállítások között szerepel a dmPolicy: "open" mód, a hozzáférési listában csillaggal: a botot a felhasználóneve alapján megtaláló bárki utasíthatja. Személyes asszisztensnél ez közvetlen utat jelent ahhoz, hogy másnak is irányítást adj a géped fölött. Hagyd bekapcsolva a kódos párosítást, vagy írd be a numerikus azonosítódat az allowFrom mezőbe.

Hogyan futtathatod az OpenClawt helyi modellel, Ollamán keresztül?#

Ez a megoldás a saját hardvereden tartja a modell következtetését, ha kizárólag helyi útvonalat választasz felhős tartalék nélkül, és nem igényel fizetős modellvégpontot. Ettől még nem lesz a teljes Telegram-munkafolyamat helyi: az üzenetek a Telegramon haladnak át, és az engedélyezett online eszközök más szolgáltatásoknak küldhetnek adatot.

1. Telepítsd az Ollamát

   Töltsd le a telepítőt az ollama.com/download oldalról — macOS-, Windows- és Linux-verzió is elérhető.

2. Tölts le egy modellt

   ollama pull gemma4
   

3. Csatlakoztasd az Ollamát az OpenClawhoz

   openclaw onboard
   

   Válaszd ki az Ollama szolgáltatót és egy módot: Local only (csak a saját modellek), Cloud only (az ollama.com modelljei) vagy Cloud + Local. A varázsló megtalálja a helyi szervert, és megjeleníti a telepített modelleket.

4. Ellenőrzés

   openclaw models list --provider ollama
   

Íme az őszinte kiegészítés, amely nélkül ez a rész reklámnak hangzana. Az OpenClaw dokumentációja egyenesen kimondja, hogy a helyi modell kényelmes, ügynökszerű használatához két, teljesen felszerelt Mac Studio szintű hardver szükséges, míg egy 24 GB-os grafikus kártya csak könnyű kéréseket tud kezelni, késleltetéssel. A kicsi és erősen tömörített modellek levágják a kontextust, és kevésbé állnak ellen a mások szövegébe rejtett rosszindulatú utasításoknak. A mindennapokban ez azt jelenti: egy jó laptopon futó helyi modell elég ahhoz, hogy „kipróbáld és megértsd, miről szól”, de az asszisztens eszközeit használó napi munkához a felhőmodell még mindig sokkal megbízhatóbb.

A dokumentáció egy újabb figyelmeztetést is ad azoknak, akik WSL2 + Ollama + NVIDIA GPU összeállítást készítenek: a hivatalos Linuxos Ollama-telepítő „always” újraindítási házirenddel engedélyezi az automatikus indítást, ami GPU-val futó WSL2 esetén újraindítási ciklusba küldheti a gépet. A megoldás a szolgáltatás automatikus indításának letiltása. Ha ezzel találkozol, nézd meg a dokumentáció Ollama-oldalán a hibaelhárítási részt.

Mennyire biztonságos az OpenClaw futtatása?#

A fő gondolattal kezdem, amelyet nem mindenki ért meg. Az OpenClaw hozzáfér a gépedhez: a fájlokhoz, a parancsokhoz és a böngészőhöz. A dokumentáció világosan fogalmaz: a projektet egyetlen megbízható felhasználónak tervezték, és nem szabad kívülállóknak hozzáférést adnod a botodhoz. Ha valaki üzenetet küldhet az ügynöködnek, a számítógépeden végzett műveletekre is használhatja.

A gyakorlati minimum:

1. Hagyd bekapcsolva a kódos párosítást, vagy használj hozzáférési listát — ennek beállításáról a Telegram-részben írtam.
2. Ne tedd kívülről elérhetővé az átjárót, hacsak nincs rá szükséged. Alapértelmezés szerint csak a gépeden figyel; hagyd így.
3. Minden konfigurációmódosítás után futtasd a beépített ellenőrzést:

openclaw security audit

Ellenőrzi a nyitott hozzáféréseket, a túl széles eszközjogosultságokat, a gyenge tokeneket és a nyitott portokat. A --fix kapcsolóval egyes problémák automatikusan javíthatók.

Külön megjegyzés a csalásokról — ez nem elméleti veszély. Amikor a projekt 2026 januárjában pánikszerűen nevet változtatott, a névvadász botok másodperceken belül átvették a régi címeket, és azonnal kriptotárcát tettek közzé; hamis „OpenClaw-fejlesztők” kezdtek tokenes csalást hirdetni. Ebből két szigorú szabály következik. Az OpenClawt kizárólag a openclaw.ai vagy a github.com/openclaw/openclaw címről töltsd le. A projektnek nincs kriptovalutája: bármilyen „OpenClaw token” csalás. Semmilyen körülmények között ne küldj rá pénzt.

Mire képes az OpenClaw telepítés után?#

Íme, mit próbálnék ki, ebben a sorrendben:

1. Átjáró és modell. Futtasd az openclaw gateway status parancsot, majd nyisd meg az openclaw dashboard felületet. A betöltött panel a Control UI elérhetőségét igazolja. Küldd a csevegésben: „Válaszolj ezzel: model connection test”, és ellenőrizd az AI-válasz megérkezését; az oldal betöltése önmagában nem teszteli a modellt.
2. Telegram és a kívánt feladat. A bot beállítása és a saját párosításod jóváhagyása után küldj új üzenetet a botnak a Telegramon, és ellenőrizd, hogy ott megérkezik-e a válasza. Ezután próbálj egy korlátozott, látható eredményű feladatot, például egy ártalmatlan, olvasásra engedélyezett tesztmappa összegzését. Emlékeztetőnél külön ellenőrizd az elmentett ütemezést és a kézbesített emlékeztetőt. Az irányítópulton kapott válasz nem igazolja a Telegram-kézbesítést vagy az ütemezett végrehajtást.
3. Ütemezett feladatok. Az asszisztens ütemezetten futtathat feladatokat — például reggeli összefoglalót küldhet Telegramon, vagy rendszeresen ellenőrizheti az e-maileket. Ezért kell az átjárót éjjel-nappal futtatnod.
4. Memória. Az OpenClaw hagyományos Markdown-fájlokban tárolja a hosszú távú memóriát a munkamappájában: ki vagy, hogyan válaszoljon neked, és mire emlékszik a korábbi beszélgetésekből. Te magad is megnyithatod és elolvashatod a fájlokat — nincs fekete doboz.
5. Készségek. A rendszer készségekkel és bővítményekkel bővíthető. Mások készsége mások kódját jelenti a gépeden, ezért telepítés előtt ellenőrizd őket.

Egy szabályt érdemes betartani: ne kapcsolj be mindent egyszerre. Először legyen egy stabil beszélgetésed, aztán jöhet a Telegram, majd az ütemezés. Így minden hiba a maga lépésénél derül ki, nem pedig úgy, hogy „minden elromlott, és nem tudom, miért”.

Mit tegyél, ha hiba történik a telepítés során?#

Nézzünk meg három gyakori helyzetet.

Közvetlenül a telepítés után: „openclaw: command not found”. Szinte mindig útvonalproblémáról van szó: a globális npm-csomagok mappája nincs benne a terminál PATH változójában. A dokumentáció a következő diagnosztikai parancsokat javasolja:

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

A második parancs által megadott útvonalnak szerepelnie kell a harmadik kimenetében. Ha nincs benne, add hozzá a shell beállításaihoz, vagy egyszerűen zárd be és nyisd meg újra a terminált: előfordul, hogy a Node útvonala csak egy új munkamenetben jelenik meg a telepítés után.

Az átjáró fut, de az asszisztens néma. A dokumentáció GYIK-jában említett tünet: nincs válasz az első üzenetre, a tokenszámláló pedig nullán áll. Ez azt jelenti, hogy az ügynök el sem indult — leggyakrabban a modell nincs konfigurálva. Ellenőrizd ebben a sorrendben:

openclaw gateway restart
openclaw status
openclaw models status

Ha a modell konfigurálva van, de továbbra sincs válasz, az openclaw logs --follow megmutatja az élő naplót, és azt, hol akad el a folyamat.

A Telegram-bot nem válaszol. Ellenőrizd ebben a sorrendben: a token ahhoz a bothoz tartozik, amelynek írsz; az átjáró fut (openclaw gateway status); és jóváhagytad a párosítást (openclaw pairing list telegram). A párosítási kód egy óráig érvényes — ha tegnap írtál a botnak, írj neki újra, és hagyd jóvá az új kódot.

Ha teljesen elakadtál, a dokumentáció egy váratlan, de ésszerű megoldást javasol: add át a diagnosztikai adatokat egy olyan helyi AI-ügynöknek, amely hozzáfér a gépedhez. A Claude Code vagy a Codex az openclaw status --all és az openclaw doctor kimenete alapján gyorsabban megértheti a konfigurációt, mint az ügyfélszolgálati csevegés. Körbeértünk — az AI megjavítja az AI-t.

Mit kérdeznek még az emberek az OpenClawról?#

Ismerd meg az Ailootot.