上篇聊了 OpenClaw 是什么。这篇记录我在 Mac 上实际安装和配置的过程。
环境
我的机器是 Mac M 系列,macOS Sequoia。系统里已经有 Node.js(nvm 管理),Homebrew 也装好了。
OpenClaw 官方推荐 Node 24,兼容 Node 22.16+。我当时用的是 22.20.0,能用,但后续 Active Memory 和 Dreaming 等功能对版本敏感,建议直接上 24。
安装
一行:
curl -fsSL https://openclaw.ai/install.sh | bash
脚本自动检测系统、确认 Node 版本、下载 OpenClaw、配好环境变量。全程两分钟。
openclaw --version
# 2026.4.14
初始化配置
openclaw onboard 是交互式向导,依次选:
- 风险提示 → Yes
- 启动模式 → QuickStart
- 模型供应商 → DeepSeek
- API Key → 从 platform.deepseek.com 获取
- 聊天工具 → 先 None,后面加飞书
- Gateway 端口 → 默认 18789
- Skills → 文件管理 + 知识管理
- Hooks → 三个全启用
选 DeepSeek 的原因:便宜。V3 模型几块钱一个月,R1 推理十几块。运维 Agent 场景,DeepSeek 的推理够用。
注意:DeepSeek API 账户余额必须大于 0 才能调用。充 10 块钱能用很久。
向导跑完自动启动 Gateway,浏览器打开 http://127.0.0.1:18789/chat。
踩的坑
Node 版本警告
Node 22 能用但 openclaw doctor 提示升 24:
nvm install 24
nvm use 24
nvm alias default 24
端口占用
首次启动报 18789 占用:
lsof -i :18789
杀了旧进程解决。
API Key 少复制了前缀
DeepSeek key 是 sk- 开头。第一次少复制两位,Gateway 报 401。重新跑 openclaw onboard 填正确的 key。
日常命令
openclaw gateway start # 启动
openclaw gateway stop # 停止
openclaw gateway restart # 重启
openclaw gateway status # 状态
openclaw update # 升级
openclaw doctor --fix # 诊断修复
配置位置 ~/.openclaw/:
openclaw.json— 主配置logs/gateway.log— 日志,排查先看它
下一步
Gateway 跑通了。后续:接飞书、写运维 Skill、试试 Task Flow。系列文章和进度在 OpenClaw 运维 Agent。