macOS-App

Die macOS-App ist der Menüleisten-Begleiter von OpenClaw: native Menüleistenoberfläche, macOS-Berechtigungsabfragen, Benachrichtigungen, WebChat, Spracheingabe, Canvas und auf dem Mac gehostete Node-Tools wie system.run.

Benötigen Sie nur die CLI und das Gateway? Beginnen Sie mit Erste Schritte.

Download

Laden Sie Builds der macOS-App von den OpenClaw-Releases auf GitHub herunter. Wenn ein Release Assets für die macOS-App enthält, suchen Sie nach:

• OpenClaw-<version>.dmg (bevorzugt)
• OpenClaw-<version>.zip

Einige Releases enthalten nur CLI-, Nachweis- oder Windows-Assets. Wenn das neueste Release kein Asset für die macOS-App enthält, verwenden Sie das neueste Release mit einem solchen Asset oder erstellen Sie die App anhand der macOS-Entwicklungsumgebung aus dem Quellcode.

Erster Start

1. Installieren und starten Sie OpenClaw.app.
2. Wählen Sie Dieser Mac für ein lokales Gateway aus oder stellen Sie eine Verbindung zu einem entfernten Gateway her.
3. Warten Sie, während die App die passende CLI-Laufzeit installiert. Im lokalen Modus installiert und startet sie außerdem das Gateway.
4. Stellen Sie die Inferenz mit einer Live-Modellprüfung her. Nach erfolgreicher Prüfung übernimmt Crestodian die verbleibende Einrichtung.
5. Schließen Sie die Checkliste für macOS-Berechtigungen ab und senden Sie die Testnachricht für das Onboarding.

Wenn die App ein vorhandenes Gateway erreicht, dessen Standard-Agent über ein konfiguriertes Modell verfügt, betrachtet sie dieses Gateway als bereits eingerichtet, überspringt das Provider-Onboarding und Crestodian und öffnet das Dashboard. Wenn keine Verbindung zum Gateway hergestellt werden kann oder dessen Standard-Agent kein Modell besitzt, bleibt das Inferenz-Onboarding zur Wiederherstellung verfügbar.

Verwenden Sie für die Einrichtung von CLI und Gateway Erste Schritte. Informationen zur Wiederherstellung von Berechtigungen finden Sie unter macOS-Berechtigungen.

Updates

Die Update-Karte im Dashboard aktualisiert zuerst die signierte macOS-App über Sparkle. Nach dem Neustart der App aktualisiert und startet sie automatisch das passende, von der App verwaltete lokale Gateway neu. Bei Homebrew und anderen benutzerverwalteten CLI-Installationen bleibt der normale Update-Ablauf des Gateways erhalten (die Karte führt das Gateway-Update direkt aus), und die automatische Reparatur führt niemals ein Downgrade eines neueren Gateways durch oder überschreibt eine Festlegung auf den Kanal extended-stable.

Sparkle folgt der Einstellung update.channel des Gateways. beta und dev aktivieren Beta-Builds der App; bei stable, extended-stable sowie fehlenden oder unbekannten Werten werden stabile App-Builds verwendet.

Dashboard-Links öffnen

Wenn Sie im eingebetteten Dashboard der macOS-App auf einen externen Weblink klicken, wird er in einer größenveränderbaren Browser-Seitenleiste geöffnet. Jeder Link wird in einem eigenen Tab geöffnet; wenn Sie denselben Link erneut anklicken, wird der vorhandene Tab wiederverwendet. Ziehen Sie Tabs, um ihre Reihenfolge zu ändern, schließen Sie sie über die Schließen-Schaltfläche des Tabs oder per Mittelklick und klicken Sie mit der rechten Maustaste auf einen Tab, um Open in Default Browser, Copy Link, Reload, Close Tab oder Close Other Tabs auszuwählen. Mit den Zurück-/Vorwärts-Steuerelementen in der Titelleiste des Fensters und Wischgesten auf dem Trackpad navigieren Sie durch den Verlauf des Dashboards; mit den eigenen Zurück-/Vorwärts-Steuerelementen der Seitenleiste navigieren Sie durch den Verlauf des aktiven Tabs. Die Seitenleiste verfügt außerdem über Steuerelemente zum Neuladen, Öffnen im Standardbrowser und Schließen und merkt sich ihre Breite.

Die Steuerelemente der Titelleiste richten sich nach der App-Seitenleiste: Wenn sie ausgeklappt ist, befinden sich Zurück/Vorwärts an ihrem rechten Rand neben dem Umschalter für die Seitenleiste; wenn sie eingeklappt ist, machen sie Platz für eine Suchschaltfläche (öffnet die Befehlspalette) und eine Schaltfläche für eine neue Sitzung.

Klicken Sie mit der rechten Maustaste auf einen externen Link, um Open in Sidebar, Open in Default Browser oder Copy Link auszuwählen. Modifizierte Klicks und vom Benutzer aktivierte Links zu neuen Fenstern aus dem Dashboard werden weiterhin im Standardbrowser geöffnet; Links zu neuen Fenstern innerhalb der Seitenleiste werden als neue Seitenleisten-Tabs geöffnet. Reguläre, im Browser gehostete Seiten der Control UI behalten das normale Link- und Kontextmenüverhalten des Browsers bei.

Browser-Anmeldungen importieren

Wenn die App mit einem lokalen Gateway ausgeführt wird und auf dem Mac ein Profil eines Chrome-basierten Browsers mit Cookies vorhanden ist, zeigt das Dashboard-Fenster ein ausblendbares Banner an, das anbietet, diese Cookies in ein isoliertes, verwaltetes Profil zu kopieren, das Agenten zum Browsen verwenden. Wählen Sie über das Steuerelement Import im Banner ein Profil aus (möglicherweise ist Touch ID erforderlich); der Fortschritt und die Anzahl der importierten Cookies werden direkt im Banner angezeigt, und es werden ausschließlich Cookies kopiert – Passwörter verlassen niemals den Quellbrowser. Wenn Sie das Banner ausblenden, wird diese Auswahl gespeichert; über Settings → General → Browser login → Import… können Sie das Angebot jederzeit erneut aufrufen. Weitere Informationen zum zugrunde liegenden Importablauf und zur Sperre browser.allowSystemProfileImport finden Sie unter Browser.

Gateway-Modus auswählen

Für beide Modi muss eine openclaw-CLI installiert sein, da die App deren Node-Host-Laufzeit wiederverwendet. Auf einem neuen Mac installiert die App automatisch die passende CLI; im lokalen Modus startet sie anschließend den Gateway-Assistenten, während sie im entfernten Modus eine Verbindung zum ausgewählten Gateway herstellt, ohne ein zweites lokales Gateway zu starten. Informationen zur manuellen Wiederherstellung finden Sie unter Gateway unter macOS.

Wofür die App zuständig ist

• Menüleistenstatus, Benachrichtigungen, Funktionszustand und WebChat.
• macOS-Berechtigungsabfragen für Bildschirm, Mikrofon, Spracherkennung, Automatisierung und Bedienungshilfen.
• Eine Mac-Node, die natives Canvas, Kamera-/Bildschirmaufnahme, Benachrichtigungen, Standort und Computersteuerung mit den System-, Browser-, Plugin-, Skill- und MCP-Befehlen des CLI-Node-Hosts kombiniert.
• Abfragen zur Ausführungsgenehmigung für auf dem Mac gehostete Befehle.
• Ausführung genehmigter Shell-Befehle im App-Kontext, wobei die Zuordnung der macOS-Berechtigungen zur App erhalten bleibt, während die CLI-Laufzeit für die gemeinsame Node-Richtlinie zuständig ist.
• SSH-Tunnel im entfernten Modus oder direkte Gateway-Verbindungen.

Die App ersetzt nicht die allgemeine Dokumentation zum Gateway oder zur CLI. Gateway-Konfiguration, Provider, Plugins, Kanäle, Tools und Sicherheit werden in ihren jeweiligen Dokumentationen behandelt.

macOS-Detailseiten

Verwandte Themen

• Plattformen
• Erste Schritte
• Gateway
• Ausführungsgenehmigungen