OpenClaw AppleScript: управление нативными app macOS (2026)
SKILL.md) с небольшим мостовым скриптом, который вызывает osascript (AppleScript) или запускает workflow Automator. Агент сможет открыть Keynote, экспортировать PDF, изменить громкость системы или приглушить дисплей — а триггеры чата останутся в шлюзе. Ожидайте запросы TCC (Универсальный доступ / Автоматизация) и относитесь к полному GUI-контролю как к высоким привилегиям.
Почему текстовый OpenClaw не использует возможности macOS
OpenClaw отлично справляется с репозиториями, CI-хуками и мультиагентным fan-out. На Mac mini или MacBook тот же демон часто работает headless по SSH: редактирует файлы и запускает npm test, но никогда не трогает Mail, Keynote, Music или «Системные настройки».
Этот разрыв важен, когда ваш workflow ориентирован на оператора, а не на разработчика:
- Стейкхолдер пишет в командный канал «экспортировать deck v3 в PDF»
- Перед записью демонстрации экрана нужно снизить яркость
- Ночная задача должна архивировать слайды без ручного UI
macOS уже поставляет «клей»: AppleScript общается со scriptable-приложениями; Automator упаковывает повторяемые UI-макросы в .workflow, запускаемые из shell. Система навыков OpenClaw — третья опора: документированные инструменты, которые модель может вызывать. Свяжите их — и агент перестаёт быть чат-ботом в песочнице, становясь локальным консьержем с руками на рабочем столе.
Гайд предполагает установленный OpenClaw (справка по установке). Фокус — автоматизация рабочего стола, не теория оркестрации.
Архитектура: шлюз → навык → мост → AppleScript / Automator
Поток данных одной фразой: сообщение канала → шлюз OpenClaw → обработчик навыка → /usr/local/bin/openclaw-mac-bridge → osascript или automator → нативное приложение или System Events.
| Слой | Ответственность | Типичный путь |
|---|---|---|
| Шлюз | Маршрутизирует chat/webhook к агенту | Демон openclaw |
Навык (SKILL.md) | Документирует аргументы, правила безопасности, примеры | ~/.openclaw/skills/mac-desktop/SKILL.md |
| Мост (bash) | Проверяет ввод, логирует, вызывает macOS | ~/bin/openclaw-mac-bridge |
| AppleScript | Глаголы приложений (Keynote, Finder) | inline или ~/Scripts/*.applescript |
| Automator | Записанный UI, когда AppleScript хрупок | ~/Library/Services/Export-Keynote-PDF.workflow |
Apple документирует scriptable-приложения в руководстве по языку AppleScript. Для GUI-скриптинга через System Events нужно разрешение Универсальный доступ для терминала (или osascript) в «Системные настройки» → «Конфиденциальность и безопасность».
Позиция по безопасности: мостовые скрипты запускайте только на выделенном Mac для автоматизации (или VM/сессии, которую можно стереть). Полный контроль рабочего стола плюс shell-доступ агента = UX, эквивалентный root — тот же класс риска, что и отключение песочницы для worker’ов.
Матрица решений: AppleScript vs Automator vs только shell
| Задача | AppleScript | Workflow Automator | Shell (только инструменты openclaw) |
|---|---|---|---|
| Экспорт PDF из Keynote | Нативная команда export | Запись кликов по меню, если нет API | Нет |
| Громкость / яркость | System Events | Избыточно | One-liner osascript |
| Нескриптуемое Electron-приложение | Хрупко | Часто проще (запись UI) | Нет |
| CI на удалённом Linux | Н/Д | Н/Д | Да |
| Аудируемость, версионирование | .applescript в git | Bundle .workflow в git | Только SKILL.md |
| Headless SSH Mac | Работает при залогиненной GUI-сессии | Нужна графическая сессия | Работает |
Правило: предпочитайте AppleScript, когда словарь приложения даёт глагол; Automator — для действий только через меню; shell оставьте для файлов/git.
Пошаговый runbook: мост + SKILL.md + три действия
Шаг 1 — создать мостовой скрипт
Сохраните как ~/bin/openclaw-mac-bridge и выполните 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
На Apple Silicon macOS 14+ яркость через appearance preferences может требовать залогиненной GUI-сессии; протестируйте локально перед подключением к чату.
Шаг 2 — написать SKILL.md для навыка mac-desktop
Путь: ~/.openclaw/skills/mac-desktop/SKILL.md (подстройте под корень навыков OpenClaw):
# 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
Зарегистрируйте навык в конфиге агента (зависит от релиза — повторите существующие записи skills: ["git", "nodejs"] в openclaw.json).
Шаг 3 — разрешить мост в политике инструментов агента
Если оркестратор использует sandboxed worker’ы, навык рабочего стола только у агента-оркестратора с sandbox.mode: off для этого agent ID. Worker’ы, которые только правят код, не должны получать mac-desktop.
Шаг 4 — собрать workflow Automator (опционально)
- Открыть Automator → Быстрое действие
- Записать: Keynote → Файл → Экспортировать в → PDF (сохранить в
~/Documents/OpenClaw-Exports/) - Сохранить как
Export-Keynote-PDF.workflowв~/Library/Services/ - Тест:
automator ~/Library/Services/Export-Keynote-PDF.workflow
Подключите через openclaw-mac-bridge run-automator …, если экспорт AppleScript не работает на вашей версии Keynote.
Шаг 5 — выдать разрешения конфиденциальности macOS
- «Системные настройки» → «Конфиденциальность и безопасность» → «Автоматизация» — разрешить Terminal/iTerm (или
node) управлять Keynote - «Универсальный доступ» — тот же хост для скриптов яркости
System Events - Запустите мост вручную ещё раз; подтвердите запросы
Шаг 6 — привязать триггер чата (концептуально)
В правилах канала (Discord/Telegram/webhook) сопоставьте фразу задаче оркестратора:
When message matches ^/deck pdf (.+)$, call mac-desktop keynote-export-pdf with captured path.
Точный синтаксис hook зависит от плагинов каналов OpenClaw — это системный промпт оркестратора + разрешённые инструменты, а не магическая маршрутизация.
Шаг 7 — проверить через openclaw doctor и dry run
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 и строках лога в ~/.openclaw/logs/mac-bridge.log.
Шаг 8 — production guardrails
- Выделенная учётная запись
automationс элементами связки ключей только для Keynote - Rate limit: максимум 6 GUI-действий/час на канал
- Allowlist: пути deck под
~/Documents/Decks/ - Свяжите с инструментами MCP для DB/API; GUI только на навыке mac-desktop
Устранение неполадок
Ошибка: execution error: Not authorized to send Apple events to Keynote
Паттерн: (-1743) или «Not authorized» в stderr osascript.
Исправление: «Системные настройки» → «Конфиденциальность и безопасность» → «Автоматизация» → включить ваш терминал → Keynote. Перезапустите мост; при headless SSH выполните один раз из сессии «Общий экран», чтобы появились запросы.
Ошибка: System Events got an error: Can’t set brightness
Паттерн: скрипт успешен для громкости, но падает на яркости.
Исправление: выдайте терминалу «Универсальный доступ»; обеспечьте залогиненную GUI-сессию (не launchd без консоли). Fallback: действие Automator «Изменить яркость» вместо AppleScript.
Сценарий A — групповой чат «Отправь PDF»
Командный бот слышит: «экспортировать keynote для звонка с инвесторами». Оркестратор разбирает имя deck, вызывает keynote-export-pdf, загружает PDF отдельным файловым инструментом и отвечает SHA256 + путь. Задержка: ~8–15 с для deck на 40 слайдов на M4 (диск + холодный старт Keynote). RAM: Keynote добавляет ~400–900 МБ пик — нормально рядом с одним демоном OpenClaw на 16 ГБ; избегайте параллельного fan-out на том же GUI-хосте.
Сценарий B — сброс окружения перед записью
Перед захватом OBS агент выполняет set-volume 35 и set-brightness 60, затем запускает Automator, чтобы скрыть extras в строке меню. Следствие: это глобальные изменения — задокументируйте откат (set-volume 70) в той же сессии навыка.
Рекомендуемый путь
| Если вы… | Сделайте это |
|---|---|
| Нужны только файлы/git/CI | Пропустите GUI-навыки; оставайтесь на shell-инструментах |
| Нужны Keynote/Pages/Finder | Мост AppleScript + SKILL.md на агенте-оркестраторе |
| У приложения нет словаря | Workflow Automator + run-automator |
| Агент на удалённом Mac | Обеспечьте постоянный GUI-логин; см. удалённую настройку OpenClaw |
| Нужно 3+ параллельных агента | Не делите одну GUI-сессию — сериализуйте вызовы mac-desktop |
FAQ
Может ли OpenClaw запускать AppleScript в headless SSH-сессии?
Только если у macOS есть активная сессия WindowServer для целевого пользователя (логин через «Общий экран» или локальная консоль). Чистый SSH без GUI-логина не работает для Keynote и UI-скриптинга System Events.
Чем это отличается от мультиагентной оркестрации OpenClaw?
Мультиагентная оркестрация делит worker’ы рассуждения. Автоматизация рабочего стола — инструмент привилегий одного хоста: запускайте на одном оркестраторе, не fan-out к трём кодерам, одновременно бьющим Keynote.
Безопасен ли AppleScript для production?
Он мощный, но не безопасен по умолчанию. Относитесь к mac-desktop как к production shell: allowlist’ы, логирование, выделенный Mac, без личной почты в той же пользовательской сессии.
Работает ли это с Claude Code или Copilot CLI?
Эти CLI не поставляют маршрутизатор навыков OpenClaw. Можно переиспользовать тот же мостовой скрипт из shell-инструмента, но потеряете централизованную маршрутизацию каналов — см. сравнение бенчмарков для выбора стека.
А как с сетевыми ограничениями и паттерном удалённого Mac?
Чтобы стабилизировать маршруты npm/API, многие команды запускают шлюз на постоянно работающем удалённом Mac — тот же паттерн, что в удалённой настройке OpenClaw. AppleScript по-прежнему выполняется на рабочем столе этого Mac, а не на вашем локальном ноутбуке.
Связанные руководства
Перед подключением desktop-навыков к чату прочитайте мульти-агентную оркестрацию и удалённую установку OpenClaw.