一、部署前准备（Homebrew + Node.js）

OpenClaw 官方要求 Node.js ≥ 22。
如果你还没装 Homebrew 或 Node，可按下面步骤来：

1. 安装 Homebrew（已安装可跳过）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 使用 Homebrew 安装 Node.js

brew install node
node -v

确保版本 ≥ 22。

二、安装 OpenClaw（推荐方式）

官方推荐使用安装脚本，它会自动检测并完成安装：

curl -fsSL https://openclaw.ai/install.sh | bash

三、运行首次引导（Onboarding Wizard）

官方推荐使用 CLI 向导完成网关、模型、工作区与频道的初始化配置：

openclaw onboard --install-daemon

这个向导会完成：

• 模型与认证配置
• 工作区（默认 ~/.openclaw/workspace）
• Gateway 端口（默认 18789）
• 网关服务（macOS 为 LaunchAgent）
• 频道与技能初始化（可选）

四、检查网关是否运行

openclaw gateway status

如果状态正常，说明网关已启动。

五、打开控制台 UI（最快验证方式）

无需配置任何聊天渠道，就可以直接访问控制台 UI 进行测试：

openclaw dashboard

默认会打开：

http://127.0.0.1:18789/

进入后即可直接和 OpenClaw 交互。

六、常用启动与调试命令

openclaw gateway --port 18789     # 前台运行网关
openclaw logs --follow            # 查看日志
openclaw health                   # 健康检查

七、配置文件位置与编辑方式

配置文件默认路径：

~/.openclaw/openclaw.json

可使用 CLI 修改：

openclaw config get agents.defaults.workspace
openclaw config set agents.defaults.heartbeat.every "2h"

也可直接编辑 JSON5 文件（修改后通常会热加载）。

八、macOS App（可选）

如果你想使用 菜单栏 App + 本地权限能力（麦克风/屏幕/通知/Canvas/系统命令），可安装 macOS App。它能：

• 管理权限
• 代理 Gateway 启动
• 提供系统级节点能力（如 system.run）

但 macOS App 并非必需，CLI + Gateway 即可使用。

九、更新与升级

OpenClaw 更新非常快，官方推荐 重新执行安装脚本升级：

curl -fsSL https://openclaw.ai/install.sh | bash

如果你使用的是 npm/pnpm 全局安装，也可直接更新：

npm i -g openclaw@latest
# 或
pnpm add -g openclaw@latest

十、修复与排错（必会）

官方提供 openclaw doctor 用于配置迁移、修复与检测：

openclaw doctor

常见用途：

• 修复旧配置
• 修复服务安装
• 检测风险 DM 配置
• 迁移旧状态目录
• 检查网关服务健康

十一、一些 macOS 注意事项

• 不要把 ~/.openclaw 放在 iCloud 或同步目录中，避免锁冲突与性能问题。
• 如果你启用了 LaunchAgent，可以用 launchctl 管理服务：

launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway

十二、部署完成后你将拥有

✅ 本地 Gateway
✅ 可用的 Web 控制台
✅ 多模型能力
✅ 频道扩展能力
✅ 可选 macOS 本地节点能力

总结

如果你在 macOS 上部署个人 AI 助手，OpenClaw 是当前非常完整的一套方案。
建议流程：

1. Homebrew 安装 Node（确保 ≥ 22）
2. 安装脚本
3. openclaw onboard --install-daemon
4. openclaw gateway status
5. openclaw dashboard
6. 后续通过 openclaw doctor + openclaw update 维护

参考资料

[1]: OpenClaw GitHub 项目说明（安装与 quick start）
[2]: Getting Started（快速安装与 Dashboard）
[3]: Onboarding Wizard（CLI 向导）

下一篇 OpenClaw 部署实战系列四(openclaw 配置群晖插件)