튜토리얼

OpenClaw를 AppleScript·Automator로 macOS 데스크톱에 연결 (2026)

MacLogin AI 자동화 팀 2026년 6월 4일 약 12분
OpenClaw AppleScript 자동화

많은 OpenClaw 구성은 셸과 채팅에서 멈춥니다. macOS에는 AppleScriptAutomator가 기본 제공되므로, Agent가 Keynote를 열고 볼륨을 조절하거나 저장된 워크플로를 실행할 수 있습니다—Telegram에서만 답하는 것이 아닙니다. 본 가이드는 샌드박스 우회 오해를 바로잡고, AppleScript로 OpenClaw와 연동하여 승인한 TCC 범위에서 Mac 클라이언트를 제어하는 방법을 설명합니다.

패턴: SKILL.md가 Agent에게 osascript를 감싼 브리지 스크립트 호출 시점을 알려 줍니다. 참고: OpenClaw 온보딩, 메신저 채널, Rules vs Skills. npm 미러나 클라우드 API 키 설정은 데스크톱 GUI 자동화와 무관하며, 후자는 로컬 스크립트와 시스템 프라이버시 승인에만 의존합니다.

고지: 본 가이드는 MacLogin이 게시합니다. 자동화에는 Mac의 「개인정보 보호 및 보안 → 자동화」에서 사용자 승인이 필요하며, 「샌드박스 파괴」가 아닙니다. 문서: Apple Mac Automation.

OpenClaw를 데스크톱에 브리지하는 이유

CLI 전용 Agent는 Keynote의 「보내기」 메뉴를 클릭할 수 없습니다. 로컬 브리지는 데이터를 디스크에 두고, 다른 매크로 도구와 동일한 TCC 프롬프트를 사용합니다.

인용: OpenClaw가 동작을 선택하고, openclaw-mac-bridge.sh가 허용 목록을 적용하며, AppleScript가 GUI 앱을 구동합니다.

아키텍처

계층역할경로
채널사용자 메시지Telegram / WhatsApp
Skill실행 시점~/.openclaw/skills/mac-desktop/SKILL.md
브리지허용 목록 + 로그~/bin/openclaw-mac-bridge.sh
macOSGUI 제어osascript / Automator
TCC사용자 동의시스템 설정 → 자동화

8단계 런북

1–2단계 — 사전 요건 및 skill 폴더

openclaw --version
mkdir -p ~/.openclaw/skills/mac-desktop

3단계 — SKILL.md

허용 동작을 문서화합니다: keynote_export_pdf, set_volume, run_automator. 채팅에서 명시적 확인 없이는 파괴적 명령을 금지하십시오.

4–5단계 — 브리지 스크립트 및 자동화

#!/usr/bin/env bash
ACTION="${1:-}"
case "$ACTION" in
  set_volume) osascript -e "set volume output volume ${2:-40}" ;;
  run_automator) automator "$2" ;;
esac

한 번 실행: ~/bin/openclaw-mac-bridge.sh set_volume 30 — **Automation** 프롬프트를 승인하십시오.

6–8단계 — 테스트 및 Telegram 트리거

  1. osascript -e 'tell application "Music" to get name of current track'
  2. 채팅에서 OpenClaw에 요청하십시오. **허용 목록과 일치하는 명령만** 승인하십시오.
  3. Automator 워크플로를 ~/Library/Services/에 저장하고 run_automator로 호출하십시오.

문제 해결

Not authorized to send Apple events (-1743)
터미널에서 다시 실행하고, 「개인정보 보호 및 보안 → 자동화」에서 Keynote/System Events를 승인하거나 tccutil reset AppleEvents 후 재승인하십시오.

GUI 없는 SSH: AppleScript에는 로그인된 그래픽 세션이 필요합니다—VNC를 사용하거나 키보드가 있는 Mac에서 gateway를 실행하십시오.

FAQ

AppleScript와 Automator 중 무엇을 먼저?+
AppleScript는 단순 동사(볼륨, 앱 활성화)에 적합합니다. Automator는 Keynote보내기 클릭 녹화에 적합합니다.
전체 디스크 접근과 동일한가요?+
아닙니다—직접 작성한 스크립트에 대한 앱별 자동화와 OpenClaw 명령 승인입니다.
클라우드 Mac에서 가능한가요?+
GUI 로그인과 TCC가 있으면 동작합니다. 순수 헤드리스 SSH로는 Keynote를 구동할 수 없습니다.
그룹 채팅에서 트리거?+
SKILL.md에서 「deck pdf」 등을 run_automator에 매핑합니다. OpenClaw 설정에서 사용자를 허용 목록에 등록하십시오.
API 페일오버와 관련?+
데스크톱 브리지는 별도입니다—클라우드 API 장애는 OpenClaw + Ollama 페일오버를 참고하십시오.
MacLogin AI 자동화 팀
OpenClaw 스킬 및 AppleScript 브리지 가이드.

선택: 클라우드 Mac 상시 게이트웨이

노트북에서 먼저 테스트—GUI 세션이 있을 때만 클라우드 Mac(서울 노드).