OpenClaw AppleScript: macOS-Apps per Agent steuern (2026)
SKILL.md) mit einem kleinen Bridge-Skript koppeln, das osascript (AppleScript) aufruft oder Automator-Workflows startet. Der Agent kann dann Keynote öffnen, PDF exportieren, Systemlautstärke anpassen oder das Display abdunkeln — während Chat-Trigger im Gateway bleiben. Erwarten Sie TCC-Abfragen (Bedienungshilfen / Automatisierung) und behandeln Sie volle GUI-Steuerung als hohes Privileg.
Warum text-only OpenClaw macOS-Power liegen lässt
OpenClaw glänzt bei Repos, CI-Hooks und Multi-Agent-Fan-out. Auf Mac mini oder MacBook läuft derselbe Daemon oft headless über SSH: Er bearbeitet Dateien und führt npm test aus, berührt aber nie Mail, Keynote, Music oder Systemeinstellungen.
Diese Lücke zählt, wenn Ihr Workflow operator-geprägt ist, nicht entwickler-geprägt:
- Ein Stakeholder schreibt „Deck v3 PDF exportieren“ in einen Team-Kanal
- Sie wollen die Helligkeit vor einer Bildschirmfreigabe-Aufnahme senken
- Ein Nachtjob soll Folien archivieren, ohne die UI anzufassen
macOS liefert bereits den Kleber: AppleScript spricht mit scriptbaren Apps; Automator packt wiederholbare UI-Makros als .workflow-Dateien, die Sie aus der Shell starten können. OpenClaws Skill-System ist das dritte Bein: dokumentierte Tools, die das Modell aufrufen darf. Verdrahten Sie sie, und der Agent ist kein Chatbot in einer Sandbox mehr — er wird ein lokaler Concierge mit Händen auf dem Desktop.
Dieser Leitfaden setzt OpenClaw als installiert voraus (Setup-Referenz). Wir fokussieren Desktop-Automatisierung, nicht Orchestrierungstheorie.
Architektur: Gateway → Skill → Bridge → AppleScript / Automator
Datenfluss in einem Satz: Kanalnachricht → OpenClaw-Gateway → Skill-Handler → /usr/local/bin/openclaw-mac-bridge → osascript oder automator → native App oder System Events.
| Schicht | Verantwortung | Typischer Pfad |
|---|---|---|
| Gateway | Leitet Chat/Webhook an einen Agenten | openclaw-Daemon |
Skill (SKILL.md) | Dokumentiert Args, Sicherheitsregeln, Beispiele | ~/.openclaw/skills/mac-desktop/SKILL.md |
| Bridge (bash) | Validiert Eingabe, protokolliert, ruft macOS auf | ~/bin/openclaw-mac-bridge |
| AppleScript | App-Verben (Keynote, Finder) | inline oder ~/Scripts/*.applescript |
| Automator | Aufgezeichnete UI, wenn AppleScript brüchig ist | ~/Library/Services/Export-Keynote-PDF.workflow |
Apple dokumentiert scriptbare Apps im AppleScript Language Guide. Für GUI-Scripting über System Events brauchen Sie Bedienungshilfen-Berechtigung für Terminal (oder osascript) unter Systemeinstellungen → Datenschutz & Sicherheit.
Sicherheitshaltung: Bridge-Skripte nur auf einem dedizierten Automatisierungs-Mac (oder VM/Session, die Sie löschen können) ausführen. Volle Desktop-Steuerung plus Agent-Shell-Zugriff = root-äquivalente UX — gleiche Risikoklasse wie Sandbox für Worker deaktivieren.
Entscheidungsmatrix: AppleScript vs Automator vs nur Shell
| Bedarf | AppleScript | Automator-Workflow | Shell (nur openclaw-Tools) |
|---|---|---|---|
| Keynote PDF-Export | Nativer export-Befehl | Menüklicks aufzeichnen, wenn API fehlt | Nein |
| Lautstärke / Helligkeit | System Events | Overkill | osascript-One-Liner |
| Nicht scriptbare Electron-App | Fragil | Oft einfacher (UI-Aufzeichnung) | Nein |
| CI auf remote Linux | N/A | N/A | Ja |
| Auditierbar, versioniert | .applescript in git | .workflow-Bundle in git | Nur SKILL.md |
| Headless-SSH-Mac | Funktioniert bei angemeldeter GUI-Session | Braucht grafische Session | Funktioniert |
Regel: AppleScript bevorzugen, wenn das App-Wörterbuch das Verb exponiert; Automator für nur-Menüleiste-Aktionen; Shell für Datei/Git-Aufgaben behalten.
Schritt-für-Schritt-Runbook: Bridge + SKILL.md + drei Aktionen
Schritt 1 — Bridge-Skript erstellen
Speichern unter ~/bin/openclaw-mac-bridge und chmod +x:
#!/usr/bin/env bash
set -euo pipefail
ACTION="${1:-}"; shift || true
LOG="${HOME}/.openclaw/logs/mac-bridge.log"
mkdir -p "$(dirname "$LOG")"
log() { printf '%s %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$*" >>"$LOG"; }
case "$ACTION" in
keynote-export-pdf)
DECK="${1:?path to .key required}"
OUT="${2:?output .pdf path required}"
osascript <<EOF
tell application "Keynote"
activate
open POSIX file "$DECK"
delay 2
export front document to POSIX file "$OUT" as PDF
close front document saving no
end tell
EOF
log "keynote-export-pdf OK $OUT"
;;
set-volume)
PCT="${1:?0-100}"
osascript -e "set volume output volume $PCT"
log "set-volume $PCT"
;;
set-brightness)
PCT="${1:?0-100}"
osascript <<EOF
tell application "System Events"
tell appearance preferences
set brightness to ($PCT / 100)
end tell
end tell
EOF
log "set-brightness $PCT"
;;
run-automator)
WF="${1:?workflow path required}"
automator "$WF"
log "run-automator $WF"
;;
*)
echo "Usage: openclaw-mac-bridge {keynote-export-pdf|set-volume|set-brightness|run-automator} ..." >&2
exit 2
;;
esac
Auf Apple Silicon macOS 14+ kann Helligkeit über appearance preferences eine angemeldete GUI-Session erfordern; lokal testen, bevor Sie an Chat anschließen.
Schritt 2 — SKILL.md für mac-desktop-Skill verfassen
Pfad: ~/.openclaw/skills/mac-desktop/SKILL.md (an Ihre OpenClaw-Skill-Root anpassen):
# mac-desktop
Control this Mac's GUI via openclaw-mac-bridge. Only run actions the user explicitly requested.
## Commands
- keynote-export-pdf <path.key> <out.pdf>
- set-volume <0-100>
- set-brightness <0-100>
- run-automator <path.workflow>
## Safety
- Never export to paths outside ~/Documents/OpenClaw-Exports/
- Refuse destructive Finder/ Mail actions unless user names the target file
Skill in Agent-Config registrieren (variiert je Release — spiegeln Sie bestehende skills: ["git", "nodejs"]-Einträge in openclaw.json).
Schritt 3 — Bridge in Agent-Tool-Policy erlauben
Wenn Ihr Orchestrator sandboxed Workers nutzt, Desktop-Skill nur auf dem Orchestrator-Agent mit sandbox.mode: off für diese Agent-ID. Workers, die nur Code bearbeiten, sollten mac-desktop nicht erhalten.
Schritt 4 — Automator-Workflow bauen (optional)
- Automator → Schnellaktion öffnen
- Aufzeichnen: Keynote → Ablage → Exportieren nach → PDF (speichern unter
~/Documents/OpenClaw-Exports/) - Speichern als
Export-Keynote-PDF.workflowunter~/Library/Services/ - Test:
automator ~/Library/Services/Export-Keynote-PDF.workflow
Verdrahten über openclaw-mac-bridge run-automator …, wenn AppleScript-Export auf Ihrer Keynote-Version scheitert.
Schritt 5 — macOS-Datenschutzberechtigungen erteilen
- Systemeinstellungen → Datenschutz & Sicherheit → Automatisierung — Terminal/iTerm (oder
node) Keynote-Steuerung erlauben - Bedienungshilfen — denselben Host für
System Events-Helligkeitsskripte erlauben - Bridge manuell einmal erneut ausführen; Abfragen bestätigen
Schritt 6 — Chat-Trigger anbinden (konzeptionell)
In Kanalregeln (Discord/Telegram/Webhook) Phrase auf Orchestrator-Task mappen:
When message matches ^/deck pdf (.+)$, call mac-desktop keynote-export-pdf with captured path.
Exakte Hook-Syntax hängt von OpenClaw-Kanal-Plugins ab — behandeln Sie dies als Orchestrator-Systemprompt + erlaubte Tools, nicht magisches Routing.
Schritt 7 — Mit openclaw doctor und Dry Run verifizieren
openclaw doctor
~/bin/openclaw-mac-bridge set-volume 25
~/bin/openclaw-mac-bridge keynote-export-pdf "$HOME/Desktop/demo.key" "$HOME/Documents/OpenClaw-Exports/demo.pdf"
PDF-Bytes und Log-Zeilen in ~/.openclaw/logs/mac-bridge.log bestätigen.
Schritt 8 — Produktions-Leitplanken
- Dediziertes Benutzerkonto
automationmit Login-Schlüsselbund nur für Keynote - Rate Limit: max. 6 GUI-Aktionen/Stunde pro Kanal
- Allowlist: Deck-Pfade unter
~/Documents/Decks/ - Mit MCP-Tools für DB/API koppeln; GUI nur auf mac-desktop-Skill
Fehlerbehebung
Fehler: execution error: Not authorized to send Apple events to Keynote
Muster: (-1743) oder „Not authorized“ in osascript-stderr.
Fix: Systemeinstellungen → Datenschutz & Sicherheit → Automatisierung → Terminal-App → Keynote aktivieren. Bridge erneut ausführen; bei headless SSH einmal aus Bildschirmfreigabe-Session, damit Abfragen erscheinen.
Fehler: System Events got an error: Can’t set brightness
Muster: Skript gelingt für Lautstärke, scheitert bei Helligkeit.
Fix: Terminal Bedienungshilfen gewähren; angemeldete GUI-Session sicherstellen (nicht launchd ohne Konsole). Fallback: Automator-Aktion „Helligkeit ändern“ statt AppleScript.
Szenario A — Gruppenchat „PDF rausschicken“
Ihr Team-Bot hört: „Keynote für Investoren-Call exportieren“. Der Orchestrator parst den Deck-Namen, ruft keynote-export-pdf auf, lädt das PDF über ein separates Datei-Tool hoch und antwortet mit SHA256 + Pfad. Latenz: ~8–15 s für 40-Folien-Deck auf M4 (Disk + Keynote-Cold-Start). RAM: Keynote addiert ~400–900 MB Peak — ok neben einem OpenClaw-Daemon auf 16 GB; parallelen Fan-out auf demselben GUI-Host vermeiden.
Szenario B — Umgebungs-Reset vor Aufnahme
Vor OBS-Capture führt der Agent set-volume 35 und set-brightness 60 aus, dann startet Automator zum Ausblenden der Menüleisten-Extras. Implikation: Das sind globale Änderungen — Rollback (set-volume 70) in derselben Skill-Session dokumentieren.
Empfohlener Pfad
| Wenn Sie… | Tun Sie dies |
|---|---|
| Nur Dateien/Git/CI brauchen | GUI-Skills überspringen; bei Shell-Tools bleiben |
| Keynote/Pages/Finder brauchen | AppleScript-Bridge + SKILL.md auf Orchestrator-Agent |
| App hat kein Wörterbuch | Automator-Workflow + run-automator |
| Agent auf remote Mac betreiben | Persistente GUI-Anmeldung sicherstellen; siehe Remote-OpenClaw-Setup |
| 3+ parallele Agenten brauchen | Nicht eine GUI-Session teilen — mac-desktop-Aufrufe serialisieren |
FAQ
Kann OpenClaw AppleScript in einer headless-SSH-Session ausführen?
Nur wenn macOS eine aktive WindowServer-Session für den Zielbenutzer hat (Bildschirmfreigabe-Login oder lokale Konsole). Reines SSH ohne GUI-Login scheitert für Keynote und System Events UI-Scripting.
Wie unterscheidet sich das von OpenClaw Multi-Agent-Orchestrierung?
Multi-Agent-Orchestrierung teilt Reasoning-Worker. Desktop-Automatisierung ist ein Single-Host-Privileg-Tool — auf einem Orchestrator laufen lassen, nicht an drei Coder gleichzeitig Keynote bedienen fan-outen.
Ist AppleScript produktionssicher?
Es ist mächtig, nicht sicher-by-default. Behandeln Sie mac-desktop wie Produktions-Shell: Allowlists, Logging, dedizierter Mac, keine private E-Mail in derselben Benutzersession.
Funktioniert das mit Claude Code oder Copilot CLI?
Diese CLIs liefern keinen OpenClaw-Skill-Router. Sie können dasselbe Bridge-Skript aus einem Shell-Tool wiederverwenden, verlieren aber zentrales Kanal-Routing — siehe Benchmark-Vergleich für die Stack-Wahl.
Was ist mit Netzwerkbeschränkungen und dem Remote-Mac-Muster?
Um npm/API-Routen zu stabilisieren, betreiben viele Teams die Gateway auf einem dauerhaft laufenden Remote-Mac — gleiches Muster wie Remote-OpenClaw-Setup. AppleScript läuft weiterhin auf dem Desktop dieses Macs, nicht auf Ihrem lokalen Laptop.
Verwandte Guides
Vor Desktop-Skills in Produktions-Chat: Multi-Agent-Orchestrierung und Remote-Mac-Setup lesen.