Architektur

OpenClaw Gateway erklärt – Die Verbindung zu deinen Messengern

Was ist das OpenClaw Gateway?

Das Gateway ist der zentrale Hintergrundprozess von OpenClaw. Es ist die Brücke zwischen deinen Messenger-Apps (Telegram, WhatsApp, Discord, etc.) und dem KI-Modell (Claude, GPT, etc.).

Wenn du openclaw gateway startest, passieren drei Dinge:

  1. Messenger-Verbindungen werden hergestellt (Telegram Bot, WhatsApp Web, etc.)
  2. Das KI-Modell wird geladen und konfiguriert
  3. Heartbeat-Timer werden aktiviert (falls konfiguriert)

Wie funktioniert das Gateway?

Dein Handy (Telegram/WhatsApp)
         ↓ Nachricht
    OpenClaw Gateway (auf deinem Server)
         ↓ verarbeitet
    KI-Modell (Claude API)
         ↓ Antwort
    OpenClaw Gateway
         ↓ sendet zurück
Dein Handy (Antwort erscheint)

Das Gateway empfängt Nachrichten, reichert sie mit Kontext an (Soul.md, User.md, Memory.md, aktive Skills), sendet alles an das KI-Modell und leitet die Antwort zurück.

Gateway vs. TUI

OpenClaw hat zwei Modi:

| Modus | Beschreibung | | --- | --- | | Gateway | Hintergrundprozess, verbindet Messenger, läuft 24/7 | | TUI | Terminal User Interface, für direkte Interaktion |

Für den produktiven Einsatz nutzt du das Gateway. Die TUI ist nützlich zum Testen und für das erste „Hatching" (Erwecken) deines Agenten.

Gateway als systemd Service

Damit das Gateway nach einem Server-Neustart automatisch startet, richtest du es als systemd Service ein:

sudo systemctl enable openclaw
sudo systemctl start openclaw

So läuft dein Agent 24/7, auch nach Updates oder Neustarts.

Troubleshooting

Gateway startet nicht

  • Node.js Version prüfen (22+ erforderlich)
  • API-Key korrekt? Keine Leerzeichen?
  • Logs prüfen: journalctl -u openclaw -f

Messenger verbindet nicht

  • Telegram: Bot-Token prüfen
  • WhatsApp: QR-Code erneut scannen
  • Firewall: Ausgehende HTTPS-Verbindungen erlaubt?

Verwandte Konzepte

  • Heartbeat: Läuft innerhalb des Gateway
  • Skills: Werden vom Gateway verwaltet
  • MCP: Kommunikationsprotokoll für Tool-Integrationen

Die komplette Gateway-Einrichtung lernst du in Modul 3 der Masterclass.

Weitere Begriffe