1. Voorpagina
  2. Installatie
  3. OpenClaw
Instellen · ongeveer 30 minuten

OpenClaw installeren: handleiding met Telegram

Reken op ongeveer een halfuur om van een lege machine naar een zelfgehoste agent te gaan die antwoordt via Telegram en regels volgt die je zelf hebt opgesteld.

Stap voor stap

  1. Kies waar de agent draait

    Een laptop is prima om OpenClaw uit te proberen, maar een agent die je altijd wilt kunnen bereiken, draait beter op hardware die continu aanstaat, zoals een thuisserver of gehuurde VPS. De agent kan immers alleen antwoorden zolang de machine draait. Welke optie je ook kiest, stel de gatewaypoort nooit bloot aan het open internet.

  2. Installeer OpenClaw

    Gebruik het officiële installatieprogramma voor jouw systeem. Het herkent het besturingssysteem, installeert Node als die ontbreekt, zet OpenClaw klaar en start vervolgens de onboarding.

    # macOS / Linux / WSL2
    curl -fsSL https://openclaw.ai/install.sh | bash
    
    # Windows (PowerShell)
    iwr -useb https://openclaw.ai/install.ps1 | iex
  3. Doorloop de onboarding en laat de gateway als service draaien

    Tijdens de onboarding kun je kiezen voor Quick start, dat gevonden AI-toegang opnieuw gebruikt, of voor Custom setup, waarin je alle opties te zien krijgt. Is de onboarding klaar, stop dan de gateway die op de voorgrond draait en registreer hem als service op de achtergrond. Zo start hij na een herstart automatisch weer op.

    openclaw onboard
    # stop the foreground gateway with Ctrl+C, then run it as a service:
    openclaw gateway install
  4. Koppel Telegram

    Open in Telegram een chat met @BotFather en controleer goed of je de juiste gebruikersnaam hebt. Stuur /newbot en bewaar de token die je krijgt. Registreer Telegram als kanaal met die token en voer een statuscontrole uit om de verbinding te testen.

    openclaw channels add --channel telegram --token <bot-token>
    openclaw channels status --probe
  5. Keur de koppeling goed

    Stuur je bot een bericht. In plaats van te antwoorden, geeft de bot onbekende afzenders een koppelingscode. Bekijk de openstaande verzoeken en keur dat van jou binnen een uur goed.

    openclaw pairing list telegram
    openclaw pairing approve telegram <CODE>
  6. Voer de beveiligingscontrole uit en blijf up-to-date

    Laat de ingebouwde beveiligingscontrole van OpenClaw je configuratie nakijken en los de gemelde problemen op. Haal daarna updates op uit het stabiele kanaal. Elke versie van vóór 2026.4.22 bevat bekende kritieke kwetsbaarheden, dus maak van beide opdrachten een vaste routine.

    openclaw security audit
    openclaw update --channel stable
  7. Stel vaste regels op

    Beschrijf je regels in gewone taal in AGENTS.md in de werkruimte van de agent. Stel dezelfde harde beperkingen in ~/.openclaw/openclaw.json in en controleer de namen van de sleutels aan de hand van de documentatie voor jouw versie. Laat dmPolicy op pairing staan en laat exec approvals telkens om toestemming vragen totdat je vertrouwen hebt in de configuratie.

De eerste week

Beschouw de eerste week als een proefperiode. De gateway moet op loopback blijven; maak verbinding via Tailscale of SSH in plaats van een poort bloot te stellen. Laat voor shell-opdrachten toestemming vragen, voeg spaarzaam externe skills toe en gebruik alleen skills van uitgevers die je kent. Houd je modelgebruik dagelijks in de gaten: een agent die in een lus vastzit, blijft tokens verbruiken. Voer de beveiligingscontrole opnieuw uit na elke wijziging van de configuratie.

Veelgemaakte fouten

  • De gateway blootstellen aan het internet in plaats van gateway.bind op loopback te laten staan.
  • Een hele reeks externe skills installeren; die verdienen net zoveel wantrouwen als browserextensies.
  • Een verouderde versie gebruiken: elke versie van vóór 2026.4.22 bevat bekende kritieke kwetsbaarheden.