Einen persönlichen Assistenten erstellen

Übersicht

Clawdbot dient als Gateway, das Messaging-Plattformen mit KI-Agenten verbindet und es Ihnen ermöglicht, über Ihre bevorzugte Messaging-App mit einem KI-Assistenten zu interagieren.

Sicherheitshinweise

Clawdbot kann Befehle ausführen, auf Dateien zugreifen und Nachrichten senden. Wichtige Sicherheitsmaßnahmen:

• Setzen Sie channels.whatsapp.allowFrom um den Zugriff einzuschränken
• Verwenden Sie eine dedizierte Telefonnummer für den Assistenten
• Starten Sie mit deaktivierten Heartbeats ("0m") bis Vertrauen aufgebaut ist
• Überprüfen Sie Berechtigungen bevor Sie Shell-Zugriff gewähren

Voraussetzungen

• Node.js 22+
• Global installiertes Clawdbot
• Eine zweite Telefonnummer für den Assistenten (empfohlen)

Empfohlene Architektur

Verwenden Sie zwei Telefone für die sicherste Konfiguration:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Ihr Telefon    │────▶│  Assistent      │────▶│  Ihr Computer   │
│  (Persönlich)   │     │  Telefonnummer  │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Ihr persönliches Gerät sendet Nachrichten an ein zweites Telefon (den Assistenten), das mit Clawdbot auf Ihrem Computer verbunden ist.

Schnellstart

1. WhatsApp Web verknüpfen

clawdbot channels login whatsapp

Scannen Sie den QR-Code mit Ihrem Assistenten-Telefon.

2. Gateway starten

clawdbot gateway --port 18789

3. Erlaubnisliste konfigurieren

Bearbeiten Sie ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

Arbeitsbereich und Speicher

Standard-Arbeitsbereich

Speicherort: ~/.clawdbot/workspace

Enthält Anweisungsdateien:

Versionskontrolle

Behandeln Sie Ihren Arbeitsbereich als Git-Repository zur Sicherung:

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

Sitzungen

Sitzungen werden pro Absender gespeichert. Befehle zur Sitzungsverwaltung:

Heartbeats (Proaktive Aufgaben)

Heartbeats sind periodische Prüfungen, bei denen der Agent HEARTBEAT.md für Aufgaben liest.

Konfiguration

In ~/.clawdbot/clawdbot.json:

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

Verhalten

• Standard: Alle 30 Minuten
• Agent liest HEARTBEAT.md für ausstehende Aufgaben
• Antwortet mit HEARTBEAT_OK wenn nichts Aufmerksamkeit erfordert
• Setzen Sie auf "0m" zum Deaktivieren

Beispiel HEARTBEAT.md

# Heartbeat-Aufgaben

- Neue E-Mails prüfen und wichtige zusammenfassen
- Kalender auf bevorstehende Meetings überprüfen
- Aktienkurse für AAPL, GOOGL überwachen

Medienverarbeitung

Eingehende Anhänge

Clawdbot kann empfangen und verarbeiten:

• Bilder
• Dokumente
• Sprachnachrichten
• Videos

Ausgehende Medien

Senden Sie Medien mit der MEDIA:<Pfad> Syntax:

MEDIA:/path/to/image.png

Betrieb

Statusbefehle

# Gesundheit prüfen
clawdbot health

# Status anzeigen
clawdbot status

# Logs prüfen
tail -f /tmp/clawdbot/gateway.log

Protokollierung

Logs werden in /tmp/clawdbot/ gespeichert:

Multi-Kanal-Einrichtung

Konfigurieren Sie mehrere Kanäle in clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Nächste Schritte

• Kopplung - Zugriffskontrolle konfigurieren
• Schaufenster - Sehen Sie, was andere gebaut haben
• Fähigkeiten - Mit Plugins erweitern