教程
打破沙盒误解:用 AppleScript 联动 OpenClaw,让 AI 智能体控制 Mac 桌面客户端(2026)
MacLogin AI 自动化团队
2026年6月4日
约 12 分钟
多数 OpenClaw 部署止步于Shell 与聊天。macOS 自带 AppleScript 与 Automator,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 |
| macOS | GUI 控制 | osascript / Automator |
| TCC | 用户同意 | 系统设置 → 自动化 |
八步操作手册
步骤 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 触发
osascript -e 'tell application "Music" to get name of current track'- 在聊天中向 OpenClaw 发起请求;**仅批准**与允许列表匹配的命令。
- 将 Automator 工作流保存到
~/Library/Services/;通过run_automator调用。
故障排除
Not authorized to send Apple events (-1743)
在终端重新运行,于「隐私与安全性 → 自动化」中为 Keynote / System Events 授权,或执行
在终端重新运行,于「隐私与安全性 → 自动化」中为 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 故障转移。