チュートリアル

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 と 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_pdfset_volumerun_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 書き出しのクリック録画向けです。
フルディスクアクセスと同じ?+
いいえ——自作スクリプトへの per-app 自動化と、OpenClaw のコマンド承認です。
クラウド Mac は?+
GUI ログインと TCC があれば動作します。純粋なヘッドレス SSH では Keynote は操作できません。
グループチャットからトリガー?+
SKILL.md で「deck pdf」などを run_automator にマップ;OpenClaw 設定でユーザーをホワイトリストしてください。
API フェイルオーバーとの関係?+
デスクトップブリッジは別系統——クラウド API 障害は OpenClaw + Ollama フェイルオーバー を参照してください。
MacLogin AI 自動化チーム
OpenClaw スキルと AppleScript ブリッジのガイド。

任意:クラウド Mac で常時稼働

ノート PC で試してから—GUI セッションが必要な場合のみクラウド Mac。