OpenClaw reageert niet: zo achterhaal je waarom

Je stuurt een bericht en er komt niets terug. Een zelfgehoste assistent heeft vier plekken waar een antwoord kan verdwijnen, en die zien er vanuit het chatvenster allemaal hetzelfde uit. Ze in volgorde testen kost ongeveer vijf minuten en maakt van een stille bot een specifieke, oplosbare fout.

De vier lagen

Weet voordat je iets verandert wat je test. Een bericht reist door alle vier deze lagen, en elk van die lagen kan het opslokken zonder dat er een foutmelding bij je terechtkomt:

  1. De instantie. Draait OpenClaw echt op je server?
  2. De modelaanbieder. Accepteert het taalmodel je verzoeken?
  3. De chatintegratie. Komt het bericht überhaupt bij OpenClaw aan?
  4. Het netwerkpad. Kunnen jij en het platform de instantie bereiken?

Er is één test die het probleem meteen in tweeën splitst: stuur een bericht in de OpenClaw-webinterface. Als je daar een antwoord krijgt, werken laag één en twee en zit het probleem in de integratie. Als je geen antwoord krijgt, kijk dan helemaal niet meer naar de bot.

Laag 1: draait de instantie?

Open je Flux-dashboard en controleer of de instantie draait en niet in een herstartlus zit. Een container die steeds doodgaat en weer terugkomt is de minst opvallende versie hiervan, omdat de dienst er tussen de herstarts gewoon uitziet alsof hij aanwezig is.

De gebruikelijke oorzaak van een herstartlus is geheugen. Als je OpenClaw op een lokaal model hebt gericht in plaats van een gehoste API, moeten de modelgewichten in hetzelfde RAM passen als al het andere. Een 7B-model gekwantiseerd naar 4 bits is op zichzelf ongeveer 4 GB aan gewichten, nog vóór de gesprekscontext en vóór het assistentproces. Op het abonnement van 4 GB werkt dat niet, en het abonnement van 8 GB is de realistische ondergrens voor lokale inferentie. Ga een abonnement omhoog of wijs de assistent naar een gehost model, waar het zware werk op de hardware van de aanbieder gebeurt en je instantie alleen het gesprek hoeft vast te houden.

Als je de webinterface helemaal niet kunt bereiken, noteer dat feit en ga naar laag vier voordat je aanneemt dat de instantie kapot is.

Laag 2: weigert de modelaanbieder je?

OpenClaw is modelonafhankelijk en je brengt je eigen sleutel mee, wat betekent dat de meest voorkomende stilte niets met OpenClaw zelf te maken heeft. Vier fouten aan de kant van de aanbieder zorgen ervoor dat een assistent stopt met antwoorden, en vanuit het chatvenster zijn ze niet van elkaar te onderscheiden:

  • De sleutel is ongeldig of is vervangen. Sleutels worden ingetrokken, opnieuw aangemaakt en met een spatie aan het eind geplakt. Plak hem opnieuw in plaats van hem te lezen en te denken dat hij er goed uitziet.
  • Het creditsaldo is leeg. Pay-as-you-go-accounts stoppen met het verwerken van verzoeken zodra het saldo op is, zonder waarschuwing in je assistent.
  • Je zit op een rate limit. Nieuwe accounts bij elke grote aanbieder zitten op lage limieten voor verzoeken per minuut. Een stroom berichten, of een agentlus die het model herhaaldelijk aanroept, raakt dat plafond, en elk geweigerd verzoek levert niets bruikbaars op in de chat.
  • De modelnaam bestaat niet meer. Aanbieders trekken modelnamen in, en een configuratie die maanden geleden is geschreven kan verwijzen naar iets dat inmiddels is teruggetrokken. Het verzoek mislukt als een slechte modelnaam in plaats van als een slechte sleutel, wat makkelijk verkeerd te lezen is.

Kijk in het eigen dashboard van de aanbieder: de pagina's voor gebruik, facturatie en rate limits vertellen je in seconden welke van de vier het is, en alle vier worden daar opgelost en niet in OpenClaw.

Laag 3: de chatintegratie

Als de webinterface antwoordt en de bot niet, komt het bericht nooit aan. Elk platform heeft één dominante oorzaak, en die is goed om bij naam te kennen.

Telegram: Privacy Mode

Bots die via BotFather zijn gemaakt hebben standaard Privacy Mode ingeschakeld. In een groep ontvangt een bot in die stand alleen berichten die beginnen met een slash-commando, of die direct antwoorden op de bot of de bot noemen. Al het andere wordt nooit naar je server gestuurd, dus je assistent negeert mensen niet, hij heeft ze gewoon nooit gehoord. Daarom beantwoordt dezelfde bot directe berichten perfect en lijkt hij in een groep dood.

Om dit op te lossen stuur je BotFather een bericht, open je de botinstellingen voor je bot en zet je Group Privacy uit. Verwijder daarna de bot uit de groep en voeg hem opnieuw toe, want de instelling wordt toegepast wanneer de bot de groep binnenkomt.

Discord: de Message Content Intent

Sinds 2022 behandelt Discord de tekst van berichten als bevoorrechte data. Een bot zonder ingeschakelde Message Content Intent maakt nog steeds verbinding, staat nog steeds online en ontvangt berichtgebeurtenissen met een leeg contentveld. Het resultaat is een bot die duidelijk draait en op helemaal niets reageert.

Schakel hem in via de Discord Developer Portal, onder je applicatie, Bot, Privileged Gateway Intents, en start daarna de integratie opnieuw. Controleer daar ook of de bot rechten heeft om berichten te lezen en te versturen in het specifieke kanaal: overschrijvingen op kanaalniveau winnen stilletjes van rollen op serverniveau, en een bot met serverrechten kan in één kamer nog steeds gedempt zijn.

WhatsApp: de sessie

WhatsApp-verbindingen zijn gekoppeld aan een gekoppelde sessie en niet aan een permanent token, en sessies verlopen, worden vanaf de telefoon uitgelogd of breken als het apparaat lang offline is. Een stille WhatsApp-integratie is meestal een sessie die opnieuw gekoppeld moet worden. Scan de code opnieuw en test opnieuw voordat je ergens anders gaat kijken.

Alle platformen: het token zelf

Controleer, welk platform het ook is, of het token in je dashboard het huidige token is. Het opnieuw genereren van een bottoken in de eigen console van het platform maakt het oude token direct ongeldig, en het is erg makkelijk om tijdens het onderzoeken van iets anders een token opnieuw te genereren en vergeten het nieuwe terug te plakken.

Laag 4: het netwerkpad

Als je OpenClaw via Tailscale bereikt, kan de assistent prima gezond zijn terwijl jij er gewoon niet bij kunt. Authenticatiesleutels verlopen, en apparaatsleutels verlopen ook, dus een instantie die maanden ongemoeid heeft gedraaid kan van je tailnet verdwijnen zonder dat er iets is mislukt. Controleer de Tailscale-beheerconsole en bevestig dat het apparaat nog staat vermeld en nog geautoriseerd is. Zo niet, genereer dan een nieuwe authenticatiesleutel en deploy opnieuw of verbind opnieuw.

Deze laag verklaart een patroon dat anders verwarrend is: de bot blijft in de chat antwoorden terwijl de webinterface voor jou onbereikbaar is. De instantie is in orde en draait; alleen je route ernaartoe is weg.

Het antwoordt, maar slecht

Een trage of afgekapte reactie is een ander probleem dan stilte en heeft meestal een van twee oorzaken. Lange gesprekken overschrijden uiteindelijk het contextvenster van het model, waarna verzoeken gaan mislukken of de assistent het eerdere deel van de draad kwijtraakt. Een nieuw gesprek starten is de directe oplossing. Daarnaast is een groot lokaal model op bescheiden hardware gewoon traag, en een antwoord dat een minuut duurt kan ergens in de keten time-outen voordat het wordt afgeleverd. Als je snelheid nodig hebt op een kleine instantie, verslaat een gehost model een lokaal model altijd.

De checklist van vijf minuten

  1. Stuur een bericht in de OpenClaw-webinterface. Een antwoord daar betekent dat het probleem de integratie is; geen antwoord betekent dat het de instantie, de aanbieder of je route ernaartoe is.
  2. Controleer de instantie in je Flux-dashboard op een herstartlus, en controleer het RAM als je een lokaal model draait.
  3. Controleer het eigen dashboard van de modelaanbieder op een ongeldige sleutel, een leeg saldo, een rate limit of een teruggetrokken modelnaam.
  4. Voor Telegram: zet Privacy Mode uit in BotFather en voeg de bot opnieuw toe aan de groep.
  5. Voor Discord: schakel de Message Content Intent in en controleer de rechten op kanaalniveau.
  6. Voor WhatsApp: koppel de sessie opnieuw.
  7. Als de webinterface onbereikbaar is maar de chat nog werkt, controleer dan Tailscale op een verlopen apparaat of een verlopen authenticatiesleutel.

Bijna elk geval eindigt bij stap één, drie of vier. Het patroon dat het waard is om te onthouden is dat een zelfgehoste assistent meer bewegende delen heeft dan een SaaS-assistent, precies omdat jij ze bezit, en dat bezitten betekent dat de fout altijd te vinden is.

Aanvullende lectuur

Nieuw met het draaien van zo'n assistent? Begin met de gids om OpenClaw zelf te hosten, of lees over het kiezen van een AI-model als je een gehoste aanbieder afweegt tegen een lokale. Voor de integraties zelf, zie Telegram, Discord en WhatsApp.

Deploy je eigen OpenClaw AI-assistent

Zelf gehost, model-agnostisch, privacy eerst: live op de Flux decentrale cloud binnen 30 seconden. Eerste week gratis voor nieuwe gebruikers.