作者：小李Code

OpenClaw 是一个开源的 AI 个人助手框架，可以接入多种 LLM 模型和消息渠道（Telegram、WhatsApp、Discord、Signal 等），让 AI 助手真正融入你的日常工作和生活。本文将手把手带你完成 OpenClaw 在 macOS 上的安装和初始配置。

---

一、环境要求

项目	要求
操作系统	macOS（Intel / Apple Silicon 均可）
Node.js	v24（推荐） 或 v22.16+（最低支持）
Git	需要安装

先检查一下当前环境：

node -v
git --version

如果没有安装 Node.js 或版本过低，参考下一节。

---

二、安装 Node.js

方式一：Homebrew（推荐）

如果你已经装了 Homebrew，直接一行搞定：

brew install node

方式二：nvm（版本管理器）

更灵活，可以切换多个 Node 版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install 24
nvm use 24

方式三：官方安装包

前往 nodejs.org 下载 macOS 安装包，双击安装即可。

安装完成后验证：

node -v    # 应输出 v24.x.x 或更高
npm -v     # 确认 npm 也一起安装了

---

三、安装 OpenClaw

方式一：一键安装脚本（推荐 🚀）

这是最简单的方式，脚本会自动检测并安装 Node.js、Git 和 OpenClaw：

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

脚本会依次完成：

1. 检测系统环境
2. 安装 Node.js（如果缺失）
3. 安装 Git（如果缺失）
4. 通过 npm 全局安装 OpenClaw
5. 自动启动引导向导（onboarding wizard）

💡 如果只想安装不运行引导向导，加上 --no-onboard 参数：

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

方式二：npm 手动安装

如果你已经配好了 Node.js，可以直接用 npm：

npm install -g openclaw@latest

然后运行引导向导：

openclaw onboard --install-daemon

⚠️ 遇到 sharp 构建错误？ 如果你用 Homebrew 装了全局 libvips，可以试试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方式三：从源码构建

适合想参与贡献的开发者：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

---

四、运行引导向导

安装完成后，执行引导向导来完成初始配置：

openclaw onboard --install-daemon

向导会引导你完成：

• AI 模型配置 — 选择并配置你的 LLM 提供商（OpenAI、Anthropic、Google 等）
• 网关设置 — Gateway 是 OpenClaw 的核心服务，处理所有消息路由
• 消息渠道（可选） — 接入 Telegram、WhatsApp、Discord 等聊天平台
• 守护进程安装 — --install-daemon 会让 Gateway 作为后台服务自动运行

---

五、验证安装

安装完成后，用以下命令确认一切正常：

# 检查配置是否正确
openclaw doctor

# 查看 Gateway 状态（应该显示 running）
openclaw gateway status

# 打开浏览器控制面板
openclaw dashboard

openclaw dashboard 会打开浏览器访问 http://127.0.0.1:18789/，这就是 OpenClaw 的 Web 控制面板。如果你看到页面正常加载，恭喜，安装成功！🎉

---

六、常用命令速查

命令	说明
openclaw doctor	检查配置问题
openclaw status	查看整体状态
openclaw gateway status	Gateway 服务状态
openclaw gateway start	启动 Gateway
openclaw gateway stop	停止 Gateway
openclaw gateway restart	重启 Gateway
openclaw dashboard	打开 Web 控制面板
openclaw help	查看帮助信息

---

七、常见问题排查

1. openclaw: command not found

通常是 npm 全局 bin 目录不在 PATH 中。修复方法：

# 查看全局 npm 前缀
npm prefix -g

# 将其 bin 目录加入 PATH（加到 ~/.zshrc）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. Gateway 启动失败

# 查看详细日志
openclaw gateway status

# 检查配置
openclaw doctor

3. 更新 OpenClaw

npm install -g openclaw@latest
openclaw gateway restart

4. 卸载 OpenClaw

npm uninstall -g openclaw
rm -rf ~/.openclaw

---

八、接下来做什么？

安装完成后，你可以：

1. 配置消息渠道 — 在 Control UI 中接入你的 Telegram、WhatsApp、Discord 等
2. 添加技能（Skills） — 前往 ClawHub 浏览和安装扩展技能
3. 连接手机 — 下载 OpenClaw companion app（iOS/Android），通过二维码配对
4. 设置自动化 — 用 cron 定时任务和心跳检查实现主动提醒

---

参考链接

• 📖 官方文档：docs.openclaw.ai
• 💻 GitHub 仓库：github.com/openclaw/openclaw
• 💬 社区 Discord：discord.com/invite/clawd
• 🔧 技能市场：clawhub.com

---

本文基于 OpenClaw 最新版本编写，如有更新请以官方文档为准。