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