本文面向在本地 MacMacCloud 独享物理实例上落地 OpenClaw 的工程师。下面按「能跑起来 → 能长期跑 → 能和云端对齐」的顺序写,具体命令与版本请以你所用的 OpenClaw 发行说明为准;这里给的是与 macOS 生态贴合的一套基线。

一、写给谁、目标是什么

如果你需要命令行工具常驻、偶尔又要图形界面排障,macOS 仍然是最顺滑的宿主。目标不是罗列每一条官方文档,而是把路径、权限、守护进程三件事一次摆平,避免「本机 OK、一上 SSH 就挂」的反复。

二、环境准备与架构

建议使用当前稳定版 macOS,并安装 Xcode Command Line Tools(终端执行 xcode-select --install)。在 Apple Silicon 上,确认你下载的二进制为 arm64,或与团队的 Rosetta 策略一致;混用架构最容易表现为「偶发崩溃、动态库加载失败」。

提示:在 MacCloud 实例上同样走这套检查;控制台里核对 SSH 用户、数据盘挂载点后再装依赖,少踩一层路径坑。

三、安装 CLI 与 PATH

把可执行文件或包管理器安装路径写进 ~/.zshrc~/.bash_profile,并在当前会话 source 一次验证。尽量避免把第三方工具塞进需要提权的全局目录——在独享物理机上你可以这么做,但要自己承担升级与审计成本。

四、隐私、自动化与无头场景

若 OpenClaw 需要控制其他 App 或扫盘,请在系统设置 → 隐私与安全性里按需打开「完全磁盘访问」「自动化」等项。纯 SSH 无头场景下,更推荐用 launchd 管理常驻进程:写清 WorkingDirectory、标准输出日志路径,以及合理的 ThrottleInterval,避免异常重启打满 CPU。

五、与 MacCloud 云端实例联调

在云上重复上述步骤时,请通过控制台确认网络与安全组策略;不要把私钥写进仓库,用跳板或短期凭证。更完整的云上实践见同系列的《在 MacCloud 云上运行 OpenClaw 的实践》

六、上线前自检清单

  • 本机与云端是否为同一 macOS / 芯片架构 组合?
  • which openclaw(或等价命令)在登录 shell 与非交互 SSH 下是否一致?
  • launchd / 手动启动是否都能优雅退出,日志里有没有循环重启?
  • 隐私权限是否在首次弹窗就按最小集授予,避免后续无人值守时卡对话框?

安装只是第一步;当你把 OpenClaw 接进流水线或定时任务时,记得同步读GitHub Actions 集成自动化编排两篇,把触发、密钥与可观测性一次对齐。