OpenClaw 02:Mac 本地安装与配置全流程

Mac 本地安装 OpenClaw + DeepSeek 完整流程。从 Node.js 版本选择到 Gateway 启动,以及安装过程中踩到的坑。

上篇聊了 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 是交互式向导,依次选:

  1. 风险提示 → Yes
  2. 启动模式 → QuickStart
  3. 模型供应商 → DeepSeek
  4. API Key → 从 platform.deepseek.com 获取
  5. 聊天工具 → 先 None,后面加飞书
  6. Gateway 端口 → 默认 18789
  7. Skills → 文件管理 + 知识管理
  8. 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