# 🍎 OpenClaw macOS 安装教程｜保姆级图文指南

> Mac 用户的福音！手把手教你安装 OpenClaw！

---

## 📌 什么是 OpenClaw？

OpenClaw 是一款**AI Agent 运行平台**，让你的 AI 助手真正帮你做事：
- ✅ 写代码、改 Bug
- ✅ 生成文档、PPT、网页
- ✅ 数据分析、可视化
- ✅ 自动化工作流
- ✅ 多渠道沟通（飞书、微信、Discord等）

**简单说：不是聊天机器人，是真正的工作伙伴！**

---

## 📋 安装前准备

### 1️⃣ 系统要求
- macOS 11 (Big Sur) 或更高版本
- 至少 4GB 内存
- 网络连接

### 2️⃣ 必备软件

| 软件 | 版本要求 | 安装方式 |
|------|---------|---------|
| Node.js | ≥ 22.0.0 | Homebrew / 官网下载 |
| npm | 随 Node.js 安装 | - |
| Git | 最新版 | Xcode Command Line Tools |

---

## 🔧 详细安装步骤

### 步骤1：安装 Homebrew（5分钟）

**Homebrew 是 Mac 的包管理器，强烈推荐安装！**

**[图1：Terminal 打开方式]**
- 按 `Cmd + Space`，输入 "Terminal"
- 回车打开终端

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

# 按提示操作，等待安装完成
```

**验证安装**：
```bash
brew --version
# 输出示例：Homebrew 4.2.0
```

---

### 步骤2：安装 Node.js（3分钟）

**方法A：使用 Homebrew（推荐）**
```bash
# 安装 Node.js
brew install node@22

# 验证安装
node --version
# 输出示例：v22.12.0

npm --version
# 输出示例：10.9.0
```

**方法B：官网下载**
- 访问：https://nodejs.org
- 下载 macOS 安装包
- 双击安装

---

### 步骤3：安装 Git（2分钟）

**Mac 通常自带 Git，检查一下：**

```bash
git --version
# 如果输出版本号，说明已安装
# 如果提示安装，按提示安装 Xcode Command Line Tools
```

**如果没有安装：**
```bash
# 使用 Homebrew 安装
brew install git
```

---

### 步骤4：配置 Git（重要！）

**⚠️ 这一步很关键，避免安装失败！**

```bash
# 配置 Git 使用 HTTPS（解决 SSH 权限问题）
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:

# 配置 GitHub 镜像加速（解决网络问题）
git config --global url."https://ghproxy.com/https://github.com/".insteadOf https://github.com/
```

---

### 步骤5：安装 OpenClaw（3分钟）

**[图2：Terminal 安装界面]**

```bash
# 清理缓存
npm cache clean --force

# 安装 OpenClaw
npm install -g openclaw@latest

# 等待安装完成...
```

**验证安装**：
```bash
openclaw --version
# 输出示例：2026.2.25
```

---

### 步骤6：初始化配置（2分钟）

**[图3：OpenClaw 配置界面]**

```bash
# 运行配置向导
openclaw onboard

# 按提示操作：
# 1. 选择 AI 模型提供商
# 2. 输入 API Key
# 3. 选择默认模型
# 4. 配置完成！
```

---

### 步骤7：启动服务（1分钟）

```bash
# 启动 Gateway 服务
openclaw gateway

# 看到 "Gateway running" 就成功了！
```

**[图4：浏览器打开控制台]**

```bash
# 打开控制台
# 浏览器访问：http://localhost:18789
```

---

## 🎉 安装完成！

### 快速测试

```bash
# 发送消息测试
openclaw agent --message "你好"

# 或者直接在浏览器控制台对话
```

---

## 🍎 Mac 专属技巧

### 1️⃣ 设置开机自启

```bash
# 创建 LaunchAgent（可选）
# 让 OpenClaw 在登录时自动启动
```

### 2️⃣ 使用 Alfred Workflow

- 创建 Alfred Workflow 快速调用 OpenClaw
- 设置快捷键一键唤醒

### 3️⃣ 配置 Shell 别名

```bash
# 编辑 ~/.zshrc
echo 'alias oc="openclaw"' >> ~/.zshrc
source ~/.zshrc

# 现在可以用 oc 代替 openclaw
oc --version
```

---

## ❓ 常见问题

### Q1：安装失败，提示权限不足？
**A：** 使用 `sudo` 提权：
```bash
sudo npm install -g openclaw@latest
```

### Q2：安装很慢/卡住？
**A：** 
- 方法1：使用 VPN/代理
- 方法2：配置淘宝镜像
```bash
npm config set registry https://registry.npmmirror.com
```

### Q3：提示找不到命令？
**A：** 
- 检查 npm 全局路径：
```bash
npm config get prefix
# 确保 /usr/local/bin 在 PATH 中
echo $PATH
```

### Q4：M1/M2/M3 芯片兼容？
**A：** 完全兼容！OpenClaw 支持 Apple Silicon。

---

## 🔗 官方资源

- 📖 官方文档：https://docs.openclaw.ai
- 🐙 GitHub：https://github.com/openclaw/openclaw
- 💬 Discord：https://discord.gg/clawd
- 🛒 Skills 市场：https://clawhub.com

---

## 💡 使用技巧

1. **定时任务**：每天自动提醒、检查工作
2. **多渠道**：配置飞书、微信，随时随地使用
3. **记忆系统**：AI 记住你的偏好和习惯
4. **Skills 扩展**：安装更多技能包

---

## 📸 配图说明

**封面图**：
- 大标题：OpenClaw macOS 安装教程
- 副标题：保姆级图文指南
- 配图：OpenClaw Logo + Apple Logo

**步骤图**：
- 每个步骤配一张截图
- 关键位置用红框标注
- 添加步骤编号

**完成图**：
- 显示成功界面
- 添加"安装成功"标签

---

## 🆚 Windows vs Mac 对比

| 项目 | Windows | macOS |
|------|---------|-------|
| 包管理器 | 无（需手动下载） | Homebrew（推荐） |
| 终端 | PowerShell | Terminal |
| 权限 | 管理员权限 | sudo 提权 |
| 路径分隔符 | `\` | `/` |
| 开机自启 | 任务计划程序 | LaunchAgent |

---

#OpenClaw #AI助手 #macOS教程 #Mac教程 #效率工具 #程序员必备 #Nodejs #开发工具 #人工智能 #苹果电脑

---

_作者：二蛋 | 发布时间：2026年3月11日_