Platforms overview
macOS-App
Die macOS-App ist der OpenClaw-Menüleistenbegleiter. Verwenden Sie sie, wenn Sie eine
native Tray-UI, macOS-Berechtigungsabfragen, Benachrichtigungen, WebChat, Spracheingabe,
Canvas oder Mac-gehostete Node-Tools wie system.run wünschen.
Wenn Sie nur die CLI und den Gateway benötigen, beginnen Sie mit Erste Schritte.
Download
Laden Sie macOS-App-Builds aus den OpenClaw-GitHub-Releases herunter. Wenn ein Release macOS-App-Assets 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 macOS-App-Asset enthält, verwenden Sie das neueste Release, das eines enthält, oder bauen Sie die App aus dem Quellcode mit der macOS-Entwicklungseinrichtung.
Erster Start
- Installieren und starten Sie OpenClaw.app.
- Wählen Sie Dieser Mac für einen lokalen Gateway aus, oder verbinden Sie sich mit einem Remote-Gateway.
- Warten Sie im lokalen Modus, während die App ihre User-Space-Runtime und den Gateway installiert.
- Schließen Sie die Provider-Einrichtung und die macOS-Berechtigungscheckliste ab.
- Senden Sie die Onboarding-Testnachricht.
Für den CLI/Gateway-Einrichtungspfad verwenden Sie Erste Schritte. Für die Wiederherstellung von Berechtigungen verwenden Sie macOS-Berechtigungen.
Gateway-Modus auswählen
| Modus | Verwenden Sie ihn, wenn | Detailseite |
|---|---|---|
| Lokal | Dieser Mac den Gateway ausführen und mit launchd am Leben halten soll. | Gateway auf macOS |
| Remote | Ein anderer Host den Gateway ausführt und dieser Mac ihn über SSH, LAN oder Tailnet steuern soll. | Remote-Steuerung |
Der lokale Modus erfordert eine installierte openclaw-CLI. Auf einem frischen Mac installiert die App
die passende CLI und Runtime automatisch, bevor sie den Gateway-Assistenten startet.
Siehe Gateway auf macOS zur manuellen Wiederherstellung.
Was die App verantwortet
- Menüleistenstatus, Benachrichtigungen, Integrität und WebChat.
- macOS-Berechtigungsabfragen für Bildschirm, Mikrofon, Spracherkennung, Automatisierung und Bedienungshilfen.
- Lokale Node-Tools wie Canvas, Kamera-/Bildschirmaufnahme, Benachrichtigungen und
system.run. - Exec-Genehmigungsabfragen für Mac-gehostete Befehle.
- SSH-Tunnel im Remote-Modus oder direkte Gateway-Verbindungen.
Die App ersetzt nicht den OpenClaw-Gateway oder die allgemeinen CLI-Dokumente. Die Kernkonfiguration des Gateway, Provider, Plugins, Kanäle, Tools und Sicherheit befinden sich in ihrer eigenen Dokumentation.
macOS-Detailseiten
| Aufgabe | Lesen |
|---|---|
| CLI/Gateway-Dienst installieren oder debuggen | Gateway auf macOS |
| Zustand aus cloud-synchronisierten Ordnern heraushalten | Gateway auf macOS |
| App-Erkennung und Konnektivität debuggen | Gateway auf macOS |
| launchd-Verhalten verstehen | Gateway-Lebenszyklus |
| Berechtigungen oder Signierungs-/TCC-Probleme beheben | macOS-Berechtigungen |
| Mit einem Remote-Gateway verbinden | Remote-Steuerung |
| Menüleistenstatus und Integritätsprüfungen lesen | Menüleiste, Integritätsprüfungen |
| Die eingebettete Chat-UI verwenden | WebChat |
| Voice Wake oder Push-to-Talk verwenden | Voice Wake |
| Canvas und Canvas-Deep-Links verwenden | Canvas |
| PeekabooBridge für UI-Automatisierung hosten | Peekaboo-Bridge |
| Befehlsfreigaben konfigurieren | Exec-Genehmigungen, erweiterte Details |
| Mac-Node-Befehle und App-IPC inspizieren | macOS-IPC |
| Logs erfassen | macOS-Logging |
| Aus dem Quellcode bauen | macOS-Entwicklungseinrichtung |
