ИИ-автоматизация

OpenClaw AppleScript: управление нативными app macOS (2026)

OpenClaw AppleScript Automator автоматизация рабочего стола macOS 2026
Раскрытие: KuzCloud публикует руководства по Mac-хостингу; эта статья — техническая документация. OpenClaw — сторонний OSS — см. openclaw.dev.
Кратко: Большинство развёртываний OpenClaw останавливаются на тексте и shell в терминале. На macOS агенту можно дать физическое «тело» рабочего стола, связав навыки OpenClaw (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

ЗадачаAppleScriptWorkflow AutomatorShell (только инструменты openclaw)
Экспорт PDF из KeynoteНативная команда exportЗапись кликов по меню, если нет APIНет
Громкость / яркостьSystem EventsИзбыточноOne-liner osascript
Нескриптуемое Electron-приложениеХрупкоЧасто проще (запись UI)Нет
CI на удалённом LinuxН/ДН/ДДа
Аудируемость, версионирование.applescript в gitBundle .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 (опционально)

  1. Открыть Automator → Быстрое действие
  2. Записать: Keynote → Файл → Экспортировать в → PDF (сохранить в ~/Documents/OpenClaw-Exports/)
  3. Сохранить как Export-Keynote-PDF.workflow в ~/Library/Services/
  4. Тест: automator ~/Library/Services/Export-Keynote-PDF.workflow

Подключите через openclaw-mac-bridge run-automator …, если экспорт AppleScript не работает на вашей версии Keynote.

Шаг 5 — выдать разрешения конфиденциальности macOS

  1. «Системные настройки» → «Конфиденциальность и безопасность» → «Автоматизация» — разрешить Terminal/iTerm (или node) управлять Keynote
  2. «Универсальный доступ» — тот же хост для скриптов яркости System Events
  3. Запустите мост вручную ещё раз; подтвердите запросы

Шаг 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.