OpenClaw（龙虾）在macOS Sonoma怎么写脚本保姆级教程

引言

OpenClaw（龙虾）是一个开源的 macOS 自动化工具集，专为 macOS Sonoma（14.x）及更高版本设计，用于替代 AppleScript 或 Automator 实现更稳定、可编程的系统级操作（如窗口管理、应用控制、文件批量处理等）。它基于 Swift 编写，通过命令行接口（CLI）调用原生 macOS Accessibility API 和 Scripting Bridge，不依赖 GUI 模拟，规避了 macOS 安全限制导致的自动化失效问题。

要点速读（TL;DR）

• OpenClaw 不是商业软件或 SaaS 工具，而是 GitHub 开源项目（MIT 协议），无订阅费、无账号体系；
• 仅支持 macOS Sonoma 14.4+（需启用辅助功能权限），不兼容 Ventura 及更早系统；
• 核心能力：窗口定位/聚焦/缩放、App 启动/切换/退出、菜单栏点击、剪贴板监听、定时触发——适合跨境卖家高频重复操作（如多店铺浏览器窗口轮巡、订单截图归档、ERP 数据粘贴校验）；
• 脚本编写无需 Swift 基础，用 YAML + 内置指令即可完成 90% 场景；复杂逻辑可嵌入 Python/Shell；
• 首次运行必须手动授权「辅助功能」+「完全磁盘访问」，否则所有操作静默失败。

它能解决哪些问题

• 场景痛点：运营人员每天需在 Safari/Chrome 中切换 5+ 个独立站点（Amazon US/CA/UK、Shopify 多店、后台 ERP），手动拖拽/聚焦窗口耗时且易错 → 对应价值：用 OpenClaw 脚本一键按预设顺序聚焦窗口、调整尺寸、截图保存至指定文件夹；
• 场景痛点：物流单号批量复制后需粘贴到 3 个不同系统（WMS、货代平台、客服工单），反复 Ctrl+V 易漏项 → 对应价值：脚本监听剪贴板变化，自动识别单号格式并分发至各目标应用指定输入框；
• 场景痛点：每日 9:00 需导出 Shopify 后台订单 CSV、重命名含日期、上传至 NAS 并 Slack 通知 → 对应价值：结合 cron + OpenClaw + shell 命令链，实现零人工值守执行。

怎么用：从安装到写第一个脚本（6 步实操）

1. 确认系统版本：打开「关于本机」→ 确保显示「macOS Sonoma 14.4 或更高版本」；低于此版本无法运行（Apple 移除了旧版 Accessibility API 支持）；
2. 安装依赖：终端执行：brew install swift-sh（Homebrew 必须已安装）；
3. 下载 OpenClaw：终端执行：curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash（官方唯一安装方式，自动下载二进制并设为可执行）；
4. 授予权限：前往「系统设置 → 隐私与安全性 → 辅助功能」+「完全磁盘访问」→ 点击「+」添加 /usr/local/bin/openclaw（路径以安装后 which openclaw 输出为准）；
5. 写第一个脚本（YAML 格式）：新建文件 focus-shopify.yaml，内容如下：
   

   actions:
     - app: "Safari"
       focus: true
       resize: [1200, 800]
       move: [0, 0]
     - app: "Slack"
       focus: true
       resize: [400, 600]
       move: [1200, 0]

6. 运行脚本：终端执行：openclaw run focus-shopify.yaml，观察窗口是否按指令定位。首次运行会弹窗请求辅助功能授权，必须点「好」。

费用/成本影响因素

• OpenClaw 本身免费开源，无许可费、无隐藏收费；
• 成本仅来自：Mac 硬件性能（M1/M2/M3 芯片运行流畅，Intel Mac 需 macOS Sonoma 14.5+ 才稳定）；
• 若集成到 CI/CD 流程（如 GitHub Actions 触发脚本），需自建 macOS 运行节点（Apple Silicon Mac Mini 推荐）；
• 企业级部署需自行维护脚本版本、权限策略与错误日志收集，无官方技术支持通道。

常见坑与避坑清单

• 坑1：脚本无报错但无动作 → 90% 是未授予「辅助功能」权限，检查「系统设置 → 隐私与安全性」中 openclaw 是否勾选；
• 坑2：Safari 窗口无法聚焦 → macOS Sonoma 默认禁用 Safari 的 AppleScript 支持，需在 Safari「设置 → 高级」中勾选「在菜单栏中显示开发菜单」并启用「允许 JavaScript 从其他应用程序运行」；
• 坑3：中文路径/文件名乱码 → YAML 文件必须保存为 UTF-8 编码（Sublime/VSC 都默认支持），避免用 TextEdit 直接保存；
• 坑4：定时任务（cron）失效 → cron 环境无 GUI Session，需改用 launchd（官方文档提供 plist 模板），或改用 openclaw schedule 子命令（v0.8.0+ 支持）。

FAQ

OpenClaw 靠谱吗？是否合规？

OpenClaw 是 MIT 协议开源项目（GitHub 仓库 stars > 1.2k，last commit < 7 天），代码完全公开，不采集用户数据，不联网验证 license。其调用的是 Apple 官方公开 API（AXUIElement、SBApplication），符合 macOS 安全模型，已在多个跨境团队生产环境稳定运行超 6 个月（据 2024 Q2 GitHub Issues 反馈汇总）。

OpenClaw 适合哪些卖家？

适合具备基础终端操作能力的独立站/多平台卖家：① 使用 macOS Sonoma 且不愿/不能升级到 macOS Sequoia；② 需高频切换多店铺后台、批量处理订单/物流信息；③ 已有简单 Shell/Python 脚本经验，希望提升自动化稳定性（相比 UI 模拟类工具如 Keyboard Maestro 或 SikuliX）；④ 不接受 SaaS 订阅模式，倾向自控、可审计的本地化方案。

OpenClaw 怎么开通？需要哪些资料？

无需开通，无账号体系。只需：① macOS Sonoma 14.4+ 设备；② Homebrew 包管理器；③ 终端操作权限；④ 手动授予两项系统权限（辅助功能 + 完全磁盘访问）。无企业资质、营业执照、邮箱注册等要求。

结尾

OpenClaw 是面向 macOS Sonoma 的轻量级自动化基础设施，非黑盒工具，可控、可审计、零成本。