>> OpenClaw + AppleScript: Mac-Desktop-Apps per KI steuern

OpenClaw AppleScript Mac-AutomatisierungVerleiht einem Nur-Text-Agent-Gateway einen physischen Körper auf dem macOS-Desktop – Shell-Tool, Bridge-Skript und native App-Steuerung in einer angemeldeten Sitzung.

Einführung

Die meisten Teams laufenOpenClawals Nur-Text-operator: Gateway-Kanäle, HTTP-Tools und Shell-Snippets, die niemals die grafische Sitzung berühren. Das hinterlässt eine Lücke –native Mac-Apps(Keynote, Mail, Musik, System Settings) live hinter Apples GUI Automatisierungsebene, nicht in einer kopflosen SSH Pipe.

OpenClaw AppleScript Mac-Automatisierungschließt diese Lücke mit einem bewusstenBrückenmuster: OpenClaw ist gebürtigShell-Toolruft einen kleinen Bash-Einstiegspunkt auf, der versendetAppleScript (osascript) oderAutomatorWorkflows gespeichert als.workflow/ Anwendungspakete. Der Agent plant weiterhin in natürlicher Sprache; macOS führt weiterhin UI-Aktionen in der Sitzung des angemeldeten Benutzers aus.

Das bedeutet nicht, dass Apples Sandbox im Sinne der Sicherheit „zerstört“ wird – das geben Sie zuAutomatisierungUndZugänglichkeitBerechtigungen explizit festlegen. Du gibst OpenClaw aphysischer KörperAuf dem Mac-Desktop: Öffnen Sie Keynote, exportieren Sie ein PDF, stellen Sie die Lautstärke ein, dimmen Sie die Anzeige – während die Chat-Antworten auf Telegram oder Slack fortgesetzt werden.

Kombinieren Sie dieses guide mitOpenClaw + Ollama auf einer Wolke Mac miniwenn Sie lokale Modelle für die Planung und macOS Automatisierung für die Ausführung wünschen. VollständigOpenClaw leichte BereitstellungStellen Sie zunächst sicher, dass der Gateway-Zustand, launchd und die Festplattenwasserzeichen stabil sind, bevor Sie die GUI-Tools aktivieren.

EntsprechendApples macOS Automatisierungsdokumentation, AppleScript und Automator sind die unterstützten Brücken zwischen Skripten und skriptfähigen Anwendungen.

Architektur: Muschelbrücke → AppleScript / Automator

Datenfluss

Channel message → OpenClaw planner → shell tool "mac_desktop" → ~/bin/openclaw-mac-bridge.sh (JSON args) → osascript (inline .scpt) OR open MyWorkflow.app → Target app (Keynote, System Events, …) → stdout JSON { "ok": true, "artifact": "/path/file.pdf" }

Komponententabelle

Sitzungsregel:GUI Automatisierung erfordert aangemeldeter macOS Benutzermit einer grafischen Sitzung (lokale Konsole oder Bildschirmfreigabe auf einem Cloud-Mac). Nur SSH-Sitzungen ohne GUI können Keynote nicht steuern.

Warum nicht reine Schale?

Acht-Schritte-Runbook

Schritt 1 – Baseline-Gateway und GUI Sitzung

ssh user@your-mac openclaw --version curl -s http://127.0.0.1:11430/health whoami ls /dev/console # should exist when GUI session active

Bestehenskriterium: GatewayHTTP 200, Boot-Volume≥25 GBkostenlos (dasselbe wie72-Stunden-Leitplanken).

Schritt 2 – Erstellen Sie Bridge-Verzeichnisse

mkdir -p ~/bin mkdir -p "$HOME/Library/Application Support/OpenClaw/scripts" mkdir -p "$HOME/Library/Application Support/OpenClaw/workflows" mkdir -p ~/.openclaw/logs chmod 700 ~/bin/openclaw-mac-bridge.sh 2>/dev/null || true

Schritt 3 – Installieren Sie das Bridge-Skript

Speichern~/bin/openclaw-mac-bridge.sh:

#!/usr/bin/env bash set -euo pipefail LOG="$HOME/.openclaw/logs/mac-desktop.log" ACTION="${1:-}" ARG_JSON="${2:-{}}" ts() { date -u +"%Y-%m-%dT%H:%M:%SZ"; } case "$ACTION" in keynote_export_pdf) DECK="${ARG_JSON:-}" OUT="${3:-$HOME/Desktop/openclaw-export.pdf}" osascript "$HOME/Library/Application Support/OpenClaw/scripts/keynote_export_pdf.applescript" "$DECK" "$OUT" echo "{\"ok\":true,\"artifact\":\"$OUT\"}" ;; set_volume) LEVEL="${ARG_JSON:-50}" osascript -e "set volume output volume $LEVEL" echo "{\"ok\":true,\"volume\":$LEVEL}" ;; set_brightness) LEVEL="${ARG_JSON:-0.5}" osascript "$HOME/Library/Application Support/OpenClaw/scripts/set_brightness.applescript" "$LEVEL" echo "{\"ok\":true,\"brightness\":$LEVEL}" ;; run_automator) WF="${ARG_JSON:-}" open -a "$WF" echo "{\"ok\":true,\"workflow\":\"$WF\"}" ;; *) echo "{\"ok\":false,\"error\":\"unknown_action\"}" >&2 exit 2 ;; esac >>"$LOG" 2>&1

chmod 750 ~/bin/openclaw-mac-bridge.sh

Schritt 4 – Fügen Sie AppleScript-Helfer hinzu

keynote_export_pdf.applescript:

on run argv set deckPath to item 1 of argv set outPath to item 2 of argv tell application "Keynote" activate set docRef to open POSIX file deckPath export docRef to POSIX file outPath as PDF close docRef saving no end tell end run

set_brightness.applescript(verwendet System Events; erfordert Barrierefreiheit):

on run argv set level to item 1 of argv as number tell application "System Events" tell appearance preferences set brightness to level end tell end tell end run

Rauchtest manuell:

osascript "$HOME/Library/Application Support/OpenClaw/scripts/set_volume.applescript" 40 # or inline: osascript -e 'set volume output volume 40'

Schritt 5 – Erstellen Sie einen Automator-Workflow (optional)

1. OffenAutomator→ NeuSchnelle AktionoderAnwendung.
2. HinzufügenFühren Sie AppleScript aus→ Keynote Exportschritte einfügen.
3. Speichern unterExportKeynotePDF.workflowunter~/Library/Application Support/OpenClaw/workflows/.
4. Prüfen:open -a "$HOME/Library/Application Support/OpenClaw/workflows/ExportKeynotePDF.workflow"

Registrieren Sie sich in der Bridge alsrun_automatorwenn die Sequenzen ~30 Zeilen AppleScript überschreiten.

Schritt 6 – Registrieren Sie das Shell-Tool OpenClaw

Unter hinzufügen~/.openclaw/config/tools/(Das genaue Schema variiert je nach Build):

{ "name": "mac_desktop", "description": "Control native Mac apps via AppleScript/Automator. Actions: keynote_export_pdf, set_volume, set_brightness, run_automator. Args: action string, JSON payload, optional third path.", "type": "shell", "command": "/Users/OPERATOR/bin/openclaw-mac-bridge.sh", "timeout_seconds": 120, "allowed_actions": ["keynote_export_pdf", "set_volume", "set_brightness", "run_automator"] }

ErsetzenOPERATORmit dem macOS-Konto, auf dem das Gateway ausgeführt wird. Behalten Sie das Werkzeugim Labor deaktiviertbis Schritt 7 abgeschlossen ist.

Schritt 7 – SKILL.md-Richtlinie erstellen

Erstellen~/.openclaw/skills/mac-desktop/SKILL.md:

# Mac Desktop Automation (AppleScript) ## When to use - User asks to export slides, adjust volume/brightness, or open a native app. - Channel message includes `/deck` or `export pdf` with a file path on the Mac. ## Never - Delete files outside ~/OpenClawExports without human confirmation. - Change System Settings security/privacy panes. - Run Automator workflows not listed in allowed_actions. ## Steps 1. Confirm deck path exists: `test -f path`. 2. Call mac_desktop with keynote_export_pdf. 3. Reply with artifact path and file size from `stat -f%z`.

Starten Sie das Gateway nach Tool- und Skill-Änderungen neu.

Schritt 8 – Rauch mit Leitplanken kanalisieren

1. Senden Sie eine Testnachricht: „Stellen Sie die Lautstärke auf 35 % ein.“
2. Senden: „Exportieren/Users/you/Decks/Q2.keyan PDF.“
3. Verifizieren~/.openclaw/logs/mac-desktop.logzeigtAusgang 0und JSON stdout.

AktiviereneinsNur Messaging-Kanal – sieheGateway-Kanäle. Begrenzen Sie gleichzeitige Desktop-Aktionen auf1auf 16GB Hosts, um Keynote + schwere Modellkonflikte zu vermeiden.

Fehlerbehebung

Fehler:Not authorized to send Apple events to Keynote

Muster: osascriptAusfahrt1, Protokoll enthältNot authorized.

Fix:Auf dem Mac →System Settings → Datenschutz & Sicherheit → Automatisierung→ erlaubenosascript(oder Terminal/iTerm) zur SteuerungKeynote. Führen Sie den Rauchtest von Schritt 4 erneut durch. Bei Cloud-Macs einmal pro Snapshot-Image durchführen.

Fehler:GUI scripting is not allowed

Muster:Helligkeitsskript schlägt fehl; System Events Fehler-25211.

Fix:GewährenZugänglichkeitan Terminal/ssh Sitzungsübergeordneter perApples Barrierefreiheit guide. Verringern Sie die Helligkeit lieber überbrightnessnur während der interaktiven Stunden – Dokumentrichtlinie in SKILL.md.

Operative Auswirkungen

Desktop-Jobs mit Ollama serialisieren: nicht ausführen14B lokales Modell + Keynote Exportgleichzeitig an16GBeinheitliches Gedächtnis.

FAQ

Kann OpenClaw Mac-Apps ohne AppleScript steuern?
Nur teilweise. Shell-Tools verarbeiten CLI-Binärdateien.native GUI AppsSie benötigen AppleScript, Automator oder Verknüpfungen. Durch das Brückenmuster bleibt der Planer von OpenClaw unverändert, während macOS UI-Arbeiten ausführt.

Funktioniert AppleScript über SSH allein?
NEIN.osascriptzielt auf dieAngemeldete grafische Sitzung. Nutzen Sie den Konsolenzugriff oder die Bildschirmfreigabe auf einem Remote-Mac und führen Sie das Gateway unter demselben Benutzer aus.

Wie löse ich Automator von OpenClaw aus?
Registrierenrun_automatorim Bridge-Skript und Aufrufopen -a /path/to/Workflow.app. Übergeben Sie Argumente über eine Plist- oder Sidecar-JSON-Datei, die der Workflow in seiner ersten Aktion liest.

Ist das für Produktionsmitarbeiter sicher?
Behandeln Sie Desktop-Tools alshohes Privileg. Beschränkenallowed_actions, protokollieren jeden Aufruf und erfordern für destruktive Pfade die Zustimmung eines Menschen. FolgenOpenClaw Sicherheitfür Localhost-Gateway-Bindungen.

Funktioniert das auf Apple Silicon Mac mini M4?
Ja. AppleScript und Automator sind auf macOS 14+ architekturneutral. Der RAM-Druck von Keynote + OpenClaw + Ollama ist der praktische Begrenzer – behalten Sie jeweils einen schweren Job auf 16GB bei.

In welcher Beziehung steht SKILL.md zu AppleScript?
SKILL.md unterrichtetWannruft der Planer aufmac_desktop; AppleScript/Automator definiertWiemacOS führt die Aktion aus. Aktualisieren Sie SKILL.md jedes Mal, wenn Sie eine neue Workflow-Datei hinzufügen.

Abschluss

OpenClaw AppleScript Mac-Automatisierungverwandelt ein Text-Gateway in einen Desktop operator: Shell-Tool → Bridge-Skript →osascript/ Automator → native Apps. Das Muster ist geringer Wettbewerb, da die meisten Tutorials bei Chat-Antworten enden.

Beginnen Sie mitLautstärke + Keynote PDFRauchtests, Berechtigungen einmal pro Maschine härten, dann Kanalabsichten in SKILL.md verdrahten. Halten Sie Werbung von der heißen Seite fern – dies ist eine technische Brücke, kein Mietplatz.

Verwandte Artikel

• GPT-5.6 Prognose: Codex Open Source für Agent-Effizienz
• OpenClaw + Ollama auf einer Wolke Mac mini
• OpenClaw leichte Bereitstellung
• OpenClaw Sicherheit und Netzwerk
• Gateway-Kanäle und Ratenlimits
• 72-Stunden-Leitplanken