Wie man Clawdbot auf einem VPS installiert

Clawdbot ist ein Open-Source, selbst gehosteter persönlicher KI-Assistent, der sich mit Ihren bevorzugten Messaging-Plattformen verbindet. Im Gegensatz zu cloudbasierten KI-Assistenten wie ChatGPT läuft Clawdbot vollständig auf Ihrer eigenen Infrastruktur, wodurch Sie die volle Kontrolle über Ihre Daten und Privatsphäre behalten. In diesem Artikel führen wir Sie durch den Installationsprozess von Clawdbot auf einem VPS mit Node.js. Wir empfehlen LightNode als Ihren VPS-Anbieter.

Was ist Clawdbot?

Clawdbot ist ein leistungsstarker persönlicher KI-Assistent, der in Ihren Lieblings-Apps und Messaging-Plattformen lebt. Er verbindet sich mit WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat und mehr und verwandelt Large Language Models in einen wirklich persönlichen, jederzeit verfügbaren Begleiter. Wichtige Funktionen sind:

• Multi-Plattform-Unterstützung: Funktioniert auf über 10 Messaging-Plattformen
• Persistenter Speicher: Merkt sich Ihre Vorlieben und vergangene Gespräche über die Zeit
• Proaktive Aktionen: Kann Aktionen ausführen, Erinnerungen setzen und Benachrichtigungen senden
• Selbst gehostet: Volle Datenhoheit und Kontrolle über die Privatsphäre
• Anpassbar: Erweiterbar mit Skills und Tools
• Immer aktiv: Läuft 24/7 auf Ihrem VPS oder lokalen Rechner

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

1. Einen VPS-Server: Sie können aus verschiedenen Cloud-Anbietern wählen. Wir empfehlen LightNode wegen seiner hervorragenden Leistung und globalen Abdeckung.
2. Grundkenntnisse in der Kommandozeile: Vertrautheit mit Terminalbefehlen ist hilfreich.
3. Node.js installiert: Stellen Sie sicher, dass Node.js Version 22 oder höher auf Ihrem Server installiert ist.
4. Minimale Systemanforderungen: 2GB RAM, 1 vCPU, 10GB Festplattenspeicher (für den produktiven Einsatz werden 4GB RAM empfohlen).

Warum wir LightNode VPS empfehlen

LightNode ist aus mehreren Gründen eine ausgezeichnete Wahl für das Hosting von Clawdbot:

Hauptvorteile von LightNode

• Erschwingliche Preise: Pläne beginnen bei 7,71 $/Monat mit stündlicher Abrechnung, sodass Sie ohne langfristige Verpflichtungen testen können.
• 40+ globale Standorte: Rechenzentren auf 6 Kontinenten, darunter USA, Europa, Asien, Naher Osten und Afrika, sorgen für geringe Latenz weltweit.
• Hohe Leistung: NVMe SSD-Speicher und CPUs mit hoher Taktfrequenz bieten exzellente Performance für KI-Workloads.
• 99,95 % Verfügbarkeitsgarantie: Zuverlässige Infrastruktur mit lokalem BGP-Zugang stellt sicher, dass Ihr Assistent immer erreichbar ist.
• Flexible Abrechnung: Bezahlen Sie nur, was Sie nutzen, mit stündlicher Abrechnung – ideal zum Testen und Skalieren.
• Entwicklerfreundlich: Voller Root-Zugriff, sofortige Bereitstellung und Unterstützung für Linux und Windows.
• Kostenlose Snapshots: Ein kostenloser Snapshot pro VPS für einfache Backups und Wiederherstellung.
• Neukundenbonus: Erhalten Sie bis zu 15 $ Guthaben bei Ihrer ersten Aufladung.

Empfohlene LightNode-Konfiguration für Clawdbot

Diese Konfiguration bietet ausreichend Ressourcen für den Betrieb von Clawdbot und lässt Raum für Wachstum bei steigendem Nutzungsvolumen.

Jetzt mit LightNode starten

Schritt 1: VPS einrichten

1. Instanz starten: Melden Sie sich bei LightNode an und erstellen Sie eine neue VPS-Instanz. Wir empfehlen, einen Standort in der Nähe Ihrer Hauptnutzer für optimale Latenz zu wählen. Für globalen Zugriff sind Singapur oder Hongkong für asiatische Nutzer ideal, während Silicon Valley gut für nordamerikanische Nutzer geeignet ist.

2. Betriebssystem wählen: Wählen Sie Ubuntu 22.04 LTS (empfohlen) oder Ubuntu 24.04. Diese Versionen bieten exzellente Node.js-Unterstützung und sind weit verbreitet getestet.

3. SSH-Zugang: Verwenden Sie einen SSH-Client, um auf Ihren Server zuzugreifen:

   ssh username@your_server_ip
   

Schritt 2: Node.js installieren

Clawdbot benötigt Node.js Version 22 oder höher. So installieren Sie es auf Ubuntu:

# Paketlisten aktualisieren
sudo apt update

# Node.js 22 aus dem NodeSource-Repository installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Installation überprüfen
node --version
# Ausgabe sollte sein: v22.x.x

Alternativ können Sie NVM (Node Version Manager) für mehr Flexibilität verwenden:

# NVM installieren
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Node.js 22 installieren
nvm install 22
nvm use 22

# Installation überprüfen
node --version

Schritt 3: Clawdbot installieren

Es gibt mehrere Installationsmethoden. Wählen Sie die, die am besten zu Ihren Bedürfnissen passt.

Methode 1: Offizielles Installationsskript (Empfohlen für Anfänger)

Das Installationsskript ist die einfachste Methode und kümmert sich automatisch um Abhängigkeiten:

# Installationsskript herunterladen und ausführen
curl -fsSL https://clawd.bot/install.sh | bash

Dieser Befehl wird:

• Ihr Betriebssystem erkennen
• Sicherstellen, dass Node.js 22+ installiert ist
• Clawdbot global via npm installieren
• Die notwendigen Pfade einrichten
• Den doctor-Befehl ausführen, um die Installation zu überprüfen

Methode 2: Globale Installation via npm

Für Nutzer, die mit npm vertraut sind:

# Clawdbot global installieren
npm install -g clawdbot@latest

# Oder mit pnpm (schneller)
pnpm add -g clawdbot@latest

# Installation überprüfen
clawdbot --version

Methode 3: Installation aus dem Quellcode (Für Entwickler)

# Repository klonen
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Abhängigkeiten installieren
pnpm install

# UI bauen
pnpm ui:build

# Projekt bauen
pnpm build

# Onboarding-Assistent starten
./dist/entry.js onboard --install-daemon

Methode 4: Docker-Installation (Optional)

Für containerisierte Bereitstellung:

# Repository klonen
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Docker-Setup-Skript ausführen
./docker-setup.sh

Schritt 4: Onboarding-Assistent ausführen

Nach der Installation starten Sie den Onboarding-Assistenten, um Clawdbot zu konfigurieren:

# Interaktiven Onboarding-Assistenten starten
clawdbot onboard --install-daemon

Der Assistent führt Sie durch:

1. Gateway-Konfiguration: Wählen Sie lokalen oder entfernten Gateway-Modus und legen Sie den Gateway-Port fest (Standard: 18789).
2. Authentifizierung einrichten: Konfigurieren Sie Ihren KI-Modellanbieter.
   • Anthropic (Claude): API-Schlüssel oder OAuth (empfohlen)
   • OpenAI (ChatGPT/Codex): API-Schlüssel
   • Andere Anbieter: Eigene Endpunkte und API-Schlüssel
3. Kanal-Konfiguration: Richten Sie Messaging-Plattformen ein:
   • WhatsApp: QR-Code-Login
   • Telegram: Bot-Token von @BotFather
   • Discord: Bot-Token vom Discord Developer Portal
   • Slack: OAuth oder Bot-Token
4. Service-Installation: Installieren Sie das Gateway als Hintergrunddienst (systemd unter Linux).
5. Agenten-Identität: Legen Sie Persönlichkeit und Standardverhalten Ihres Assistenten fest.

Schritt 5: Gateway starten

Nach Abschluss des Onboarding-Assistenten sollte das Gateway automatisch starten. Sie können den Status prüfen mit:

# Gateway-Status prüfen
clawdbot gateway status

# Logs anzeigen
clawdbot logs --follow

# Gesundheitsstatus prüfen
clawdbot health

Manueller Start (falls Dienst nicht läuft)

# Gateway im Vordergrund starten
clawdbot gateway --port 18789 --verbose

Dienstverwaltung

# Dienst starten
systemctl --user start clawdbot-gateway.service

# Dienst stoppen
systemctl --user stop clawdbot-gateway.service

# Dienst neu starten
systemctl --user restart clawdbot-gateway.service

# Dienst beim Systemstart aktivieren
systemctl --user enable clawdbot-gateway.service

# Dienst-Logs anzeigen
journalctl --user -u clawdbot-gateway -f

Schritt 6: Dashboard aufrufen

Die Clawdbot Control UI ist über Ihren Webbrowser erreichbar:

http://your_server_ip:18789/

Wenn Sie während des Onboardings eine Authentifizierung eingerichtet haben, müssen Sie das Gateway-Token eingeben, um auf das Dashboard zuzugreifen.

Fernzugriff via SSH-Tunnel

Für sicheren Fernzugriff:

# SSH-Tunnel von Ihrem lokalen Rechner einrichten
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Dann lokal zugreifen unter
http://localhost:18789/

Schritt 7: Ersten Kanal verbinden

WhatsApp

Um WhatsApp zu verbinden:

# QR-Code generieren und anzeigen
clawdbot channels login

# Mit WhatsApp scannen:
# Einstellungen → Verknüpfte Geräte → Gerät verknüpfen

Nach dem Scannen verbindet sich Ihr WhatsApp mit Clawdbot.

Telegram

1. Erstellen Sie einen Bot, indem Sie @BotFather auf Telegram anschreiben
2. Folgen Sie den Anweisungen, um einen neuen Bot zu erstellen
3. Kopieren Sie den bereitgestellten Bot-Token
4. Fügen Sie den Bot zu Clawdbot hinzu:

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. Gehen Sie zum Discord Developer Portal
2. Erstellen Sie eine neue Anwendung
3. Aktivieren Sie den Bot unter dem Tab „Bot“
4. Kopieren Sie den Bot-Token
5. Laden Sie den Bot mit den entsprechenden Berechtigungen auf Ihren Discord-Server ein
6. Fügen Sie ihn zu Clawdbot hinzu:

clawdbot channels add --channel discord --token "your_discord_bot_token"

Schritt 8: DM-Sicherheit konfigurieren

Standardmäßig verwendet Clawdbot einen Pairing-Modus für Direktnachrichten, bei dem unbekannte Absender einen Pairing-Code erhalten und ihre Nachrichten erst nach Freigabe verarbeitet werden.

# Ausstehende Pairing-Anfragen auflisten
clawdbot pairing list whatsapp

# Pairing-Anfrage genehmigen
clawdbot pairing approve whatsapp <pairing_code>

# Genehmigte Pairings anzeigen
clawdbot pairing list whatsapp --approved

Dieses Verhalten können Sie in der Konfigurationsdatei unter ~/.clawdbot/clawdbot.json anpassen.

Schritt 9: Setup testen

Senden Sie eine Testnachricht, um zu überprüfen, ob alles funktioniert:

# Testnachricht senden
clawdbot message send --to +15555550123 --message "Hallo von Clawdbot!"

# Oder per Telegram testen
clawdbot message send --to @your_telegram_username --message "Hallo!"

Alternativ senden Sie eine Nachricht direkt an Ihr verbundenes WhatsApp/Telegram/Discord, und Ihr Clawdbot-Assistent sollte antworten.

Schritt 10: Nginx konfigurieren (Optional)

Für den produktiven Einsatz empfehlen wir, einen Reverse Proxy mit Nginx einzurichten, um die Sicherheit zu erhöhen und SSL-Zertifikate zu verwalten.

Nginx installieren

sudo apt install -y nginx

Nginx konfigurieren

Bearbeiten Sie die Nginx-Konfigurationsdatei:

sudo nano /etc/nginx/sites-available/clawdbot

Fügen Sie folgende Konfiguration hinzu:

server {
    listen 80;
    server_name your-domain.com;  # Ersetzen Sie durch Ihre Domain

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Konfiguration aktivieren

# Symbolischen Link erstellen
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Nginx-Konfiguration testen
sudo nginx -t

# Nginx neu starten
sudo systemctl restart nginx

SSL mit Certbot hinzufügen (Empfohlen)

# Certbot installieren
sudo apt install -y certbot python3-certbot-nginx

# SSL-Zertifikat erhalten
sudo certbot --nginx -d your-domain.com

# Certbot konfiguriert Nginx automatisch mit SSL

Danach ist Ihr Clawdbot erreichbar unter:

https://your-domain.com/

Häufige Probleme und Lösungen

Gateway startet nicht

Wenn das Gateway nicht startet:

# Auf Konfigurationsfehler prüfen
clawdbot doctor

# Detaillierte Logs ansehen
journalctl --user -u clawdbot-gateway -n 50

Speicherfehler (Out of Memory)

Auf VPS mit 2GB RAM kann es bei Updates zu Speicherproblemen kommen. Legen Sie eine Swap-Datei an:

# 2GB Swap-Datei erstellen
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Swap dauerhaft aktivieren
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Port bereits belegt

Wenn Port 18789 bereits verwendet wird:

# Herausfinden, was den Port nutzt
sudo lsof -i :18789

# Oder einen anderen Port verwenden
clawdbot gateway --port 18889

Bot reagiert nicht

Wenn Ihr Bot nicht antwortet:

1. Gateway-Status prüfen: clawdbot gateway status
2. Kanal-Konfiguration überprüfen: Stellen Sie sicher, dass Tokens korrekt sind und Kanäle aktiviert sind
3. Authentifizierung prüfen: API-Schlüssel sind gültig
4. Logs ansehen: clawdbot logs --follow auf Fehlermeldungen prüfen

Clawdbot aktualisieren

Um auf die neueste Version zu aktualisieren:

# Installationsskript erneut ausführen
curl -fsSL https://clawd.bot/install.sh | bash

# Oder via npm aktualisieren
npm update -g clawdbot@latest

# Gateway neu starten
clawdbot gateway restart

# Gesundheitsstatus prüfen
clawdbot health

Fazit

Die Installation von Clawdbot auf einem VPS ist ein unkomplizierter Prozess, der Ihnen einen leistungsstarken, selbst gehosteten KI-Assistenten bietet, der auf mehreren Messaging-Plattformen zugänglich ist. Mit LightNodes erschwinglichen Preisen, globaler Abdeckung und leistungsstarker Infrastruktur können Sie Ihren persönlichen KI-Assistenten mit Zuversicht bereitstellen.

Wenn Sie dieser Anleitung folgen, sollte Clawdbot in etwa 20–30 Minuten auf Ihrem VPS laufen und Ihnen einen jederzeit verfügbaren KI-Begleiter bieten, der Ihre Privatsphäre respektiert und Ihnen die volle Kontrolle über Ihre Daten gibt.

Für weitere Anpassungen und erweiterte Funktionen konsultieren Sie die offizielle Dokumentation auf der Clawdbot GitHub-Seite und erkunden Sie Community-Diskussionen für zusätzliche Einblicke und Tipps.

Zusätzliche Ressourcen

• Clawdbot Offizielle Dokumentation
• Clawdbot GitHub Repository
• LightNode VPS – Empfohlener VPS-Anbieter
• Clawdbot Community Discord
• Skills Marketplace – Erweitern Sie Ihren Assistenten mit zusätzlichen Skills