OpenClaw Mac 安装保姆级教程：从零跑通你的第一个本地 Agent

这篇教程适合使用 macOS、希望先把 OpenClaw 跑起来的初学者。目标不是一步做到最复杂，而是先完成最小闭环：本地安装成功、能打开控制台、能完成第一次 Agent 对话。

如果你还没有长期运行需求，也不急着接消息渠道，那么 Mac 本地安装会比 Docker 或远程服务器更容易理解。

第一，确认系统环境足够新，并已安装 Node.js 22 或更高版本。第二，准备一个可用的大模型提供商账号与 API Key，后续 onboarding 会用到。第三，确保本机网络和命令行环境正常，避免安装时被基础环境卡住。

如果你之前几乎没有做过本地开发环境配置，建议先单独检查 Node 版本和终端权限，再开始安装。

对大多数新手来说，最稳妥的路径是使用官方安装方式完成命令行安装，然后执行 `openclaw onboard --install-daemon` 进入初始化流程。这个流程会帮助你依次完成模型、认证、控制台与基础运行环境的配置。

onboarding 最大的好处，是把原本零散的步骤收拢成一个可引导流程。对于第一次安装的人来说，不建议一上来就自己手搓所有配置文件。

完成后，优先先用 Control UI 验证 OpenClaw 是否正常运行。只要浏览器控制台能正常打开、模型能正常响应，就说明最小闭环已经建立起来了。

第一，不要一开始就给太高系统权限。第二，不要立即接入所有消息渠道。第三，不要还没测试稳定性就把它当长期代理丢在后台。

更合理的顺序应该是：先本地测试对话，再测试简单工具调用，再逐步增加渠道与权限。这样出了问题也更容易排查。

如果安装后命令找不到，多半是 PATH 或安装步骤没有完成；如果控制台打不开，通常要先检查 daemon 是否正常；如果模型无响应，优先检查 API Key、provider 配置和网络。

新手最容易陷入的误区，是一报错就怀疑项目本身有问题。实际上，大多数安装问题都来自本地环境、版本、权限或 provider 配置。把这些基础项逐一排查，成功率会高很多。