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

> 从零开始，手把手教你安装 OpenClaw，小白也能轻松搞定！

---

## 前言

姐妹们，兄弟们！今天给大家分享一款超级好用的 AI 助手——**OpenClaw**！

之前一直想找个真正能帮干活的 AI，不是那种只会聊天的机器人，而是能帮我写代码、做文档、分析数据的工作伙伴。试了好多工具，最后发现 OpenClaw 是最符合需求的！

但是！安装过程真的有点坑，网上教程要么太简略，要么太专业，对新手很不友好。我折腾了好久才搞定，所以决定写一篇**超级详细**的安装教程，分享给大家！

这篇教程适合：
- ✅ 零基础小白
- ✅ 想要快速上手的开发者
- ✅ 对 AI 工具感兴趣的任何人

准备好了吗？我们开始吧！🚀

---

## 一、什么是 OpenClaw？

在开始安装之前，先来了解一下 OpenClaw 是什么。

**简单说**：OpenClaw 是一个 AI Agent 运行平台，让你的 AI 助手真正帮你做事。

**它和普通聊天机器人有什么区别？**

| 功能 | 普通聊天机器人 | OpenClaw |
|------|--------------|----------|
| 写代码 | 只能给出示例 | 真正帮你写、改、测试 |
| 文档生成 | 只能给你文字 | 直接生成 PPT、Word、HTML |
| 数据分析 | 只能解释数据 | 直接处理、分析、可视化 |
| 工作流 | 只能建议 | 自动化执行 |

**核心功能**：

### 1️⃣ 代码开发
- 🖥️ 生成代码、模板、配置文件
- 🐛 分析错误、定位 Bug、提供修复方案
- 🔄 代码重构、优化结构
- 🚀 项目初始化、环境配置

### 2️⃣ 文档处理
- 📝 生成 PPT、Word、Markdown、HTML
- 📊 内容摘要、会议纪要
- 🔄 格式转换
- ✍️ 文案撰写、报告生成

### 3️⃣ 数据分析
- 📈 数据可视化（图表、报表）
- 🔍 数据清洗、格式化、分析
- 📊 自动化数据报告

### 4️⃣ 自动化
- ⏰ 定时任务（提醒、检查、报告）
- 🔄 工作流自动化
- 📡 系统监控、异常告警

### 5️⃣ 多渠道沟通
- 💬 飞书、微信、Discord、Telegram
- 🔄 统一消息管理
- 👥 群聊智能助手

### 6️⃣ 知识管理
- 📚 记忆系统、知识库
- 🧠 智能问答
- 📖 文档集成（飞书、Notion、Wiki）

---

## 二、安装前准备

在安装 OpenClaw 之前，需要先准备一些基础软件。

### 2.1 系统要求

| 系统 | 版本要求 |
|------|---------|
| Windows | 10/11（64位） |
| macOS | 11 (Big Sur) 及以上 |
| 内存 | 至少 4GB |
| 存储 | 至少 2GB 可用空间 |

### 2.2 必备软件

#### Node.js（必需）

**作用**：OpenClaw 是基于 Node.js 开发的，必须先安装 Node.js

**版本要求**：≥ 22.0.0

**下载地址**：https://nodejs.org

**安装步骤**：
1. 访问 Node.js 官网
2. 选择 **LTS 版本**（长期支持版，更稳定）
3. 下载后双击安装包
4. **全部默认下一步**即可
5. 安装完成后重启电脑

**验证安装**：
```powershell
# 打开终端（Windows: PowerShell，Mac: Terminal）
node --version

# 输出示例：v22.12.0
# 只要显示版本号，就说明安装成功！
```

---

#### npm（随 Node.js 安装）

**作用**：Node.js 的包管理器，用于安装 OpenClaw

**验证安装**：
```powershell
npm --version

# 输出示例：10.9.0
# npm 会随 Node.js 自动安装，不需要单独安装
```

---

#### Git（必需）

**作用**：OpenClaw 的一些依赖需要从 GitHub 下载

**下载地址**：https://git-scm.com

**安装步骤**：
1. 访问 Git 官网
2. 根据你的系统选择对应版本
3. 下载后双击安装包
4. **全部默认下一步**即可

**验证安装**：
```powershell
git --version

# 输出示例：git version 2.43.0
```

**Mac 用户注意**：
Mac 通常自带 Git，输入 `git --version` 检查即可。如果没有，会提示安装 Xcode Command Line Tools，按提示安装即可。

---

### 2.3 网络准备

由于 OpenClaw 的一些依赖在 GitHub 上，国内访问可能会比较慢或失败。

**建议准备**：
- ✅ VPN 或代理（推荐）
- ✅ 或者按后面的教程配置镜像加速

---

## 三、Windows 安装教程

### 步骤1：打开 PowerShell

**方法**：
1. 按 `Win + X`
2. 选择 **"Windows PowerShell (管理员)"**
3. 或者在开始菜单搜索 "PowerShell"，右键选择"以管理员身份运行"

**注意**：一定要以**管理员身份**运行！

---

### 步骤2：验证环境

```powershell
# 检查 Node.js
node --version

# 检查 npm
npm --version

# 检查 Git
git --version
```

如果都能显示版本号，说明环境准备好了！

---

### 步骤3：配置 Git（关键步骤！）⚠️

这一步非常重要！不配置的话，安装过程中会报错！

**复制以下命令，逐行执行**：

```powershell
# 配置 Git 使用 HTTPS 而不是 SSH
git config --global url."https://github.com/".insteadOf ssh://git@github.com/

# 配置 Git 替代 SSH 格式
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/
```

**作用说明**：
- 前两条：解决 SSH 权限问题
- 第三条：加速 GitHub 访问

---

### 步骤4：清理缓存

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

---

### 步骤5：安装 OpenClaw

```powershell
# 安装 OpenClaw（这一步可能需要 3-5 分钟）
npm install -g openclaw@latest
```

**等待安装完成...**

看到进度条走完，没有报错，就说明安装成功了！

---

### 步骤6：验证安装

```powershell
# 检查 OpenClaw 是否安装成功
openclaw --version

# 输出示例：2026.2.25
```

看到版本号，恭喜你安装成功！🎉

---

### 步骤7：初始化配置

第一次使用需要配置 AI 模型：

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

**按提示操作**：
1. 选择 AI 模型提供商（如 OpenAI、Claude、本地模型等）
2. 输入你的 API Key
3. 选择默认模型
4. 确认配置

---

### 步骤8：启动服务

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

看到 **"Gateway running"** 或类似提示，说明服务启动成功！

---

### 步骤9：打开控制台

打开浏览器，访问：
```
http://localhost:18789
```

看到 OpenClaw 的控制台界面，就可以开始使用了！🎉

---

## 四、macOS 安装教程

Mac 用户推荐使用 **Homebrew** 安装，更方便！

### 步骤1：安装 Homebrew（如果还没有）

```bash
# 打开 Terminal（终端）
# 按 Cmd + Space，搜索 "Terminal"

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

安装过程可能需要几分钟，按提示操作即可。

---

### 步骤2：安装 Node.js

```bash
# 使用 Homebrew 安装 Node.js 22
brew install node@22

# 验证安装
node --version
npm --version
```

---

### 步骤3：检查 Git

```bash
# Mac 通常自带 Git
git --version

# 如果没有，会提示安装 Xcode Command Line Tools
# 按提示安装即可
```

---

### 步骤4：配置 Git（与 Windows 相同）

```bash
# 配置 Git 使用 HTTPS
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

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

# 安装 OpenClaw
npm install -g openclaw@latest
```

---

### 步骤6：后续步骤

后续步骤与 Windows 完全相同：
1. 验证安装：`openclaw --version`
2. 初始化配置：`openclaw onboard`
3. 启动服务：`openclaw gateway`
4. 打开控制台：`http://localhost:18789`

---

## 五、常见问题解决

### ❓ 问题1：安装失败，提示 Git 错误

**错误信息**：
```
npm error command git --no-replace-objects ls-remote ssh://git@github.com/...
npm error git@github.com: Permission denied (publickey).
```

**解决方案**：
执行步骤3的 Git 配置命令：
```powershell
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:
```

然后重新安装：
```powershell
npm install -g openclaw@latest
```

---

### ❓ 问题2：安装很慢或卡住

**原因**：网络问题，GitHub 访问慢

**解决方案A：使用镜像加速**
```powershell
# 配置 GitHub 镜像
git config --global url."https://ghproxy.com/https://github.com/".insteadOf https://github.com/

# 重新安装
npm install -g openclaw@latest
```

**解决方案B：配置淘宝 npm 镜像**
```powershell
# 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 安装
npm install -g openclaw@latest

# 安装完成后切回官方源
npm config set registry https://registry.npmjs.org
```

**解决方案C：使用 VPN/代理**
开启 VPN 或代理后重新安装

---

### ❓ 问题3：提示权限不足

**Windows 解决方案**：
以管理员身份运行 PowerShell

**Mac 解决方案**：
使用 sudo 提权：
```bash
sudo npm install -g openclaw@latest
```

---

### ❓ 问题4：找不到 openclaw 命令

**解决方案**：

**方法1：重启终端**
关闭终端重新打开

**方法2：检查 PATH**
```powershell
# 查看 npm 全局安装路径
npm config get prefix

# 确保该路径在 PATH 环境变量中
# Windows: 系统属性 → 环境变量 → Path → 编辑
# Mac: echo $PATH
```

---

### ❓ 问题5：Gateway 启动失败

**解决方案**：

**检查端口占用**：
```powershell
# Windows
netstat -ano | findstr :18789

# Mac
lsof -i :18789
```

**查看详细日志**：
```powershell
openclaw logs --follow
```

---

## 六、快速上手

安装完成后，如何快速上手？

### 1️⃣ 命令行对话

```powershell
# 直接在终端对话
openclaw agent --message "你好，帮我写一个 Python 的 Hello World"
```

### 2️⃣ 浏览器控制台

打开 `http://localhost:18789`，在控制台中对话

### 3️⃣ 配置多渠道

```powershell
# 配置飞书
openclaw configure --section channels

# 配置微信
openclaw configure --section channels
```

### 4️⃣ 安装 Skills

```powershell
# 查看可用 Skills
openclaw skills list

# 安装 Skill
openclaw skills install github
```

---

## 七、进阶使用

### 定时任务

```powershell
# 添加定时任务
openclaw cron add --name "每日提醒" --schedule "0 9 * * *" --message "早上好！今天的工作安排..."
```

### 记忆系统

OpenClaw 有记忆功能，会记住你的偏好和习惯：

- 📝 长期记忆：`MEMORY.md`
- 📅 短期记忆：`memory/YYYY-MM-DD.md`

### Skills 扩展

在 ClawHub 可以找到更多 Skills：
- 🐙 github - GitHub 操作
- 📝 summarize - 内容摘要
- 📧 himalaya - 邮件管理
- 📝 notion - Notion 集成

访问：https://clawhub.com

---

## 八、官方资源

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

---

## 九、总结

OpenClaw 是一款非常强大的 AI Agent 平台，安装过程虽然有点复杂，但按照这篇教程一步步操作，应该能顺利安装成功！

**安装要点回顾**：
1. ✅ 安装 Node.js 22+
2. ✅ 安装 Git
3. ⚠️ **配置 Git**（关键步骤！）
4. ✅ 安装 OpenClaw
5. ✅ 初始化配置
6. ✅ 启动服务

**遇到问题怎么办？**
- 检查 Node.js、npm、Git 版本
- 确保 Git 配置正确
- 尝试使用镜像加速
- 查看官方文档或社区求助

---

## 十、写在最后

这篇教程写了好久，希望能帮到大家！

如果觉得有用，记得：
- 👍 点赞
- ⭐ 收藏
- 💬 评论
- 🔄 分享

有问题欢迎在评论区留言，我看到会回复的！

也欢迎加入 OpenClaw 社区，一起交流学习！

---

**话题标签**：
#OpenClaw #AI助手 #安装教程 #效率工具 #程序员必备 #Nodejs #开发工具 #人工智能 #科技好物 #效率神器 #编程学习 #开发环境 #技术分享 #互联网工具 #生产力工具

---

_作者：二蛋_
_发布时间：2026年3月12日_
_教程版本：v1.0_