Die OpenClaw-Befehle, die du wirklich brauchst (mit Erklärungen)
Warum dieses Cheatsheet?
Wenn man OpenClaw zum ersten Mal startet, hat man einen Agenten, aber keine klare Vorstellung, welche Befehle man wann verwendet. Die offizielle Doku existiert — aber sie erklärt nicht, warum man bestimmte Befehle in welcher Reihenfolge braucht.
Das hier ist kein komplettes Handbuch. Es ist das Cheatsheet, das wir uns gewünscht hätten, als wir unser 6-Agenten-Setup aufgebaut haben.
---
Die Gateway-Befehle (fast immer der erste Schritt)
Das Gateway ist der Herzschlag von OpenClaw. Ohne laufendes Gateway: keine Kanalverbindungen, keine Heartbeats, keine cron-Jobs.
```bash
# Status prüfen — läuft das Gateway überhaupt?
openclaw gateway status
# Gateway starten (beim ersten Mal oder nach dem Neustart)
openclaw gateway start
# Gateway neu starten — nötig nach Konfigurationsänderungen
openclaw gateway restart
# Gateway stoppen
openclaw gateway stop
```
Wann braucht man restart? Immer wenn man neue Kanäle hinzufügt, Konfiguration ändert oder Credentials aktualisiert. Start gilt für den ersten Launch; restart für alles danach.
Tipp: Bei Produktions-Setups läuft das Gateway als systemd-Service — nicht händisch gestartet. In unserem Playbook zeigen wir, wie wir das auf unserem Hetzner-Server eingerichtet haben.
---
Kanal-Befehle (wie der Agent nach außen kommuniziert)
Ein Agent ohne Kanal ist ein Agent, der mit niemandem spricht. Kanäle verbinden den Agenten mit Telegram, Discord, WhatsApp, Signal usw.
```bash
# Alle konfigurierten Kanäle anzeigen
openclaw channels list
# Neuen Kanal hinzufügen (interaktiver Wizard)
openclaw channels add
# Kanal entfernen
openclaw channels remove <channel-name>
# Kanal testen — sendet eine Test-Nachricht
openclaw channels test <channel-name>
```
Der häufigste Fehler: Kanal hinzufügen und vergessen, danach `openclaw gateway restart` auszuführen. Der Agent sieht den neuen Kanal erst nach dem Neustart.
Welchen Kanal zuerst? Wir empfehlen mit Telegram zu starten — einfachste Einrichtung, bester Test für den gesamten Stack. Discord für Team-Setups, Signal wenn Datenschutz kritisch ist.
---
Agenten-Befehle (wer macht was)
```bash
# Alle konfigurierten Agenten anzeigen
openclaw agents list
# Neuen Agenten erstellen
openclaw agents create
# Agenten-Details anzeigen
openclaw agents show <agent-id>
# Agenten löschen
openclaw agents delete <agent-id>
```
Wichtig für Multi-Agenten-Setups: Jeder Agent braucht eine eigene Session-Konfiguration und eigene Kanäle. Ein Fehler, den viele machen: alle Agenten auf demselben Telegram-Bot betreiben. Das führt zu Verwirrung. Jeder Agent bekommt seinen eigenen Bot-Token.
In unserem Setup hat zum Beispiel Sam (Teamleitung) einen eigenen Telegram-Bot, Peter (Coding) hat seinen eigenen, usw.
---
Cron-Befehle (automatische Aufgaben)
Cron-Jobs sind der Unterschied zwischen einem Agenten, der wartet, bis man ihn anspricht — und einem, der proaktiv arbeitet.
```bash
# Alle cron-Jobs anzeigen
openclaw cron list
# Neuen cron-Job erstellen (interaktiv)
openclaw cron create
# cron-Job aktivieren/deaktivieren
openclaw cron enable <job-id>
openclaw cron disable <job-id>
# cron-Job löschen
openclaw cron delete <job-id>
# cron-Job manuell auslösen (zum Testen)
openclaw cron trigger <job-id>
```
Praktisches Beispiel aus unserem Setup:
Sam führt täglich um 9:00 Uhr einen Morgenreport aus: prüft E-Mails, Kalender und offene ClickUp-Tasks. Der cron-Job schickt das Ergebnis direkt in den Telegram-Chat mit dem CEO.
Außerdem: täglich um 6:00 Uhr publiziert Sam automatisch einen Blog-Post auf unserer Website — ausgelöst durch einen cron-Job.
Timing-Format: OpenClaw verwendet Standard-Cron-Syntax (`0 9 * * 1-5` = Montag–Freitag 9:00 Uhr).
---
Konfigurations-Befehle
```bash
# Gesamte Konfiguration anzeigen
openclaw config show
# Einzelnen Wert setzen
openclaw config set <key> <value>
# OpenClaw-Version prüfen
openclaw version
```
Tipp: `openclaw config show` ist hilfreich beim Debuggen. Man sieht sofort, welche Kanäle aktiv sind, welches Modell konfiguriert ist und welche API-Keys gesetzt wurden.
---
Session-Befehle (was läuft gerade?)
```bash
# Aktive Sessions anzeigen
openclaw sessions list
# Logs einer Session anzeigen
openclaw sessions logs <session-id>
# Session beenden
openclaw sessions kill <session-id>
```
Wann braucht man das? Wenn ein Agent hängt, eine Session zu viel Speicher verbraucht oder man einfach wissen will, was gerade läuft.
---
Die wichtigste Reihenfolge beim Aufsetzen
Wenn man von null startet, ist die Reihenfolge entscheidend:
```
1. openclaw gateway start
2. openclaw channels add (z.B. Telegram)
3. openclaw gateway restart
4. openclaw agents create
5. Testen: Nachricht an den Bot schicken
6. openclaw cron create (optional, für automatische Tasks)
```
Das ist eine vereinfachte Version. Das vollständige Setup — inklusive Docker, Tailscale-Sicherheit, Workspace-Konfiguration und Multi-Agenten-Koordination — dokumentieren wir im OpenClaw Setup Playbook. 18 Kapitel, basierend auf echten Produktionserfahrungen.
Komplett auf Deutsch verfügbar. 🇩🇪