macOS-App

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

Verwenden Sie Schnellchat für ein Spotlight-ähnliches Eingabefeld der Hauptsitzung, ohne ein vollständiges Fenster zu öffnen. Drücken Sie standardmäßig Wahltaste-Leertaste (⌥Leertaste), wählen Sie die Funktion im Menüleistenmenü aus oder legen Sie unter Einstellungen → Allgemein ein anderes Tastenkürzel fest.

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

Download

Laden Sie Builds der macOS-App von den OpenClaw-Veröffentlichungen auf GitHub herunter. Wenn eine Veröffentlichung Assets für die macOS-App enthält, suchen Sie nach:

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

Einige Veröffentlichungen enthalten nur CLI-, Nachweis- oder Windows-Assets. Wenn die neueste Veröffentlichung kein Asset für die macOS-App enthält, verwenden Sie die neueste Veröffentlichung 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 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 OpenClaw 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, behandelt sie dieses Gateway als bereits eingerichtet, überspringt das Provider-Onboarding und OpenClaw und öffnet das Dashboard. Wenn keine Verbindung zum Gateway hergestellt werden kann oder sein 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.

Aktualisierungen

Die Aktualisierungskarte im Dashboard gibt an, was die App aktualisiert:

• Mac-App + Gateway aktualisieren bedeutet, dass die signierte App das lokale, von launchd verwaltete Gateway besitzt. Sparkle aktualisiert zuerst die App; nach dem Neustart aktualisiert und startet die App ihr Gateway automatisch mit der passenden Version neu und überprüft anschließend die Verbindung.
• Gateway aktualisieren bedeutet, dass die App mit einem entfernten Gateway, einem manuell verwalteten lokalen Gateway oder einer anderen Installation verbunden ist, die nicht der App gehört. Die Schaltfläche führt den normalen Aktualisierungsablauf dieses Gateways aus, anstatt die Mac-App zu ändern.

Eine fehlgeschlagene koordinierte Aktualisierung verbleibt in ihrem einrichtungsähnlichen Fenster und bietet Aktionen zum erneuten Versuch, zum Aktualisierungsleitfaden und zu Discord. Die automatische Reparatur führt niemals ein Downgrade eines neueren Gateways durch und überschreibt keine Kanalanheftung für extended-stable.

Nach einer erfolgreichen Aktualisierung ermittelt die App die zuletzt von einem Menschen verwendete direkte Sitzung der obersten Ebene und übermittelt diesem Agent einmalig ein Aktualisierungsereignis. Heartbeat- und Cron-Aktivitäten beeinflussen diese Auswahl nicht. Der Agent kann Sie dann in der Unterhaltung begrüßen, die Sie höchstwahrscheinlich verwendet haben. Im Remote-Modus aktualisiert die App nur die lokale Mac-Node-Laufzeit und überspringt die Benachrichtigung, wenn das entfernte Gateway älter als die App ist.

Sparkle folgt der Einstellung update.channel des Gateways. beta und dev aktivieren Beta-Builds der App; stable, extended-stable sowie fehlende oder unbekannte Werte verwenden weiterhin stabile App-Builds.

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 mit der halben Fensterbreite geöffnet, während die Dashboard-Navigation sichtbar bleibt. Ziehen Sie die Trennlinie, um eine andere Breite festzulegen; die App merkt sie sich. Jeder Link wird in einem eigenen Tab geöffnet, die Tableiste erscheint, sobald mehrere Seiten geöffnet sind, und ein erneuter Klick auf denselben Link verwendet dessen vorhandenen Tab. Ziehen Sie Tabs, um ihre Reihenfolge zu ändern, schließen Sie sie mit der Schließen-Schaltfläche des Tabs oder per Mittelklick und klicken Sie mit der rechten Maustaste auf einen Tab, um Im Standardbrowser öffnen, Link kopieren, Neu laden, Tab schließen oder Andere Tabs schließen auszuwählen. Die Zurück-/Vorwärts-Steuerelemente in der Titelleiste des Fensters und Wischgesten auf dem Trackpad navigieren durch den Dashboard-Verlauf; die eigenen Zurück-/Vorwärts-Steuerelemente der Seitenleiste navigieren durch den Verlauf des aktiven Tabs. Die Seitenleiste verfügt außerdem über Steuerelemente zum Neuladen, zum Öffnen im Standardbrowser und zum Schließen.

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

Klicken Sie mit der rechten Maustaste auf einen externen Link, um In Seitenleiste öffnen, Im Standardbrowser öffnen oder Link kopieren auszuwählen. Modifizierte Klicks und vom Benutzer ausgelöste Links für neue Fenster aus dem Dashboard werden weiterhin im Standardbrowser geöffnet; Links für neue Fenster 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 Browser-Seitenleiste erstmals geöffnet wird, während die App mit einem lokalen Gateway arbeitet, zeigt das Dashboard ein ausblendbares Banner an, sofern auf dem Mac ein Profil aus der Chrome-Familie mit Cookies vorhanden ist. Das Banner bietet an, diese Cookies in ein isoliertes, verwaltetes Profil zu kopieren, das Agenten zum Browsen verwenden. Wählen Sie über das Steuerelement Importieren ein Profil aus (Touch ID kann erforderlich sein); Fortschritt und Anzahl der importierten Cookies werden direkt angezeigt, und es werden ausschließlich Cookies kopiert — Passwörter verlassen niemals den Quellbrowser. Das Ausblenden des Banners speichert diese Entscheidung; unter Einstellungen → Allgemein → Browser-Anmeldung → Importieren … wird die Option jederzeit erneut angeboten. Informationen zum zugrunde liegenden Importablauf und zur browser.allowSystemProfileImport-Sperre finden Sie unter Browser.

Gateway-Modus auswählen

Beide Modi benötigen eine installierte openclaw-CLI, da die App deren Node-Host- Laufzeit wiederverwendet. Auf einem neuen Mac installiert die App automatisch die passende CLI; der lokale Modus startet anschließend den Gateway-Assistenten, während der Remote-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.

Zuständigkeiten der App

• Menüleistenstatus, Benachrichtigungen, Systemzustand, WebChat und die schwebende Schnellchat-Leiste.
• 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-, Skills- und MCP-Befehlen des CLI-Node-Hosts kombiniert.
• Ausführungsfreigabe-Abfragen für auf dem Mac gehostete Befehle.
• Ausführung im App-Kontext für genehmigte Shell-Befehle, wobei die macOS- Berechtigungszuordnung der App erhalten bleibt, während die CLI-Laufzeit die gemeinsame Node-Richtlinie verwaltet.
• SSH-Tunnel im Remote-Modus oder direkte Gateway-Verbindungen.

In der eingebetteten Control UI zeigt Einstellungen → Benachrichtigungen die native Benachrichtigungsberechtigung der App anstelle von Browser-Push an, da die App Benachrichtigungen nativ zustellt.

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

macOS-Detailseiten

Verwandte Themen

• Plattformen
• Erste Schritte
• Gateway
• Ausführungsfreigaben