Einrichtungsanleitung

Speicherorte

Clawdbot trennt Konfiguration von der Installation:

Diese Trennung ermöglicht einfache Updates ohne persönliche Konfigurationen zu beschädigen.

Voraussetzungen

• Node.js >= 22
• pnpm (empfohlen) oder npm
• Docker (optional, für Container-Setup)

Installationsmethoden

Schnellinstallation (Empfohlen)

curl -fsSL https://clawd.bot/install.sh | bash

Über npm

npm i -g clawdbot
clawdbot setup

Über pnpm

pnpm add -g clawdbot
clawdbot setup

Workflows

Stabiler Workflow (macOS App)

Für die meisten Benutzer bietet die macOS-App die einfachste Erfahrung:

1. Installieren - Clawdbot.app herunterladen und starten
2. Einführung - Einrichtungsassistenten abschließen
3. Berechtigungen - Erforderlichen Systemzugriff gewähren
4. Gateway-Modus - Sicherstellen, dass Gateway im lokalen Modus ist
5. Kanäle - Kommunikationskanäle verknüpfen (WhatsApp, Telegram, etc.)
6. Überprüfen - clawdbot health ausführen um die Einrichtung zu bestätigen

Entwicklungs-Workflow

Für Mitwirkende und fortgeschrittene Benutzer:

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

# Abhängigkeiten installieren
pnpm install

# Entwicklungs-Gateway mit Hot-Reload starten
pnpm gateway:watch

Konfigurieren Sie die macOS-App im lokalen Verbindungsmodus. Die App verbindet sich mit dem laufenden Gateway auf dem konfigurierten Port (Standard: ws://127.0.0.1:18789).

Anmeldedatenspeicherung

Plattformhinweise

macOS

Die App verwaltet das Gateway automatisch über LaunchAgent.

Linux

Verwendet systemd-Benutzerdienst. Aktivieren Sie Lingering, um das Herunterfahren des Dienstes beim Abmelden zu verhindern:

sudo loginctl enable-linger $USER

Windows (WSL2)

Führen Sie Clawdbot in WSL2 mit einer Linux-Distribution aus. Die Einrichtung ist identisch mit Linux.

Aktualisierungsstrategie

Bewahren Sie persönliche Inhalte in ~/.clawdbot/-Verzeichnissen getrennt von der Installation auf:

# Über npm aktualisieren
npm update -g clawdbot

# Oder neuesten Quellcode abrufen
cd clawdbot
git pull
pnpm install

Ihr Arbeitsbereich und Ihre Konfiguration bleiben bei Updates unverändert.

Gesundheitsprüfung

Überprüfen Sie Ihre Installation:

clawdbot health

Erwartete Ausgabe:

• Gateway-Status: Läuft
• Port: 18789
• Kanäle: Verbunden
• Agent: Bereit

Fehlerbehebung

Gateway Startet Nicht

1. Prüfen Sie, ob Port 18789 belegt ist: lsof -i :18789
2. Logs überprüfen: cat /tmp/clawdbot/gateway.log
3. Konfiguration zurücksetzen: clawdbot configure --reset

Kanalverbindungsprobleme

1. Erneut authentifizieren: clawdbot channels login
2. Anmeldedaten prüfen: ls ~/.clawdbot/credentials/
3. Allowlist überprüfen: clawdbot.json prüfen

Nächste Schritte

• Einrichtungsassistent - Geführte Einrichtung
• Kopplung - Zugriffskontrolle
• Persönlicher Assistent - Erstellen Sie Ihren Assistenten