OpenClaw & Moltbook FAQ

OpenClaw ist ein Open-Source KI-Assistenten-Framework, mit dem Sie Ihren eigenen KI-Assistenten auf mehreren Messaging-Plattformen (WhatsApp, Telegram, Discord usw.) bereitstellen können. Moltbook ist ein von der Community betriebener Shared Service, bei dem OpenClaw-Benutzer bestehenden Instanzen beitreten können, ohne selbst zu hosten. Ideal für: Entwickler, Technikbegeisterte, Teams, die private KI-Assistenten benötigen, und alle, die ihre KI-Interaktionen kontrollieren möchten.

Desktop (GUI) wird für Anfänger empfohlen - es bietet visuelle Konfiguration, Echtzeit-Logs und Ein-Klick-Operationen. CLI ist besser für: • Server-Bereitstellungen • Automatisierung und Scripting • Ressourcenbeschränkte Umgebungen • Entwickler, die Terminal-Workflows bevorzugen Beide Versionen teilen die gleiche Kernfunktionalität.

Ihre Minimalerfolg-Checkliste: 1. OpenClaw installiert und läuft (Gesundheitsstatus prüfen) 2. Mindestens ein Modell-API-Schlüssel konfiguriert (OpenAI, Anthropic usw.) 3. Ein Messaging-Kanal verbunden (wir empfehlen Telegram für Anfänger) 4. Eine Testnachricht senden und Antwort erhalten Dies dauert typischerweise 5-10 Minuten mit der Desktop-Version.

Erforderlich: • Mindestens ein KI-Modell-API-Schlüssel (OpenAI, Anthropic, Google usw.) Für Kanalintegration (mindestens einer): • WhatsApp: Nur Ihr Telefon mit installiertem WhatsApp • Telegram: Bot über @BotFather erstellen • Discord: Anwendung im Discord Developer Portal erstellen Optional: • Websuche-API-Schlüssel für erweiterte Funktionen

Mit einem Kanal zu beginnen hilft Ihnen: • Sich auf die Grundlagen zu konzentrieren • Den Nachrichtenfluss klar zu verstehen • Probleme leichter zu debuggen • Vertrauen aufzubauen, bevor Sie Komplexität hinzufügen Sobald Sie vertraut sind, ist das Hinzufügen weiterer Kanäle einfach.

Nach der Installation prüfen Sie: 1. Führen Sie `openclaw health` oder `openclaw status` (CLI) aus, oder prüfen Sie den Gesundheitsstatus in Desktop 2. Achten Sie auf grüne Häkchen bei allen Diensten 3. Überprüfen Sie, ob das Gateway erreichbar ist (Standard: http://127.0.0.1:18789) 4. Prüfen Sie Logs auf Fehlermeldungen Wenn alle Prüfungen bestanden sind, können Sie Kanäle konfigurieren.

Top 5 Startprobleme: 1. Port bereits in Verwendung (andere App nutzt 18789) 2. Fehlende oder ungültige API-Schlüssel 3. Unzureichende Berechtigungen (versuchen Sie als Admin auszuführen) 4. Firewall blockiert Verbindungen 5. Veraltete Abhängigkeiten (Node.js v22+ erforderlich) Prüfen Sie zuerst die Logs - sie zeigen meist das genaue Problem.

Lösungen: 1. Finden und stoppen Sie den konfliktierenden Prozess: • Mac/Linux: `lsof -i :18789` dann `kill [PID]` • Windows (WSL): `lsof -i :18789` dann `kill [PID]` 2. Oder ändern Sie OpenClaws Port: • Verwenden Sie `openclaw gateway --port 18790` beim Starten • Oder geben Sie `--gateway-port 18790` während onboard an

Probieren Sie diese Schritte der Reihe nach: 1. Logs prüfen: `openclaw logs --follow` um Fehlermeldungen zu sehen 2. Neu konfigurieren: `openclaw configure` ausführen um Einstellungen zurückzusetzen 3. Neu installieren: `npm install -g openclaw@latest` 4. Release Notes auf Breaking Changes prüfen 5. Wenn es immer noch fehlschlägt, mit Logs auf GitHub Issues melden

OpenClaw verwendet hauptsächlich `~/.openclaw/openclaw.json` für die Konfiguration. Häufige Probleme: 1. Dienst nach Konfigurationsänderungen nicht neu gestartet 2. Falscher Konfigurationsdateipfad 3. JSON-Syntaxfehler (fehlende Kommas, Anführungszeichen) 4. Umgebungsvariablen müssen über onboard-Parameter übergeben werden Konfiguration überprüfen: `openclaw status` ausführen um aktive Einstellungen zu sehen.

Stellen Sie es sich wie ein Restaurant vor: • Modell = Der Koch (KI, die Antworten generiert) • Kanal = Der Eingang (WhatsApp, Telegram usw.) • Gateway = Der Empfang (empfängt und leitet Anfragen weiter) • Skills = Spezielle Fähigkeiten (Websuche, Code-Ausführung usw.) Sie brauchen mindestens ein Modell und einen Kanal. Gateway läuft automatisch. Skills sind optionale Erweiterungen.

Der einfachste Weg ist der interaktive Einrichtungsassistent: ``` $ openclaw onboard ``` Der Assistent führt Sie durch: • Auswahl eines KI-Modellanbieters (Anthropic/OpenAI usw.) • Eingabe Ihres API-Schlüssels • Installation und Start des Gateway-Dienstes Nach der Einrichtung verbinden Sie einen Kanal mit `openclaw channels login telegram`. Standard-Gateway bindet an 127.0.0.1:18789 (nur lokaler Zugriff - sicher).

In Desktop: Einstellungen → Skills → Ein/Aus umschalten In CLI: • Verfügbare Skills auflisten: `openclaw skills list` • Skill installieren: `openclaw skills install [skill-name]` • Skill aktivieren: `openclaw skills enable [skill-name]` Sicherheitstipps: • Deaktivieren Sie Skills, die Sie nicht brauchen • Prüfen Sie Skill-Berechtigungen vor dem Aktivieren • Testen Sie neue Skills zuerst in einer sicheren Umgebung • Einige Skills können Code ausführen - mit Vorsicht aktivieren

Modelle wechseln: 1. Führen Sie `openclaw onboard` erneut aus um mit neuem Anbieter zu konfigurieren 2. Oder bearbeiten Sie agents.defaults.model Einstellungen in `~/.openclaw/openclaw.json` 3. Dienst neu starten: `openclaw gateway status` zur Überprüfung Wenn neues Modell fehlschlägt: • `openclaw models status` ausführen um Modellverbindung zu prüfen • API-Schlüssel-Gültigkeit auf Anbieter-Website prüfen • Modellnamen-Schreibweise überprüfen (z.B. `anthropic/claude-opus-4-5`) • Rate Limits oder Quota auf Ihrem Konto prüfen

Sicherheitscheckliste: ✓ Gateway standardmäßig auf localhost (127.0.0.1) belassen ✓ Port niemals direkt ins öffentliche Internet freigeben ✓ Wenn Remote-Zugriff benötigt, verwenden Sie: • VPN oder SSH-Tunnel • Reverse Proxy mit Authentifizierung • Cloudflare Tunnel ✓ Authentifizierung aktivieren wenn verfügbar ✓ HTTPS in Produktion verwenden

Versuchen Sie diese Lösungen: 1. Stellen Sie sicher, dass Telefon und Computer im selben Netzwerk sind 2. QR-Code aktualisieren (sie verfallen schnell) 3. WhatsApp auf dem Telefon auf neueste Version aktualisieren 4. Browser-Cache leeren wenn Web-Interface verwendet wird 5. In gut beleuchteter Umgebung scannen 6. VPN vorübergehend deaktivieren Wenn es immer noch fehlschlägt, probieren Sie die Telefon-Linking-Code-Methode.

Sitzungsprobleme werden meist verursacht durch: 1. Telefon offline oder im Schlafmodus 2. WhatsApp auf Telefon abgemeldet 3. WhatsApp Web auf anderem Gerät verwendet 4. Netzwerk-Instabilität Lösungen: • Telefon mit stabilem WLAN verbunden halten • Batterieoptimierung für WhatsApp deaktivieren • WhatsApp Web nicht anderswo öffnen • Nach WhatsApp App-Updates suchen

Gruppenverhalten ist meist beabsichtigt: • Prüfen Sie ob Gruppenantworten in Config aktiviert sind • Bot benötigt möglicherweise @Erwähnung um in Gruppen zu antworten • Standardkonfiguration kann Gruppennachrichten aus Sicherheitsgründen deaktivieren Zum Aktivieren: • Gruppenantworten in Desktop-Einstellungen aktivieren • Oder Gruppenberechtigungen via `openclaw pairing` verwalten • Zuerst mit kleiner Gruppe testen um Funktion sicherzustellen

Telegram Bots haben standardmäßig Privacy Mode aktiviert: 1. @BotFather öffnen 2. /mybots senden 3. Ihren Bot auswählen 4. Bot Settings → Group Privacy → Turn OFF Alternativ: Bot zum Gruppenadmin machen - Admins können alle Nachrichten sehen unabhängig vom Privacy Mode.

Einfache Schritte: 1. Telegram öffnen, nach @BotFather suchen 2. /newbot senden 3. Namen wählen (Anzeigename) 4. Benutzernamen wählen (muss mit 'bot' enden) 5. Bereitgestelltes API-Token kopieren 6. Token zu Ihrer OpenClaw Config hinzufügen Optional: /setcommands für Befehlshinweise verwenden.

Meist ein Intents-Problem: 1. Gehen Sie zum Discord Developer Portal 2. Wählen Sie Ihre Anwendung → Bot 3. Aktivieren Sie diese Privileged Intents: • MESSAGE CONTENT INTENT • SERVER MEMBERS INTENT (wenn benötigt) 4. Speichern und Bot neu starten Auch prüfen: Bot hat Nachrichten-Lesen-Berechtigung im Kanal.

Erforderliche Intents: • Guilds - Basis-Server-Info • Guild Messages - Nachrichten empfangen • Message Content - Nachrichtentext lesen (PRIVILEGIERT) Optional: • Guild Members - Benutzer-Info (PRIVILEGIERT) • Direct Messages - DM-Unterstützung Hinweis: Privilegierte Intents erfordern Verifizierung für Bots in 100+ Servern.

Minimale Bot Token Scopes: • chat:write - Nachrichten senden • app_mentions:read - auf @Erwähnungen reagieren • channels:history - Kanalnachrichten lesen • im:history - DM-Nachrichten lesen Event Subscriptions: • message.channels • message.im • app_mention Minimal starten, nur bei Bedarf mehr hinzufügen.

401 bedeutet Authentifizierung fehlgeschlagen. Prüfen Sie: 1. API-Schlüssel ist korrekt (keine Extra-Leerzeichen) 2. Schlüssel ist nicht abgelaufen oder widerrufen 3. Schlüssel hat erforderliche Berechtigungen/Scopes 4. Sie erreichen keine Rate Limits 5. Konto hat ausreichend Credits/Quota Testen Sie Ihren Schlüssel direkt mit der Provider-API zuerst.

Schritt für Schritt diagnostizieren: 1. Modell direkt testen (curl/Postman) - wenn langsam, ist es das Modell 2. Ihre Internetgeschwindigkeit und Latenz prüfen 3. Anderes Modell ausprobieren (GPT-3.5 ist schneller als GPT-4) 4. Provider-Statusseite auf Ausfälle prüfen Lösungen: • Timeout-Einstellungen erhöhen • Streaming für lange Antworten verwenden • Anderen Modellanbieter ausprobieren

In Logs nach diesen Mustern suchen: • 'FATAL' oder 'PANIC' - kritische Fehler • 'OOM' - Speicher erschöpft • 'ECONNREFUSED' - kann nicht zu Abhängigkeit verbinden • Stack Traces - Code-Fehler Häufige Lösungen: • Speicherzuweisung erhöhen • Konfigurationsfehler beheben • Auf neueste Version aktualisieren • Verfügbarkeit externer Dienste prüfen

Config-Fehlerbehebung: 1. Haben Sie das Gateway neu gestartet? (Für die meisten Änderungen erforderlich) 2. Ist die JSON-Syntax korrekt? (Kommas, Anführungszeichen prüfen) 3. Richtige Config-Datei? (Sollte `~/.openclaw/openclaw.json` sein) 4. Läuft das Gateway? (`openclaw gateway status`) Config überprüfen: • `openclaw status` - Gesamtstatus prüfen • `openclaw models status` - Modellverbindungen prüfen • `openclaw health` - Gesundheitsprüfung

Log-Speicherorte: • Desktop: Ansicht → Logs (oder Einstellungen → Log-Ordner öffnen) • CLI: `~/.openclaw/logs/` oder stdout • Docker: `docker logs [container]` Wichtige Fehler-Schlüsselwörter: • ERROR, FATAL, PANIC - kritische Probleme • timeout, ETIMEDOUT - Verbindungsprobleme • 401, 403, 429 - Auth/Rate-Limit-Probleme • ENOENT - fehlende Datei/Pfad

In Ihrem Bericht enthalten: 1. OpenClaw Version (`openclaw --version`) 2. Betriebssystem und Version 3. Schritte zum Reproduzieren 4. Erwartetes vs. tatsächliches Verhalten 5. Relevante Logs (sensible Infos entfernen!) 6. Config-Ausschnitt (API-Schlüssel entfernen!) Einreichen bei: GitHub Issues Seite Für Sicherheitsprobleme: Sicherheitskontakt direkt per Email

Risiken öffentlicher Freigabe: • Jeder kann Anfragen an Ihre KI senden • API-Schlüssel könnten extrahiert werden • Missbrauchspotenzial (Spam, illegale Inhalte) • Kostenexplosion durch unbefugte Nutzung • Rechtliche Haftung für Bot-Aktionen Sichere Remote-Zugangsoptionen: • VPN (empfohlen) • SSH-Tunnel • Cloudflare Tunnel • Reverse Proxy mit Auth

Sicherheitscheckliste: 1. Ist es von offizieller/verifizierter Quelle? 2. Quellcode prüfen wenn verfügbar 3. Bewertungen/Issues von anderen Benutzern lesen 4. Verstehen welche Berechtigungen angefordert werden 5. Zuerst in isolierter Umgebung testen Warnzeichen: • Fordert unnötige Berechtigungen an • Verschleierter/minifizierter Code • Kein Quellcode verfügbar • Kein Community-Feedback

Sofort handeln: 1. Schlüssel auf Provider-Website JETZT widerrufen 2. Neuen Schlüssel generieren 3. Alle Configs mit neuem Schlüssel aktualisieren 4. Nutzungshistorie auf unbefugte Aufrufe prüfen 5. Überprüfen wie er geleakt wurde (Git-Historie? Öffentliches Repo?) Prävention: • Schlüssel niemals in Git committen • .env Dateien verwenden (in gitignore) • Secrets Management in Produktion verwenden

Sichere Standardwerte: • Gateway nur an localhost gebunden (127.0.0.1) • Skills standardmäßig deaktiviert • Gruppennachrichten initial deaktiviert • Rate Limiting aktiviert • Logging aktiviert (für Audit) • Minimale Berechtigungen für Kanal-Bots Merken Sie sich: restriktiv starten, nur bei Bedarf lockern.