Clawdbot Installation Header – Terminal mit Messaging-Icons und Hummer-Maskottchen

Clawdbot installieren: Von der ersten Zeile zum laufenden KI-Assistenten

Clawdbot ist ein Open-Source KI-Assistent, der auf dem eigenen Rechner läuft und über Messaging-Apps wie WhatsApp, Telegram, Slack oder Discord gesteuert wird. Die aktuelle Version v2026.1.24 bringt ein ausgereiftes Plugin-System, verschlüsselte Auth-Token-Speicherung und standardmäßig gesperrte DMs für mehr Sicherheit mit.

Diese Anleitung führt durch die komplette Installation auf macOS, Linux und Windows – vom Systemcheck über das Onboarding bis zur ersten Nachricht. Wer bereits die Einführung zu MoltBot/ClawdBot kennt, kann direkt loslegen.

Inhaltsverzeichnis

Systemvoraussetzungen

Bevor es losgeht, ein kurzer Check der Voraussetzungen. Clawdbot ist schlank, stellt aber einige Anforderungen an die Laufzeitumgebung.

Node.js ab Version 22 ist zwingend erforderlich. Clawdbot nutzt moderne JavaScript-Features, die in älteren Node-Versionen nicht verfügbar sind. Wer Node noch nicht installiert hat oder eine ältere Version nutzt, sollte über nvm (Node Version Manager) aktualisieren.

Hardware: Minimal reichen 1 GB RAM und ein CPU-Kern. Für den Alltag mit Browser-Automatisierung und mehreren Messaging-Kanälen empfehlen sich 2 GB RAM. Clawdbot selbst ist nicht rechenintensiv – die eigentliche KI-Arbeit erledigt das API-Backend in der Cloud.

Betriebssysteme: macOS und Linux werden nativ unterstützt. Windows funktioniert über WSL2 (Windows Subsystem for Linux), das dringend empfohlen wird. Nativer Windows-Support ohne WSL2 ist nicht vorgesehen.

KI-Backend: Für die beste Erfahrung wird ein Anthropic-Account mit Claude Pro oder Max empfohlen. Claude Opus 4.5 bietet die stärkste Performance bei agentenbasierten Aufgaben und Prompt-Injection-Resistenz. Alternativ funktionieren OpenAI-Modelle oder lokale LLMs via Ollama.

Installation über npm

Die empfohlene Installationsmethode ist über npm oder pnpm. In einem Terminal folgende Befehle ausführen:

Code:

          # Installation global via npm
npm install -g clawdbot@latest

# Alternativ mit pnpm
pnpm add -g clawdbot@latest

# Onboarding starten und Gateway als Daemon installieren
clawdbot onboard --install-daemon

Der Onboarding-Wizard führt interaktiv durch die Konfiguration. Er fragt nacheinander das KI-Modell, die gewünschten Messaging-Provider und optionale Skills ab. Am Ende wird das Gateway als Systemdienst installiert – unter macOS via launchd, unter Linux via systemd – sodass Clawdbot auch nach einem Neustart automatisch weiterläuft.

Wer lieber aus dem Quellcode baut, kann das Repository klonen:

Code:

          git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
pnpm clawdbot onboard --install-daemon

Für die Entwicklung mit Auto-Reload steht pnpm gateway:watch zur Verfügung. Hinweis: pnpm clawdbot führt TypeScript direkt über tsx aus, während pnpm build das dist-Verzeichnis für den Produktionsbetrieb erzeugt.

Clawdbot im Unternehmen einsetzen – Vibe Coding Consulting

Die Installation von Clawdbot ist der erste Schritt – doch für den produktiven Einsatz im Team oder Unternehmen braucht es mehr: Security-Konzepte, Messaging-Richtlinien und eine Integration in bestehende DevOps-Workflows.

NCA Vibe Coding Consulting hilft bei der professionellen Einführung von KI-Agenten und Coding-Assistenten. Ob Clawdbot, Claude Code oder MCP-Server – wir begleiten von der Evaluierung über die sichere Konfiguration bis zum produktiven Rollout im Entwicklerteam.

Docker-Installation

Für isolierten Betrieb oder Server-Deployments bietet sich Docker an. Das Repository enthält ein Dockerfile und ein separates Dockerfile.sandbox für den sandboxed Betrieb. Docker eignet sich besonders für den Einsatz auf einem VPS oder dedizierten Server, wo man maximale Isolation wünscht.

Code:

          # Dockerfile aus dem Repository nutzen
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
docker build -t clawdbot .
docker run -d --name clawdbot clawdbot

Die Docker-Variante empfiehlt sich vor allem für den produktiven Betrieb: Sie isoliert den Assistenten vom Host-System und begrenzt den Zugriff auf Dateisystem und Netzwerk. Wer Clawdbot auf einem Mac Mini als Always-on-Server betreibt, kann Docker als zusätzliche Sicherheitsschicht einsetzen.

KI-Modell konfigurieren

Im Onboarding-Wizard wählt man das KI-Backend. Clawdbot unterstützt mehrere Anbieter und bietet vordefinierte Model-Shorthands für die gängigsten Modelle: opus, sonnet, gpt, gpt-mini, gemini und gemini-flash. Eigene Konfigurationen haben Vorrang vor den Standardwerten.

Anthropic Claude (empfohlen): Für den Zugang benötigt man entweder einen API-Key von console.anthropic.com oder ein bestehendes Claude Pro/Max-Abo. Im Onboarding wird der API-Key eingegeben und verschlüsselt gespeichert – seit Version 2026.1.15 nutzt Clawdbot Keychain (macOS) bzw. SecurePrefs für die Token-Speicherung.

OpenAI: GPT-Modelle funktionieren ebenfalls, bieten aber weniger Robustheit gegen Prompt-Injection als Claude. Für einfache Aufgaben reicht GPT-4o, für komplexe Agenten-Workflows ist Claude die bessere Wahl.

Lokale Modelle via Ollama: Wer vollständig lokal bleiben will, kann Open-Source-Modelle über Ollama einbinden. Die Performance hängt dann von der eigenen Hardware ab – für den vollen Funktionsumfang empfiehlt sich mindestens ein Modell mit 70B Parametern.

Code:

          # Model-Status und Auth-Konfiguration prüfen
clawdbot models status

# Auth-Reihenfolge festlegen
clawdbot models auth order set anthropic,openai

# Provider-Auth per CLI
clawdbot models auth login

Messaging-Provider anbinden

Das Herzstück von Clawdbot ist die Anbindung an bestehende Messaging-Apps. Im Onboarding oder nachträglich per Konfiguration lassen sich folgende Provider einrichten:

WhatsApp: Verbindung per QR-Code über die Baileys-Bibliothek. Clawdbot emuliert die WhatsApp-Web-Schnittstelle. Broadcast-Gruppen für Multi-Agent-Replies werden seit Version 2026.1.9 unterstützt.

Telegram: Einrichtung über einen Bot-Token von BotFather. Unterstützt Inline-Keyboard-Buttons, Audio-als-Voice-Nachrichten und Callback-Routing.

Slack und Discord: Integration über API-Tokens. Discord unterstützt Threading und stabile Reconnects, Slack bietet DM-Policy-Konfiguration und Reaction-Routing.

Signal und iMessage: Signal funktioniert über die signal-cli-Brücke. iMessage ist nativ auf macOS verfügbar und benötigt keine zusätzliche Konfiguration.

Microsoft Teams: Seit Version 2026.1.15 als separates Plugin verfügbar. Installation über clawdbot plugins install @clawdbot/msteams. Unterstützt Polling, Attachments und ausgehende CLI-Nachrichten.

Wichtig seit v2026.1.8: Eingehende DMs sind standardmäßig auf allen Providern gesperrt. Neue Kontakte durchlaufen einen Pairing-Prozess – sie erhalten einen Code, der per CLI bestätigt werden muss. Öffentliche DMs erfordern ein explizites Opt-in über dmPolicy="open" und Allowlist-Konfiguration.

Code:

          # Pairing-Anfragen einsehen
clawdbot pairing list --provider whatsapp

# Kontakt freischalten
clawdbot pairing approve --provider whatsapp <code>

# Nachricht senden
clawdbot message send --to +491234567890 --message "Hallo vom Clawdbot"

Gateway und Daemon verwalten

Das Gateway ist der zentrale Prozess, der Sessions, Provider, Tools und Events koordiniert. Nach der Installation läuft es als Systemdienst im Hintergrund.

Code:

          # Gateway manuell starten (mit Verbose-Logging)
clawdbot gateway --port 18789 --verbose

# Gateway-Status prüfen (inkl. SSH-Loopback und JSON-Output)
clawdbot gateway status

# Gateway entdecken (lokales Netzwerk + DNS-SD)
clawdbot gateway discover

# Logs einsehen (pretty, plain oder JSONL)
clawdbot logs

# System-Diagnose ausführen
clawdbot doctor

Der Befehl clawdbot doctor ist das wichtigste Diagnosetool. Er prüft die Konfiguration, migriert veraltete Einstellungen automatisch, erkennt riskante DM-Policies und verifiziert die OAuth-Verbindungen. Nach jedem Update sollte man clawdbot doctor ausführen.

Für den Always-on-Betrieb sorgt der Daemon dafür, dass das Gateway bei Systemstart automatisch hochfährt. Unter macOS geschieht das über launchd, unter Linux über systemd. Terminierungssignale werden seit der letzten Version korrekt an Child-Prozesse weitergeleitet, sodass keine verwaisten Prozesse mehr entstehen.

Sicherheitskonfiguration nach der Installation

Sicherheit ist bei Clawdbot nicht optional – der Assistent hat potenziell Zugriff auf Dateisystem, Shell und Messaging-Konten. Folgende Schritte sollten direkt nach der Installation durchgeführt werden:

Security Audit ausführen: Der Befehl clawdbot security audit prüft die Konfiguration auf Schwachstellen. Mit dem Flag --fix werden erkannte Probleme automatisch behoben, etwa zu weit geöffnete Dateirechte auf State-Verzeichnissen.

Sandbox aktivieren: Seit Version 2026.1.8 ist der Standard-Sandbox-Scope auf "agent" gesetzt – jeder Agent erhält seinen eigenen Container bzw. Workspace. Für maximale Isolation kann man auf "session" wechseln, wobei jede Session ihren eigenen Sandbox-Bereich bekommt.

DM-Policies prüfen: Standardmäßig ist dmPolicy auf "pairing" gesetzt. Unbekannte Absender erhalten einen Pairing-Code und werden erst nach manueller Bestätigung freigeschaltet. Niemals dmPolicy="open" setzen, ohne eine Allowlist zu konfigurieren.

Non-interaktive Installation: Für automatisierte Deployments steht clawdbot onboard --non-interactive --accept-risk zur Verfügung. Das Flag --accept-risk bestätigt, dass man die Sicherheitsdokumentation gelesen hat.

Code:

          # Security-Audit mit automatischer Korrektur
clawdbot security audit --fix

# Sandbox-Konfiguration prüfen
clawdbot doctor

# Konfiguration einsehen
clawdbot config get

Plugins und Skills einrichten

Clawdbot lässt sich über zwei Mechanismen erweitern: Plugins für Provider-Integrationen und Skills für aufgabenspezifische Fähigkeiten.

Plugins erweitern die technische Infrastruktur. Seit Version 2026.1.15 werden bundled Plugins standardmäßig deaktiviert mitgeliefert und können bei Bedarf aktiviert oder durch installierte Versionen überschrieben werden. Neue Plugins wie Antigravity, Gemini CLI OAuth und Copilot Proxy sind als Provider-Plugins verfügbar.

Skills sind Markdown-Dateien (SKILL.md), die dem Agenten beschreiben, wie er bestimmte Aufgaben erledigen soll. Über 50 vordefinierte Skills sind enthalten – von Gmail-Integration über GitHub-Workflows bis hin zu Smart-Home-Steuerung. Eigene Skills lassen sich einfach als Markdown-Dateien im Skills-Verzeichnis anlegen.

Code:

          # Plugin installieren (z.B. Microsoft Teams)
clawdbot plugins install @clawdbot/msteams

# Browser-Extension installieren
clawdbot browser extension install

# Agent direkt ansprechen
clawdbot agent --message "Zeige meine offenen GitHub Issues" --thinking high

Der Parameter --thinking high aktiviert den erweiterten Denkmodus, bei dem der Agent komplexere Aufgaben in mehrere Schritte zerlegt und sorgfältiger plant. Für einfache Aufgaben kann dieser Parameter weggelassen werden.

Updates und Release-Kanäle

Clawdbot entwickelt sich rasant – teils kommen mehrere Releases pro Tag. Die Software bietet drei Release-Kanäle: stable für getestete Versionen (Tags im Format vYYYY.M.D), beta für Vorabversionen (vYYYY.M.D-beta.N) und dev als Entwicklungs-Head des main-Branch.

Code:

          # Auf neueste stabile Version aktualisieren
npm update -g clawdbot@latest

# Release-Kanal wechseln
clawdbot update --channel stable|beta|dev

# Nach Update: Diagnose und Migration
clawdbot doctor

Nach jedem Update führt clawdbot doctor automatisch notwendige Konfigurationsmigrationen durch. Ältere Konfigurationsformate werden beim Gateway-Start erkannt und umgeschrieben. Wer den stable-Kanal nutzt, bekommt nur getestete Releases – empfohlen für den produktiven Einsatz.

Troubleshooting: Häufige Installationsprobleme

Die häufigsten Probleme bei der Installation und ihre Lösungen:

Node-Version zu alt: Clawdbot erfordert Node 22 oder neuer. Fehlermeldungen wie "SyntaxError: Unexpected token" deuten auf eine veraltete Node-Version hin. Mit node --version prüfen und gegebenenfalls über nvm aktualisieren.

Gateway startet nicht nach Reboot: clawdbot doctor ausführen – der Befehl prüft, ob der Systemdienst korrekt installiert ist und repariert den Service-Eintrag bei Bedarf. Unter macOS muss das Log-Verzeichnis für launchd existieren.

WhatsApp-Verbindung bricht ab: Die Baileys-Bibliothek kann bei instabilen Verbindungen den Session-State verlieren. In diesem Fall die WhatsApp-Session neu aufbauen und den QR-Code erneut scannen. Die maximale Mediengröße für eingehende Nachrichten ist seit 2026.1.8 konfigurierbar.

Auth-Token ungültig: Mit clawdbot models status den Auth-Status prüfen. Der Doctor-Befehl erkennt abgelaufene OAuth-Tokens und zeigt den Gesundheitsstatus aller konfigurierten Provider an.

Control UI nicht erreichbar: Die Web-Oberfläche authentifiziert über URL-Token-Parameter. Falls nach einem Re-Onboard die UI nicht erreichbar ist, wurde dieses Verhalten in den neuesten Versionen korrigiert – Token aus der URL werden jetzt immer angewendet.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.

Ihr Ansprechpartner für KI Content Marketing

Roland Golla ist nicht nur Gründer von Never Code Alone, sondern ein anerkannter IT-Spezialist mit über 20 Jahren Erfahrung in der Softwareentwicklung. Mit der Expertise aus über 300 erfolgreich abgeschlossenen Web-Projekten entwickelt er heute das NCA AI CMS – eine Lösung, die tiefgreifendes technisches Know-how mit modernster Künstlicher Intelligenz verbindet.

Als offizieller Cypress.IO Ambassador, Speaker auf internationalen Konferenzen und YouTube-Creator für führende Testing-Tools weiß er genau, worauf es bei digitaler Qualität ankommt. Sein Fokus: KI-Systeme (wie Claude 3 und Mistral AI), die nicht nur Texte generieren, sondern echte Geschäftsprozesse für lokale Dienstleister automatisieren und messbare Ergebnisse liefern.

Häufige Fragen zur Clawdbot Installation

Die wichtigsten Fragen und Antworten rund um die Installation und Einrichtung von Clawdbot.

Welche Node.js Version brauche ich für Clawdbot?

Clawdbot benötigt Node.js ab Version 22. Ältere Versionen werden nicht unterstützt und führen zu Syntaxfehlern. Die empfohlene Methode zur Installation ist über nvm (Node Version Manager), um einfach zwischen Versionen wechseln zu können.

Wie installiere ich Clawdbot auf macOS?

Auf macOS läuft Clawdbot nativ. Installation über Terminal: npm install -g clawdbot@latest, dann clawdbot onboard --install-daemon. Der Wizard führt durch Modellwahl, Provider-Anbindung und Gateway-Installation. Das Gateway wird als launchd-Service eingerichtet und startet automatisch beim Systemstart.

Funktioniert Clawdbot auf Windows?

Ja, aber ausschließlich über WSL2 (Windows Subsystem for Linux). Eine native Windows-Unterstützung ohne WSL2 ist nicht vorgesehen. Nach der WSL2-Installation verhält sich die Einrichtung identisch zur Linux-Installation.

Wie verbinde ich Clawdbot mit WhatsApp?

WhatsApp wird über einen QR-Code verbunden. Beim Onboarding oder nachträglich per Konfiguration zeigt Clawdbot einen QR-Code an, den man mit der WhatsApp-App auf dem Smartphone scannt – ähnlich wie bei WhatsApp Web. Die Verbindung nutzt die Baileys-Bibliothek.

Ist die Installation von Clawdbot kostenlos?

Die Software selbst ist kostenlos und Open Source unter MIT-Lizenz. Kosten entstehen durch die API-Nutzung des KI-Backends. Bei Anthropic Claude liegen diese je nach Nutzung zwischen 10 und 150 Euro pro Monat. Wer ein bestehendes Claude Pro- oder Max-Abo hat, kann dieses direkt nutzen.

Wie sichere ich meine Clawdbot-Installation ab?

Nach der Installation clawdbot security audit --fix ausführen. Die Sandbox sollte aktiviert sein (Standard seit v2026.1.8), DMs sind standardmäßig über Pairing geschützt. Clawdbot auf dedizierter Hardware oder in Docker betreiben, nicht auf dem Hauptrechner mit sensiblen Daten.

Welches KI-Modell ist für Clawdbot am besten geeignet?

Claude Opus 4.5 von Anthropic wird empfohlen. Es bietet die beste Performance bei agentenbasierten Aufgaben und die stärkste Resistenz gegen Prompt-Injection-Angriffe. Alternativ funktionieren OpenAI GPT-Modelle oder lokale Modelle über Ollama.

Wie aktualisiere ich Clawdbot auf die neueste Version?

Mit npm update -g clawdbot@latest oder über clawdbot update --channel stable. Nach jedem Update clawdbot doctor ausführen – der Befehl migriert automatisch veraltete Konfigurationen und prüft die Systemgesundheit.

Kann ich Clawdbot mit Docker betreiben?

Ja, das Repository enthält ein Dockerfile und ein Dockerfile.sandbox für isolierten Betrieb. Docker empfiehlt sich besonders für VPS-Deployments und den produktiven Einsatz, da es den Assistenten vom Host-System isoliert und den Systemzugriff begrenzt.

Wie richte ich Microsoft Teams mit Clawdbot ein?

Seit Version 2026.1.15 ist Microsoft Teams ein separates Plugin. Installation über clawdbot plugins install @clawdbot/msteams. Das Plugin unterstützt Polling, Dateianhänge, ausgehende Nachrichten und Per-Channel-Policies.

Was macht clawdbot doctor?

Der Doctor-Befehl ist das zentrale Diagnosetool. Er prüft die Gateway-Konfiguration, migriert veraltete Einstellungen, erkennt riskante DM-Policies, verifiziert OAuth-Verbindungen und repariert fehlerhafte Service-Einträge. Nach Updates und bei Problemen immer als erstes ausführen.

Wie installiere ich Clawdbot auf einem Mac Mini als Always-on-Server?

Mac Mini eignet sich ideal als Always-on-Host. Node.js 22 über nvm installieren, dann npm install -g clawdbot@latest und clawdbot onboard --install-daemon. Der Gateway-Daemon startet automatisch nach jedem Reboot. Für zusätzliche Sicherheit empfiehlt sich Docker als Isolation-Layer.

Weitere KI-Tools im Glossar

Die ClawdBot-Installation ist der erste Schritt – aber das KI-Ökosystem bietet noch viel mehr. Von Claude Agent Teams über Moltbook bis zu OpenClaw – das NCA KI-Tools-Glossar erklärt die wichtigsten Werkzeuge praxisnah und technisch fundiert.