OpenClaw auf macOS einrichten

Jeder kennt das Gefühl: Ein neues Tool verspricht maximale Produktivität, aber die erste Einrichtung fühlt sich nach Schwerstarbeit an. Man klickt sich durch unzählige Fenster, bestätigt Warnungen und hofft, dass am Ende alles reibungslos funktioniert.

Diese Anleitung hilft dir dabei, die “Day 0”-Erfahrung so kurz wie möglich zu halten. Wir gehen direkt zum Punkt, damit dein Agent einsatzbereit ist.

Voraussetzungen

• Ein macOS Gerät
• npm oder pnpm (falls du das CLI installieren möchtest)
• Bestehende Credentials auf dem Host (falls du einen Remote-Gateway nutzt)

Schnellstart

Folge diesen Schritten, um OpenClaw in weniger als fünf Minuten zu konfigurieren.

1. macOS Warnungen bestätigen

Bestätige beim ersten Start die Systemwarnung von macOS, um die App auszuführen.

2. Lokale Netzwerke erlauben

Erlaube der App den Zugriff auf lokale Netzwerke, damit die Kommunikation mit dem Gateway funktioniert.

3. Sicherheit und Trust Model

Lies den Sicherheitshinweis sorgfältig durch. OpenClaw ist standardmäßig als persönlicher Agent konzipiert.

• Neue lokale Setups nutzen automatisch tools.profile: "coding". So hast du Zugriff auf Filesystem- und Runtime-Tools, ohne das uneingeschränkte full Profil zu nutzen.
• Bei Multi-User-Setups solltest du strikte Tool-Policies und Sandboxing nutzen.

4. Gateway wählen: Lokal vs. Remote

Entscheide, wo dein Gateway laufen soll:

• This Mac (Local only): Das Onboarding schreibt die Credentials direkt lokal.
• Remote (SSH/Tailnet): Credentials werden nicht lokal konfiguriert; sie müssen bereits auf dem Gateway-Host existieren.
• Configure later: Überspringe diesen Teil und konfiguriere die App später.

Tipp zum Gateway-Auth: Der Wizard generiert auch für Loopback-Verbindungen einen Token. Lokale WS-Clients müssen sich also authentifizieren. Deaktiviere die Auth nur auf Geräten, denen du voll vertraust.

5. Berechtigungen (TCC)

OpenClaw benötigt Zugriff auf verschiedene Systemfunktionen. Du kannst wählen, welche Berechtigungen du erteilst:

• Automation (AppleScript) und Notifications
• Accessibility und Screen Recording
• Microphone und Speech Recognition
• Camera und Location

6. CLI Installation

Dieser Schritt ist optional. Die App kann das globale openclaw CLI via npm oder pnpm installieren. Das ist nützlich für Terminal-Workflows oder launchd-Tasks.

7. Onboarding Chat

Nach dem Setup öffnet die App eine spezielle Chat-Session. Hier stellt sich der Agent vor und führt dich durch die nächsten Schritte. Dieser Bereich bleibt getrennt von deinen normalen Konversationen.

Fehlerbehebung

• Verbindungsprobleme zum Gateway: Falls du keine Verbindung herstellen kannst, prüfe, ob die Auth-Tokens korrekt gesetzt sind. Lokale WS-Clients benötigen zwingend den generierten Token, sofern Auth nicht explizit deaktiviert wurde.
• Fehlende Berechtigungen: Falls Tools nicht wie erwartet funktionieren, kontrolliere die TCC-Einstellungen für Accessibility oder Screen Recording in den macOS Systemeinstellungen.
• Remote Auth: Wenn du einen Remote-Gateway nutzt, denke daran, dass das macOS Onboarding keine Credentials dorthin überträgt. Diese müssen manuell auf dem Host hinterlegt sein.

Du hast Fragen zum Setup oder brauchst Hilfe bei der Konfiguration? Nutze unseren AI Setup Assistant.

Nächste Schritte

• Onboarding Overview
• Security Guide
• Bootstrapping Prozesse