基础环境搭建

Mac 自带 Git,但缺 Node.js。去官网下载 v24.13.1 (LTS) 的 .pkg 安装包,一路默认点下去就行,Node 和 npm 会自动配好。

拉取源码:

git clone <OpenClaw官方仓库地址>
cd openclaw
npm install

这里有个坑:执行 npm start 启动时会报 Error: spawn pnpm ENOENT,因为底层编译依赖 pnpm。解决办法:

sudo npm install -g pnpm

注意前面的 sudo,没有管理员权限装不上。

API 配置:Pro 会员和 API 是两回事

这是最容易踩的一个坑,值得单独拎出来说。

很多人(包括原作者)买了 Google Pro 会员(Gemini Advanced),想着直接拿来跑 Agent。说白了,这是把「堂食会员卡」拿去「外卖窗口」刷——两套体系,互不相通。Pro 会员是给人类用的网页端服务,拿脚本在后台高频调用,分分钟触发防刷机制被封。

OpenClaw 作为自动化程序,必须走开发者 API。正确姿势是去 Google AI Studio 申请 API Key。好消息是,Google 目前的免费层级(Free Tier)相当大方,跑 Gemini-3-Flash 模型的免费 Token 额度,个人用来做自动化监控完全够用,不用额外花钱。

拿到 Key 后:

cp .env.example .env

这个 .env 是隐藏文件,Finder 里默认看不到。编辑时注意一个细节:配置文件里 # 是注释符,填写 GOOGLE_API_KEY=必须把前面的 # 删掉,否则程序压根读不到这行。别问为什么要特意提这个——因为真的有人卡在这一步卡了半天。

用 PM2 实现 24 小时后台运行

Agent 的价值在于不间断运行。直接用 npm start 的问题是,终端窗口一关程序就死了。

解决方案是用 PM2 做进程守护:

sudo npm install -g pm2
pm2 start npm --name "longxia" -- start
pm2 save

pm2 save 的作用是保存进程列表,机器重启后不会丢。

这里有个隐藏的坑:检查一下 watching 状态,必须是 disabled。如果开着 watching,程序每次写日志都会被 PM2 当成文件变动,触发重启,然后重启又写日志,又触发重启——一个经典的无限循环死亡螺旋。

架构思路小结

这套部署验证了一个对独立开发者很有参考价值的模式:不需要砸钱买顶级 GPU,一台 Mac Mini M4 + 云端大模型 API 的组合,就能搭出一个 24 小时运行的 AI Agent。本地设备负责运行框架和执行动作,云端负责推理决策,各司其职。后续可以对接 Telegram 等消息接口,做新闻聚合、数据监控之类的自动化场景——对于一人公司来说,这相当于雇了一个不睡觉的数字员工,而成本几乎为零。