KI-Automatisierung

OpenClaw AppleScript: macOS-Apps per Agent steuern (2026)

OpenClaw AppleScript Automator macOS Desktop-Automatisierung 2026
Offenlegung: KuzCloud veröffentlicht Mac-Hosting-Leitfäden; dieser Artikel ist technische Dokumentation. OpenClaw ist Drittanbieter-OSS — siehe openclaw.dev.
Kurzfassung: Die meisten OpenClaw-Deployments enden bei Text und Shell in einem Terminal. Unter macOS können Sie dem Agenten einen physischen Desktop-Körper geben, indem Sie OpenClaw-Skills (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.

SchichtVerantwortungTypischer Pfad
GatewayLeitet Chat/Webhook an einen Agentenopenclaw-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
AppleScriptApp-Verben (Keynote, Finder)inline oder ~/Scripts/*.applescript
AutomatorAufgezeichnete 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

BedarfAppleScriptAutomator-WorkflowShell (nur openclaw-Tools)
Keynote PDF-ExportNativer export-BefehlMenüklicks aufzeichnen, wenn API fehltNein
Lautstärke / HelligkeitSystem EventsOverkillosascript-One-Liner
Nicht scriptbare Electron-AppFragilOft einfacher (UI-Aufzeichnung)Nein
CI auf remote LinuxN/AN/AJa
Auditierbar, versioniert.applescript in git.workflow-Bundle in gitNur SKILL.md
Headless-SSH-MacFunktioniert bei angemeldeter GUI-SessionBraucht grafische SessionFunktioniert

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)

  1. Automator → Schnellaktion öffnen
  2. Aufzeichnen: Keynote → Ablage → Exportieren nach → PDF (speichern unter ~/Documents/OpenClaw-Exports/)
  3. Speichern als Export-Keynote-PDF.workflow unter ~/Library/Services/
  4. 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

  1. Systemeinstellungen → Datenschutz & Sicherheit → Automatisierung — Terminal/iTerm (oder node) Keynote-Steuerung erlauben
  2. Bedienungshilfen — denselben Host für System Events-Helligkeitsskripte erlauben
  3. 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 automation mit 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.

Wenn Sie…Tun Sie dies
Nur Dateien/Git/CI brauchenGUI-Skills überspringen; bei Shell-Tools bleiben
Keynote/Pages/Finder brauchenAppleScript-Bridge + SKILL.md auf Orchestrator-Agent
App hat kein WörterbuchAutomator-Workflow + run-automator
Agent auf remote Mac betreibenPersistente GUI-Anmeldung sicherstellen; siehe Remote-OpenClaw-Setup
3+ parallele Agenten brauchenNicht 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.