OpenClaw: kaj je, kako ga namestiti in povezati s Telegramom

OpenClaw se je lani pozimi pojavil v mojem viru, ko je projekt v enem tednu dvakrat spremenil ime in na GitHubu pridobil več sto tisoč zvezdic. Od takrat vse več ljudi išče »namestitev OpenClaw« in »OpenClaw Telegram«.

V nadaljevanju obravnavam uradno dokumentacijo: kaj je to orodje, kako se razlikuje od Claude Code, kako ga namestiti v Windows, macOS ali Linux, kako izbrati model in kako povezati bota Telegram. Ločeno obravnavam tudi varnost, saj je bil OpenClaw povezan z nekaj odmevnimi incidenti.

V dokumentaciji Ailoot izveste, kako uporabljati storitev.

Kaj je OpenClaw v preprostem jeziku?#

OpenClaw poveže model umetne inteligence z vašim botom v Telegramu. Z ustreznimi orodji in dovoljenji lahko povzame sporočila ali načrtuje opomnik. Proces prehoda in njegova lokalna konfiguracija delujeta v vašem računalniku ali strežniku. To ne pomeni, da so vsi pogovori lokalni: ko izberete model v oblaku, se zahteva in ustrezen kontekst pogovora pošljeta izbranemu ponudniku. Pri povezavi prek Ailoot gre zahteva skozi Ailoot do izbranega ponudnika modela. Lokalno izvajanje zahteva lokalni model brez nadomestne uporabe oblaka; sporočila Telegram še vedno potujejo prek Telegrama, omogočena orodja pa lahko dostopajo do drugih storitev.

Projekt razvija odprtokodna skupnost OpenClaw. Repozitorij na GitHubu je bil ustvarjen 24. novembra 2025, 22. avgusta 2026 pa je imel 387 tisoč zvezdic in 81 tisoč forkov — eden najhitreje rastočih odprtih projektov leta. Programski jezik je TypeScript.

Zgodovina imen projekta je zanimiva in jo je vredno poznati, da vas starejši članki ne bodo zmedli. Začel se je kot Warelay, prehod za WhatsApp. Nato se je imenoval Clawdbot. Januarja 2026 je Anthropic zaradi blagovne znamke zahteval spremembo imena, zato se je projekt nekaj dni imenoval Moltbot. 30. januarja 2026 je dobil končno ime: OpenClaw. Če naletite na navodila za »Clawdbot« ali »Moltbot«, gre za isti projekt; članki so bili napisani pred preimenovanjem.

Maskota projekta je Molty, jastog, »levitev« (menjava oklepa) pa je postala uradna prispodoba za vsako preimenovanje.

Kako se OpenClaw razlikuje od Claude Code in Hermes Agent?#

O tej razliki me pogosto sprašujejo, saj so od zunaj vsi videti kot »agenti umetne inteligence«. Tukaj je primerjalna tabela:

Kako brati tabelo. Claude Code uporabljam za razvoj: najboljši je, ko potrebujete zmogljiv model in delate s kodo. OpenClaw in Hermes sta namenjena nečemu drugemu: agentu, ki stalno deluje, se zadržuje v Telegramu, si zapomni včerajšnji pogovor in opravlja opravila po urniku. Izbira med OpenClawom in Hermesom je manj očitna; na voljo je že vodnik za Hermes z navodili za namestitev in nastavitev.

Če izbirate orodje, začnite s pregledom: s čim ljudje programirajo leta 2026 in katere naloge zaupati agentu umetne inteligence. O namestitvi Claude Code imam tudi ločen članek.

Kaj potrebujete pred namestitvijo OpenClawa?#

Vnaprej preverite različico Node — to je edina stroga zahteva:

node --version

Podprte so različice 22.22.3+, 24.15+ in 25.9+; priporočena je Node 26. Če ukaz vrne »command not found« ali je različica stara, ne skrbite: uradni namestitveni program bo prenesel novejšo različico Node, zato vam je ni treba namestiti ročno.

Naslednje vprašanje je model. OpenClaw ne razmišlja sam: pokliče model, ki ga izberete. Na voljo sta dve možnosti glede stroškov: ključ Anthropic, OpenAI ali Google — ponudniku plačate glede na dejansko uporabo; ali lokalni model prek Ollame — brez denarnih stroškov, vendar zahteva zmogljivo strojno opremo. Obe možnosti obravnavam v ločenih razdelkih spodaj.

Kako namestiti OpenClaw v macOS in Linux?#

Priporočena je uporaba uradnega namestitvenega programa:

1. Zaženite namestitveni program

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

   Skript zazna vaš operacijski sistem, preveri, ali je nameščen Node (in ga po potrebi namesti), namesti OpenClaw in nato odpre čarovnika za nastavitev. Če si želite pred zagonom čarovnika najprej ogledati možnosti, dodajte zastavico: bash -s -- --no-onboard.

2. Preverite, ali je vse nameščeno

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Prvi ukaz prikaže različico, drugi preveri konfiguracijo, tretji pa potrdi, da prehod deluje in posluša na vratih 18789.

Če uporabljate npm in želite namestitev upravljati sami:

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

Tu je nedavna past, ki je obravnavana v ločenem poglavju dokumentacije. npm 12 privzeto blokira namestitvene skripte paketov, zato se bo namestitev brez zastavice --allow-scripts=openclaw ustavila s sporočilom allowScripts. V npm 11.15 in starejših različicah zastavica ni potrebna — te omejitve še ni. Različico preverite z ukazom: npm --version.

Zastavica --install-daemon v drugem ukazu nastavi samodejni zagon: v macOS gre za LaunchAgent, v Linuxu pa za storitev systemd. Prehod se tako zažene po ponovnem zagonu ali prijavi, če to dopuščajo pogoji upravljalnika storitev. To ne preprečuje spanja in ne ohrani delovanja prehoda, ko je računalnik izklopljen. Za odgovore v Telegramu mora biti gostitelj buden in povezan z omrežjem; če potrebujete odgovore tudi med spanjem ali izklopom prenosnika, uporabite strežnik, ki deluje neprekinjeno.

Kako namestiti OpenClaw v Windows?#

Prva možnost je za tiste, ki imajo raje okna kot terminal. Windows Hub je izvorna aplikacija OpenClaw za Windows 10 (20H2+) in Windows 11, trenutno v različici beta. Obiščite stran z izdajami Windows Huba in prenesite namestitveni program za svoj procesor: OpenClawCompanion-Setup-x64.exe za običajne računalnike ali arm64 za ARM. Po namestitvi se bo OpenClaw Companion pojavil v meniju Start z ikono v sistemski vrstici, oknom za klepet in nastavitvami.

Ob prvem zagonu bo aplikacija ponudila možnost »Set up locally« — izberite jo. Ustvarila bo namensko okolje WSL z imenom OpenClawGateway, vanj namestila prehod in se z njim povezala. Obstoječe namestitve Ubuntuja se ne bo dotaknila, če jo imate.

Druga možnost je PowerShell:

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

Prva vrstica namesti OpenClaw, druga pa registrira samodejni zagon prek razporejevalnika opravil Windows. Če pravilnik vašega računalnika blokira ustvarjanje opravil, bo OpenClaw sam preklopil na nadomestno možnost: bližnjico v mapi Startup, tako da se prehod zažene ob prijavi.

Tretja možnost je WSL2, ki ga dokumentacija označuje za najzdružljivejše izvajalno okolje v sistemu Windows. Namestite Ubuntu, omogočite systemd in sledite navodilom za Linux iz prejšnjega razdelka:

wsl --install -d Ubuntu-24.04

V WSL omogočite systemd v datoteki /etc/wsl.conf (v razdelku [boot], z vrstico systemd=true), znova zaženite WSL tako, da v PowerShellu izvedete wsl --shutdown, nato pa namestite OpenClaw z ukazom za Linux. Če vam izraza »distribucija« in »systemd« nič ne pomenita, uporabite Windows Hub; vse to opravi namesto vas.

Kako izbrati model in dokončati začetno nastavitev?#

Model je motor pomočnika. Čarovnik za nastavitev bo ponudil seznam ponudnikov; tukaj so tri praktične možnosti:

Pri Anthropic je na voljo priročna možnost: če je Claude Code že nameščen v vaši napravi in ste vanj prijavljeni, lahko OpenClaw uporabi to prijavo. Najprej v napravi zaženite claude auth login, nato pa OpenClawu naročite, naj jo uporabi:

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

Če prehod deluje kot storitev v ozadju (kar velja pri uporabi --install-daemon), mora imeti storitev dostop do ključa. Zato ga dodajte v ~/.openclaw/.env — čarovnik to naredi namesto vas, zato datoteke ni treba ročno urejati. Po spremembah znova zaženite in preverite:

openclaw gateway restart
openclaw models status

Če je plačilo težava, je prava izbira lokalni model iz razdelka o Ollami.

Kako povezati OpenClaw s Telegramom?#

Telegram je najhitrejši kanal za povezavo: potrebujete samo žeton bota, brez preverjanja poslovnega računa. Dokumentacija ga označuje za najpreprostejši način, da začnete pomočniku pošiljati sporočila s telefona. Tukaj je celoten postopek:

1. Ustvarite bota z BotFatherjem

   V Telegramu odprite klepet z @BotFather (preverite, ali gre za točno to uporabniško ime — ponaredkov je veliko), pošljite /newbot in izberite ime ter uporabniško ime, ki se konča z bot. V odgovor boste prejeli žeton v obliki 123456789:ABCdef... — to je ključ vašega bota, zato ga varujte kot geslo.

2. Vnesite žeton v OpenClaw

   Najpreprosteje je to narediti prek čarovnika: zaženite openclaw configure in izberite kanal Telegram. Druga možnost je nastavitev channels.telegram.botToken ali spremenljivka okolja TELEGRAM_BOT_TOKEN. Dokumentacija posebej navaja, da ukaz openclaw channels login telegram ne obstaja; Telegram se poveže samo z žetonom.

3. Zaženite prehod in pošljite sporočilo botu

   openclaw gateway
   

   Odprite svojega bota v Telegramu in mu nekaj pošljite. Odgovoril bo s kodo za povezovanje z osmimi znaki. To je varnostni ukrep: sporočila se ne obdelujejo, dokler ne odobrite pošiljatelja.

4. Odobrite sami sebe

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Koda velja eno uro, zato ne čakajte predolgo. Prvi odobreni pošiljatelj samodejno postane lastnik ukazov s povišanimi pravicami.

Pri tem sta dve zapleteni točki, na kateri ljudje pogosto naletijo.

Prva so skupine. OpenClaw privzeto blokira vse skupine: bota morate izrecno dovoliti v nastavitvah channels.telegram.groups, v skupini pa pustiti vklopljen način requireMention: true. Tako bo odgovoril samo, ko ga pokličete z uporabniškim imenom, in se ne bo vmešaval v splošni pogovor. Telegram ima tudi svoj način zasebnosti botov: v skupini bot privzeto vidi samo ukaze. Izklopite ga z ukazom /setprivacy prek @BotFather. Po spremembi morate bota odstraniti iz skupine in ga znova dodati; sicer Telegram nastavitve ne bo uveljavil.

Druga točka: ne odprite dostopa vsem. Nastavitve vključujejo način dmPolicy: "open" z zvezdico na seznamu dostopa: botu lahko ukazuje vsak, ki ga najde po uporabniškem imenu. Pri osebnem pomočniku je to neposredna pot do tega, da nekomu drugemu omogočite nadzor nad svojim računalnikom. Pustite vklopljeno povezovanje s kodo ali vnesite svoj številčni ID v allowFrom.

Kako zagnati OpenClaw z lokalnim modelom prek Ollame?#

Lokalni model lahko samo izvajanje modela ohrani na vaši strojni opremi, če izberete Local only brez nadomestne uporabe oblaka. S tem Telegram ali omogočene spletne storitve ne postanejo lokalne; njihova sporočila in zahteve orodij se lahko še vedno prenašajo po omrežju. Za lokalne žetone modela ne plačujete ponudniku.

1. Namestite Ollamo

   Prenesite namestitveni program s spletnega mesta ollama.com/download — na voljo so različice za macOS, Windows in Linux.

2. Prenesite model

   ollama pull gemma4
   

3. Povežite Ollamo z OpenClawom

   openclaw onboard
   

   Izberite ponudnika Ollama in način: Local only (samo vaši modeli), Cloud only (modeli s spletnega mesta ollama.com) ali Cloud + Local. Čarovnik bo našel lokalni strežnik in prikazal nameščene modele.

4. Preverite

   openclaw models list --provider ollama
   

Tukaj je iskreno opozorilo, brez katerega bi ta razdelek zvenel kot oglas. Dokumentacija OpenClawa neposredno navaja, da za udobno uporabo lokalnega agenta potrebujete strojno opremo na ravni dveh povsem opremljenih računalnikov Mac Studio, medtem ko grafična kartica z 24 GB zmore le lažje zahteve, pa še to z zamikom. Majhni in močno stisnjeni modeli skrajšujejo kontekst in so manj odporni na zlonamerna navodila, skrita v besedilu nekoga drugega. V vsakdanjem življenju to pomeni: lokalni model na dobrem prenosniku zadošča za to, da ga »preizkusite in razumete, za kaj gre«, vendar je model v oblaku še vedno precej zanesljivejši za vsakodnevno delo s pomočnikom, ki uporablja orodja.

Dokumentacija vsebuje še eno opozorilo za vse, ki sestavljajo okolje WSL2 + Ollama + grafični procesor NVIDIA: uradni namestitveni program Ollame za Linux omogoči samodejni zagon s pravilnikom za ponovni zagon »always«, kar lahko v WSL2 z grafičnim procesorjem povzroči nenehno zanko ponovnih zagonov. Rešitev je izklop samodejnega zagona storitve. Če naletite na to težavo, si oglejte razdelek za odpravljanje težav na strani o Ollami v dokumentaciji.

Kako varno je uporabljati OpenClaw?#

Začel bom z glavno točko, ki je ne razume vsak. OpenClaw ima dostop do vaše naprave: do datotek, ukazov in brskalnika. Dokumentacija pove naravnost: projekt je zasnovan za enega zaupanja vrednega uporabnika, zato zunanjim osebam ne smete omogočiti dostopa do svojega bota. Če lahko nekdo pošlje sporočilo vašemu agentu, ga lahko uporabi za izvajanje dejanj v vašem računalniku.

Praktični minimum:

1. Pustite vklopljeno povezovanje s kodo ali uporabite seznam dostopa — o nastavitvi sem pisal v razdelku o Telegramu.
2. Prehoda ne izpostavljajte zunanjim povezavam, razen če je to potrebno. Privzeto posluša samo v vaši napravi; naj tako tudi ostane.
3. Po vsaki spremembi konfiguracije zaženite vgrajeno preverjanje:

openclaw security audit

Preveri odprt dostop, preširoka dovoljenja za orodja, šibke žetone in izpostavljena vrata. Z zastavico --fix je mogoče nekatere ugotovitve odpraviti samodejno.

Posebna opomba o prevarah — to ni zgolj teoretična nevarnost. Ko je projekt januarja 2026 v paniki spremenil ime, so si preprodajalci imen v nekaj sekundah prilastili stare naslove in nemudoma objavili kripto denarnico; lažni »razvijalci OpenClawa« so začeli promovirati prevaro s kriptožetonom. Iz tega izhajata dve neomajni pravili. OpenClaw prenesite samo s spletnega mesta openclaw.ai ali iz repozitorija github.com/openclaw/openclaw. Projekt nima kriptovalute: vsak »žeton OpenClaw« je prevara. Nikoli ne pošiljajte denarja zanj.

Kaj lahko OpenClaw počne po namestitvi?#

Tukaj je, kaj bi preizkusil po vrsti:

1. Prehod in model. Zaženite openclaw gateway status, nato odprite openclaw dashboard. Naložena plošča potrjuje dosegljivost Control UI. V njenem klepetu pošljite »Odgovori z: model connection test« in preverite, ali prispe odgovor umetne inteligence; samo nalaganje strani ne preveri modela.
2. Telegram in predvidena naloga. Po nastavitvi bota in odobritvi lastne povezave mu pošljite novo sporočilo v Telegramu ter preverite, ali odgovor prispe tja. Nato izvedite eno omejeno nalogo z vidnim rezultatom, na primer povzetek neškodljive preizkusne mape, za katero ste dovolili branje. Pri opomniku ločeno preverite shranjeni urnik in dostavljeni opomnik. Odgovor na nadzorni plošči ne dokazuje dostave v Telegram ali načrtovanega izvajanja.
3. Načrtovana opravila. Pomočnik lahko izvaja opravila po urniku — na primer jutranji povzetek v Telegramu ali redno preverjanje e-pošte. Zato mora prehod delovati neprekinjeno.
4. Pomnilnik. OpenClaw dolgoročni pomnilnik shranjuje v običajnih datotekah Markdown v svoji delovni mapi: kdo ste, kako naj vam odgovarja in česa se spomni iz prejšnjih pogovorov. Datoteke lahko sami odprete in preberete — ni črne skrinjice.
5. Veščine iz kataloga. Projekt ponuja katalog pripravljenih veščin in vtičnikov z vgrajenimi varnostnimi preverjanji. Veščina nekoga drugega pomeni kodo nekoga drugega v vašem računalniku, zato jih katalog preverja.

Tukaj velja eno pravilo: ne vklopite vsega naenkrat. Začnite z enim stabilnim pogovorom, nato dodajte Telegram in nazadnje urnike. Tako se vsaka napaka pokaže v svojem koraku, namesto da se vse spremeni v »vse je odpovedalo in ne vem, kje«.

Kaj storiti, če gre pri namestitvi kaj narobe?#

Poglejmo tri pogoste primere.

»openclaw: command not found« takoj po namestitvi. Skoraj vedno gre za težavo s potjo: mapa globalnih paketov npm ni vključena v spremenljivko PATH vašega terminala. Dokumentacija priporoča naslednje diagnostične ukaze:

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

Pot iz drugega ukaza bi se morala pojaviti v tretjem. Če je ni, jo dodajte v nastavitve lupine ali preprosto zaprite in znova odprite terminal: včasih se pot Node po namestitvi pojavi šele v novi seji.

Prehod deluje, pomočnik pa molči. Simptom iz pogostih vprašanj v dokumentaciji: na prvo sporočilo ni odgovora, števec žetonov pa kaže nič. To pomeni, da se agent sploh še ni zagnal — najpogosteje zato, ker model ni konfiguriran. Preverite v tem vrstnem redu:

openclaw gateway restart
openclaw status
openclaw models status

Če je model konfiguriran, a odgovora še vedno ni, bo openclaw logs --follow prikazal sprotni dnevnik in mesto, kjer se je zataknilo.

Bot Telegram ne odgovarja. Preverite po tem vrstnem redu: žeton pripada botu, ki mu pošiljate sporočila; prehod deluje (openclaw gateway status); povezava pa je odobrena (openclaw pairing list telegram). Koda za povezovanje velja eno uro — če ste botu pisali včeraj, mu preprosto pišite znova in odobrite novo kodo.

Če ste povsem obtičali, dokumentacija predlaga nekaj nepričakovanega, a smiselnega: diagnostiko posredujte lokalnemu agentu umetne inteligence, ki lahko dostopa do vaše naprave. Claude Code ali Codex lahko iz izpisov ukazov openclaw status --all in openclaw doctor razbere konfiguracijo hitreje kot klepet s podporo. Krog je sklenjen — umetna inteligenca popravi umetno inteligenco.

Kaj ljudje še sprašujejo o OpenClawu?#

Spoznajte Ailoot.