macOS App Einführung

Übersicht

Diese Anleitung beschreibt die Erststart-Einführungserfahrung für die macOS-Anwendung von Clawdbot, vom ersten Start bis zum Agent-Bootstrap.

Einrichtungsablauf

Die Einführung folgt 8 Schritten:

Schritt 1: Willkommen

Initialer Willkommensbildschirm mit Sicherheitshinweis über die Fähigkeiten von Clawdbot.

Schritt 2: Gateway-Auswahl

Wählen Sie Ihren Gateway-Modus:

Schritt 3: Authentifizierung

Für lokale Setups authentifizieren Sie sich bei Ihrem KI-Anbieter:

• Anthropic OAuth - Für Claude Pro/Max Abonnenten
• Anthropic API Key - Direkter API-Zugriff
• OpenAI - GPT-Modelle
• Andere Anbieter - Verschiedene Optionen

Der OAuth-Flow öffnet Ihren Browser für PKCE-Authentifizierung. Fügen Sie den Code/Status-Wert ein, wenn Sie dazu aufgefordert werden.

Anmeldedaten gespeichert in: ~/.clawdbot/credentials/oauth.json

Schritt 4: Einrichtungsassistent

Gateway-gesteuerte Konfiguration für:

• Port- und Netzwerkeinstellungen
• Kanal-Integrationen
• Skill-Installation

Schritt 5: Berechtigungen

macOS erfordert explizite Berechtigungserteilungen:

Erteilen Sie Berechtigungen wie angefordert. Einige Funktionen erfordern spezifische Berechtigungen.

Schritt 6: CLI-Installation

Optionale Installation des globalen clawdbot-Befehls:

# Installiert in /usr/local/bin/clawdbot
clawdbot --version

Schritt 7: Einführungs-Chat

Eine dedizierte Sitzung zur Vorstellung des Agenten:

• Agent erstellt Arbeitsbereich (~/.clawdbot/workspace)
• Initialisiert Dateien: AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
• Führt Q&A durch, um Ihre Erfahrung zu personalisieren
• Lernt Ihre Präferenzen und Anwendungsfälle

Schritt 8: Bereit

Einrichtung abgeschlossen. Sie können jetzt:

• Mit Ihrem Assistenten chatten
• Zusätzliche Kanäle konfigurieren
• Skills installieren
• Ihren Arbeitsbereich anpassen

Gateway-Modi

Lokaler Modus

• Gateway läuft auf Ihrem Mac
• OAuth-Flows funktionieren direkt
• Anmeldedaten lokal gespeichert
• Ideal für persönliche Nutzung

Remote-Modus

Bei Verwendung eines entfernten Gateways:

• Alle Anmeldedaten befinden sich auf dem Gateway-Host
• Arbeitsbereichsdateien sind auf der entfernten Maschine
• Lokaler Mac agiert nur als Client
• Nützlich für gemeinsame oder Server-Deployments

Agent-Bootstrap

Beim ersten Start führt der Agent:

1. Erstellung des Arbeitsbereichsverzeichnisses
2. Initialisierung der Anweisungsdateien
3. Personalisierungs-Q&A
4. Konfiguration der anfänglichen Präferenzen

Bootstrap-Dateien

Fehlerbehebung

Berechtigungsprobleme

Wenn Funktionen nicht funktionieren:

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit
2. Prüfen Sie jede Berechtigungskategorie
3. Stellen Sie sicher, dass Clawdbot aktiviert ist
4. Starten Sie die App bei Bedarf neu

OAuth-Fehler

Wenn die Authentifizierung fehlschlägt:

1. Prüfen Sie Ihre Internetverbindung
2. Bestätigen Sie Ihren Abonnementstatus
3. Versuchen Sie, den API-Schlüssel manuell einzugeben
4. Prüfen Sie ~/.clawdbot/credentials/ auf Probleme

Gateway Startet Nicht

1. Prüfen Sie, ob Port 18789 verfügbar ist
2. Überprüfen Sie die Logs in /tmp/clawdbot/
3. Versuchen Sie clawdbot health vom Terminal

Nächste Schritte

• Einrichtungsanleitung - Detaillierte Konfiguration
• Assistent Erstellen - Erstellen Sie Ihren Assistenten
• Kanäle - Messaging-Plattformen verbinden