OpenClaw koppelen aan Telegram

Kort antwoord. Maak in Telegram een bot met @BotFather (/newbot) en kopieer het token. Geef het token aan OpenClaw en laat alleen je eigen numerieke Telegram-gebruikers-ID berichten sturen. Op je eigen machine is dat openclaw channels add --channel telegram --token <token> plus dmPolicy: "allowlist" met je ID in allowFrom. Op PlayNHost plak je het token en je ID op de pagina Agent, en herstart je.

Gecontroleerd op 6 november 2026, juist voor OpenClaw 2026.11.1.

Deze gids gebruikt de Telegram-documentatie van OpenClaw en het PlayNHost-paneel zoals het nu werkt. Telegram is ingebouwd in OpenClaw: er is geen plugin om te installeren.

Stap 1: maak de bot en kopieer het token

1. Open in Telegram een chat met @BotFather. Controleer dat de naam precies @BotFather is.
2. Stuur /newbot, kies een weergavenaam en daarna een gebruikersnaam die eindigt op bot.
3. BotFather antwoordt met het token, dat eruitziet als 123456789:AAH.... Houd het privé: iedereen die het heeft, kan je bot besturen.

BotFather heeft ook een web-app (t.me/BotFather?startapp) die hetzelfde doet met knoppen.

Gebruik een bot waar verder niets op draait. Als een oudere OpenClaw op je laptop, of een ander programma, nog hetzelfde token gebruikt, stop die dan eerst of maak een nieuwe bot.

Stap 2: zoek je Telegram-gebruikers-ID

De allowlist van OpenClaw wil je numerieke gebruikers-ID, niet je @gebruikersnaam, telefoonnummer of de ID van de bot. De manieren die de documentatie van OpenClaw opsomt:

• Van de bot zelf (geen derde partij). Stuur de bot een willekeurig bericht terwijl hij in pairing-modus staat. Zijn koppelantwoord bevat "Your Telegram user id". Op PlayNHost is dit de manier die wij aanraden, zie hieronder.
• Uit het log van OpenClaw. Voer openclaw logs --follow uit, stuur de bot een bericht en lees senderUserId in de regel telegram pairing request.
• De eigen API van Telegram. Stuur de bot een bericht, open dan https://api.telegram.org/bot<bot_token>/getUpdates en lees message.from.id.
• Een bot van een derde partij zoals @userinfobot of @getidsbot. De documentatie van OpenClaw noemt dit minder privé.

Stap 3 op PlayNHost: plak het token en je ID

Je hebt op dezelfde pagina een sleutel van een AI-provider nodig. Zonder die sleutel stopt Start met "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token." (de console schrijft in het Engels).

1. Open je server op panel.playnhost.com, dan het tabblad Agent.
2. Stel onder AI-provider één sleutel in als je dat nog niet hebt gedaan (zie welke AI-providersleutel je gebruikt).
3. Druk onder Chat-apps op Instellen bij Telegram-bottoken, plak het token van BotFather en druk op Opslaan. Het paneel controleert de vorm; een verkeerde plak geeft "That is not a valid telegram bot token." Na het opslaan toont de regel alleen de laatste vier tekens, en het token wordt nooit meer getoond.
4. Ken je je ID nog niet? Laat Telegram-gebruikers-ID’s leeg en druk op Starten. Als de agent draait, toont de console:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Stuur je bot een bericht in Telegram. Hij antwoordt één keer met een koppelcode en je Telegram-gebruikers-ID (OpenClaw stuurt ongeveer eens per uur per persoon een code en negeert de berichten daartussen). Kopieer de ID en negeer de code: op PlayNHost hoeft niets te worden goedgekeurd. Door deze stap komt niemand binnen.
5. Typ onder Wie hem mag berichten je ID bij Telegram-gebruikers-ID’s en druk op Opslaan. Meerdere ID's gaan op één regel, gescheiden door komma's.
6. De pagina zegt "Wijzigingen gelden de volgende keer dat je agent start." Druk op Nu herstarten. De console bevestigt dan:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Stuur je bot een bericht. Je agent antwoordt. Berichten van elk ander Telegram-account worden genegeerd.

Wat PlayNHost voor je instelt

• Met ID's in het blok Agent gebruiken Telegram-DM's dmPolicy: "allowlist" met precies die ID's, wat de documentatie van OpenClaw aanraadt voor een bot met één eigenaar. Zonder ID gebruiken ze pairing: onbekenden krijgen een code en worden genegeerd, en niemand kan ze goedkeuren zonder de opdrachtregel of het dashboard van OpenClaw, en een PlayNHost-server biedt geen van beide.
• De ID's die je opgeeft worden ook de opdrachteigenaren van OpenClaw (commands.ownerAllowFrom), zodat opdrachten die alleen voor de eigenaar zijn vanaf het eerste bericht voor jou werken.
• Het token bereikt OpenClaw als TELEGRAM_BOT_TOKEN in zijn omgeving. Een token dat in het eigen instellingenbestand van OpenClaw staat, zou voorrang krijgen, dus de start verwijdert het uit het bestand: het token in het blok Agent is het token dat wordt gebruikt.
• Groepen blijven gesloten: OpenClaw laat geen groep toe totdat er een aan zijn instellingen is toegevoegd, en een instelling die iedereen met de agent laat praten wordt bij de volgende start teruggezet naar jouw ID's.

Stap 3 op je eigen machine

1. Voeg het token toe:

   openclaw channels add --channel telegram --token <bot-token>

   of stel TELEGRAM_BOT_TOKEN in in de omgeving van de Gateway. Een token in het configuratiebestand gaat voor op de omgevingsvariabele.
2. Sta alleen jezelf toe in ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   Het onderdeel commands maakt jou de eigenaar voor opdrachten die alleen voor de eigenaar zijn: OpenClaw doet dat niet voor een met de hand geschreven allowlist. Een allowlist met een lege allowFrom blokkeert elke DM en wordt afgewezen door de configuratiecontrole van OpenClaw.
3. Of houd de standaard pairing-modus en keur jezelf goed na je eerste bericht:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Codes verlopen na een uur. De eerste goedgekeurde koppeling maakt jou ook opdrachteigenaar.
4. Controleer het kanaal met openclaw channels status --probe.

Als het niet antwoordt

Wil je ook Discord? Zie OpenClaw koppelen aan Discord. Nog niet ingesteld? Maak een OpenClaw-server aan.

PlayNHost is niet verbonden aan de OpenClaw Foundation. OpenClaw is open-sourcesoftware onder de MIT-licentie.