OpenClaw（龙虾）在macOS Sequoia怎么配置经验分享

引言

OpenClaw（龙虾）是一款面向 macOS 系统的开源命令行工具，用于自动化抓取、解析和导出网页结构化数据（如商品标题、价格、库存、评论等），常被跨境卖家用于竞品监控、选品分析或价格追踪。它非 SaaS 服务，也非平台官方工具，而是基于 Python + Playwright 构建的本地脚本工具；macOS Sequoia 是苹果 2024 年发布的最新操作系统版本（15.0+），其系统安全策略（如 SIP、Privacy Access Controls、Apple Events 权限）对 OpenClaw 类自动化工具的运行构成关键影响。

要点速读（TL;DR）

• OpenClaw 在 macOS Sequoia 上无法直接运行：需手动授权「辅助功能」「完全磁盘访问」「自动化」三项隐私权限；
• 必须使用 python3.11+ + playwright 官方浏览器二进制（非 Chromium 默认包），否则触发 NSURLErrorDomain -1004 或白屏；
• Sequoia 引入 App Sandbox 增强机制，导致部分 playwright 启动参数（如 --no-sandbox）失效，需改用 --disable-features=IsolateOrigins,site-per-process；
• 不依赖任何云服务或账号体系，纯本地部署，无订阅费、无 API 调用限制。

它能解决哪些问题

• 场景痛点：想批量采集 Amazon/Shopify/Walmart 商品页基础字段（ASIN、Price、Review Count），但 Safari/Chrome 自动化被 Sequoia 系统级拦截 → 价值：通过 OpenClaw 绕过浏览器 UI 权限限制，以 headless 模式稳定执行；
• 场景痛点：用旧版脚本在 macOS Sonoma 正常，升级 Sequoia 后 playwright 启动失败、截图全黑 → 价值：提供适配 Sequoia 的启动参数模板与权限修复 checklist；
• 场景痛点：团队多人共用同一套采集逻辑，但 Mac 环境差异导致成功率波动大（尤其 M3/M4 芯片机型）→ 价值：明确标注芯片架构兼容性（仅支持 arm64，x86_64 需 Rosetta 2 兼容模式）。

怎么用／怎么配置（macOS Sequoia 专属流程）

1. 确认系统版本：终端执行 sw_vers，确保输出 ProductVersion: 15.x（Sequoia）；
2. 安装 Python 3.11+：推荐使用 pyenv 管理版本（pyenv install 3.11.9 && pyenv global 3.11.9），避免系统自带 Python 冲突；
3. 安装 Playwright 及浏览器：执行 pip install playwright && playwright install --with-deps chromium；注意：必须使用 --with-deps 安装完整依赖（含 libavif、libwebp），否则 Sequoia 下渲染失败；
4. 授予权限（关键！）：前往 系统设置 → 隐私与安全性 → 辅助功能 / 完全磁盘访问 / 自动化 → 添加 Terminal.app 和 python 进程（路径通常为 /opt/homebrew/bin/python3 或 /usr/local/bin/python3）；
5. 启动参数适配：在 OpenClaw 的 config.yaml 或启动脚本中，将 playwright launch 参数替换为：
   {"headless": true, "args": ["--disable-features=IsolateOrigins,site-per-process", "--disable-gpu"]}；
6. 验证运行：执行 python main.py --test-url https://example.com，观察是否返回 HTML 结构及截图（screenshot.png），若报错 NSURLErrorDomain -1200，说明 TLS 证书校验失败，需在代码中添加 ignore_https_errors=True（仅测试环境）。