教程

打破沙盒误解:用 AppleScript 联动 OpenClaw,让 AI 智能体控制 Mac 桌面客户端(2026)

MacLogin AI 自动化团队 2026年6月4日 约 12 分钟
OpenClaw AppleScript 联动 Mac 桌面自动化

多数 OpenClaw 部署止步于Shell 与聊天。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 提示。在大陆环境下,隐私与安全性里的自动化白名单同样适用——未授权的应用无法向 Keynote 发送 Apple 事件。

可引用: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用户同意系统设置 → 自动化

八步操作手册

步骤 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。

常见问题

先学 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 桥接与 macOS 自动化实践。

可选:云端 Mac 常驻 OpenClaw

先在本地 Mac 试桥接脚本;仅 24/7 网关且需 GUI 会话时才考虑租用。