夜雨聆风
点蓝色字关注“拓普资源屋”
# OpenClaw（小龙虾）保姆级零基础安装教程
> 适用人群：完全零基础的小白用户，照着做就能装好
> 更新日期：2026年4月14日
> 适用系统：**Windows 10 / Windows 11**（64位）
## 📋 目录
1. [OpenClaw 是什么？](#一openclaw-是什么)
2. [你需要下载什么？（已帮你下好了）](#二你需要下载什么已帮你下好了)
3. [第一步：安装 Git](#三第一步安装-git)
4. [第二步：安装 Node.js](#四第二步安装-nodejs)
5. [第三步：验证环境](#五第三步验证环境)
6. [第四步：安装 OpenClaw](#六第四步安装-openclaw)
7. [第五步：初始化配置——接上 AI 大脑](#七第五步初始化配置接上-ai-大脑)
8. [第六步：启动并使用](#八第六步启动并使用)
9. [常见问题（装不上就看这里）](#九常见问题装不上就看这里)
10. [安全注意事项（必看）](#十安全注意事项必看)
## 一、OpenClaw 是什么？
OpenClaw（昵称"小龙虾"）是一款**完全开源的 AI 智能体框架**，GitHub 28万+ Star。
**通俗理解**：ChatGPT 只能"聊天"，OpenClaw 能"干活"——它可以：
- 📧 自动帮你收发邮件
- 📁 整理电脑上的文件、生成报告
- 🌐 自动操作浏览器网页
- 📊 抓取数据、生成图表
- 💬 接入 WhatsApp、Telegram、飞书等平台
- ⏰ 7×24 小时后台自动运行
**免费！完全免费！** 你只需要一个 AI 模型的 API Key（每月几块钱就够了）。
## 二、你需要下载什么？
先下载安装包二个（官方软件，放心下载）：OpenClaw 安装依赖它们
| `Git-2.53.0.2-64-bit-setup.exe`|
| `node-v24.14.1-x64.msi`|
下载地址：https://pan.quark.cn/s/2b7a76ec9727
## 三、第一步：安装 Git
### 3.1 双击安装, 如果弹出 "用户账户控制" 提示，点击 **"是"**
### 3.2 安装向导操作（小白保姆级安装Git教程，其他人略过）
**第 1 个弹窗：许可证协议**
- 点击 **"Next"**（下一步）
**第 2 个弹窗：选择安装路径**
- 默认路径是 `C:\Program Files\Git`，**不需要改**
- 点击 **"Next"**
**第 3 个弹窗：选择组件**
- 保持所有默认勾选不动
- 点击 **"Next"**
**第 4 个弹窗：开始菜单文件夹**
- 默认显示 "Git"，**不需要改**
- 点击 **"Next"**
**第 5 个弹窗：选择默认编辑器**
- 下拉菜单选 **"Use Vim (the ubiquitous text editor)"** 或 **"Use Visual Studio Code"**（如果你装了 VS Code 的话）
-**不影响使用，选哪个都行**
- 点击 **"Next"**
**第 6 个弹窗：调整 PATH 环境变量**
- ⭐ 这一步很关键！选择 **"Git from the command line and also from 3rd-party software"**（中间那个选项）
- 这会自动把 Git 加入系统环境变量
- 点击 **"Next"**
**第 7 个弹窗：选择 SSH 可执行文件**
- 保持默认 **"Use bundled OpenSSH"**
- 点击 **"Next"**
**第 8 个弹窗：选择 HTTPS 传输后端**
- 保持默认 **"Use the OpenSSL library"**
- 点击 **"Next"**
**第 9 个弹窗：配置行尾转换**
- 保持默认 **"Checkout Windows-style, commit Unix-style line endings"**
- 点击 **"Next"**
**第 10 个弹窗：配置终端模拟器**
- 保持默认 **"Use MinTTY"**
- 点击 **"Next"**
**第 11 个弹窗：git pull 默认行为**
- 保持默认 **"Default (fast-forward or merge)"**
- 点击 **"Next"**
**第 12 个弹窗：选择凭据管理器**
- 保持默认 **"Git Credential Manager"**
- 点击 **"Next"**
**第 13 个弹窗：额外选项**
- 保持默认勾选 **"Enable file system caching"** 和 **"Enable symbolic links"**
- 点击 **"Install"**
**等待安装...**
- 看到绿色进度条走完
**第 14 个弹窗：安装完成**
- 去掉 **"View Release Notes"** 的勾选（不需要看）
- 点击 **"Finish"**
✅ Git 安装完毕！
## 四、第二步：安装 Node.js
### 4.1 双击安装，如果弹出 "用户账户控制" 提示，点击 **"是"**
### 4.2 安装向导操作（小白保姆级安装Git教程，其他人略过）
**第 1 个弹窗：欢迎页面**
- 点击 **"Next"**
**第 2 个弹窗：接受许可证**
- 勾选 **"I accept the terms in the License Agreement"**
- 点击 **"Next"**
**第 3 个弹窗：选择安装路径**
- 默认路径是 `C:\Program Files\nodejs`，**不需要改**
- 点击 **"Next"**
**第 4 个弹窗：自定义安装组件**
- ⭐ 这一步注意！确保以下组件都**勾选**了：
- ✅ Node.js runtime
- ✅ npm package manager
- ✅ Online documentation shortcuts
- ✅ **Add to PATH**（⭐⭐⭐ 这个必须勾选！）
- 点击 **"Next"**
**第 5 个弹窗：Tools for Native Modules**
- 保持默认勾选 **"Automatically install the necessary tools..."**
- 点击 **"Next"**
**第 6 个弹窗：确认安装**
- 点击 **"Install"**
**等待安装...**
- 安装过程中会弹出一个黑色命令行窗口（安装 Python 和构建工具），**让它自己跑完就行**，不要关闭
- 这个过程大约需要 1-3 分钟
**第 7 个弹窗：安装完成**
- 点击 **"Finish"**
✅ Node.js 安装完毕！
## 五、第三步：验证环境
现在需要验证 Git 和 Node.js 都装好了。
### 5.1 打开 PowerShell
**方法一（推荐）**：
- 按键盘上的 **`Win + X`** 键（Win 键是键盘左下角带 Windows 图标的那个）
- 在弹出的菜单中选择 **"Windows PowerShell"** 或 **"终端"**
**方法二**：
- 按键盘 **`Win + R`** 键
- 输入 `powershell`
- 按回车
### 5.2 验证 Git
在 PowerShell 中输入以下命令并回车：
git --version
**预期输出**：
git version 2.53.0.windows.2
✅ 如果看到版本号，说明 Git 安装成功。
### 5.3 验证 Node.js
在 PowerShell 中输入以下命令并回车：
node --version
**预期输出**：
v24.14.1
✅ 如果看到版本号，说明 Node.js 安装成功。
### 5.4 验证 npm（Node.js 自带的包管理器）
npm --version
**预期输出**：类似 `10.x.x` 的版本号。
### 5.5 如果提示"不是内部或外部命令"
说明环境变量没有生效，**关闭所有 PowerShell 窗口，重新打开一个新的再试一次**。
如果还是不行，按照以下步骤手动添加：
1. 右键 "此电脑" → "属性"
2. 点击右侧 "高级系统设置"
3. 点击底部 "环境变量"
4. 在 "系统变量" 区域找到 `Path`，双击它
5. 确认以下路径在列表中（如果没有就点"新建"添加）：
-`C:\Program Files\Git\cmd`
-`C:\Program Files\nodejs`
6. 一路点 "确定" 关闭所有窗口
7.**重新打开 PowerShell** 再验证
## 六、第四步：安装 OpenClaw
### 6.1 运行安装命令
在 PowerShell 中粘贴以下命令并回车：
```powershell
npm install -g openclaw@latest
**过程说明**：
- 会显示一堆下载和安装信息
- 整个过程大约需要 1-3 分钟（取决于网速）
- 看到类似 `added xxx packages` 的提示就说明安装成功了
> 💡 如果下载很慢，可以先切换到国内镜像源：
> ```powershell
>npm config set registry https://registry.npmmirror.com/
> 然后再执行 `npm install -g openclaw@latest`
### 6.2 验证 OpenClaw 安装
openclaw --version
**预期输出**：类似 `2026.4.x` 的版本号。
✅ 如果看到版本号，说明 OpenClaw 安装成功！
## 七、第五步：初始化配置——接上 AI 大脑
OpenClaw 安装好了，但它需要一个 AI 大模型来"思考"。这一步就是给它接上大脑。
### 7.1 先去获取一个免费的 API Key
以下服务商都是国内的，注册免费，新用户都有免费额度：
| ⭐⭐⭐ | **DeepSeek** | https://platform.deepseek.com | 便宜，效果不错 |
| ⭐⭐ | **通义千问** | https://dashscope.console.aliyun.com | 阿里出品，新用户免费额度多 |
| ⭐⭐ | **硅基流动** | https://siliconflow.cn | 一次注册可用多种模型，有免费额度 |
**以 DeepSeek 为例，手把手教你注册**：
1. 浏览器打开 https://platform.deepseek.com
2. 点击右上角 **"注册"**
3. 用手机号注册并登录
4. 登录后，点击左侧菜单 **"API Keys"**
5. 点击右上角 **"创建 API Key"** 按钮
6. 随便起个名字（比如"openclaw"），点击确定
7.**立即复制**显示的 Key（格式像 `sk-xxxxxxxxxxxxxxxx`）
- ⚠️ **这个 Key 只会显示一次！关掉页面就再也看不到了！**
- 建议立即粘贴到记事本保存
8. 进入 **"充值"** 页面，充值 5-10 元即可（能用很久）
### 7.2 运行初始化向导
在 PowerShell 中执行：
```powershell
openclaw onboard --install-daemon
### 7.3 按向导提示操作
**提示 1：安全警告**
⚠️ OpenClaw will have access to files on your system...
Do you agree? (yes/no)
- 输入 `yes` 回车
**提示 2：选择 AI 模型提供商（Select Provider）**
- 用上下方向键选择你的服务商
- 选了 DeepSeek 就选 **"DeepSeek"**
- 按回车确认
**提示 3：输入 API Key**
Enter your API Key:
- 粘贴你刚才保存的 Key（右键粘贴，或 Ctrl+V）
- ⚠️ 粘贴时不会显示任何字符，这是正常的！直接回车就行
**提示 4：选择消息渠道**
- 新手选 **"Web"**（网页界面）即可
- 按回车确认
**提示 5：安装守护进程（Install daemon）**
- 输入 `yes`，让它开机自启动
- 按回车
✅ 配置完成！
## 八、第六步：启动并使用
### 8.1 启动 AI 网关（核心服务）
powershell
openclaw gateway
看到类似以下输出说明服务启动成功：
🦞 OpenClaw Gateway running on http://localhost:xxxx
**不要关闭这个窗口！** 这个窗口保持开着就是 AI 在工作。
### 8.2 打开 Web 管理面板
**新开一个** PowerShell 窗口，执行：
```powershell
openclaw dashboard
浏览器会自动打开管理面板，你可以：
- 在这里和 AI 对话
- 安装插件（Skills）
- 配置消息渠道
- 查看运行状态
### 8.3 开始使用
现在你可以直接在 Web 界面里跟小龙虾对话了！试试跟它说：
> "帮我整理一下桌面上的文件"
> "帮我写一份本周工作周报"
> "帮我查看今天的天气"
## 九、常见问题（装不上就看这里）
### ❓ Q1：npm install 报错 "sharp" 相关错误
这是图像处理库编译失败，执行：
```powershell
$env:SHARP_IGNORE_GLOBAL_LIBVIPS="1"; npm install -g openclaw@latest
### ❓ Q2：提示 "openclaw: command not found" 或 "不是内部或外部命令"
**原因**：npm 全局路径没加入 PATH。
**解决**：
1. 在 PowerShell 中执行：
```powershell
npm prefix -g
2. 记下输出的路径（类似 `C:\Users\你的用户名\AppData\Roaming\npm`）
3. 按 [第五步 5.5 节](#55-如果提示不是内部或外部命令) 的方法，把这个路径添加到系统 PATH 中
4. 重新打开 PowerShell
### ❓ Q3：安装脚本 / npm 下载非常慢
切换到国内镜像源：
```powershell
npm config set registry https://registry.npmmirror.com/
想恢复官方源：
```powershell
npm config set registry https://registry.npmjs.org/
### ❓ Q4：初始化向导中选错了模型 / API Key 填错了怎么办？
重新运行向导：
```powershell
openclaw onboard --install-daemon
或者直接编辑配置文件 `C:\Users\你的用户名\.openclaw\openclaw.json`，修改其中的 API Key
### ❓ Q5：如何更新 OpenClaw 到最新版本？
```powershell
npm install -g openclaw@latest
openclaw gateway restart
### ❓ Q6：gateway 启动失败怎么办？
运行诊断：
```powershell
openclaw doctor
它会自动检查并提示哪里有问题。
### ❓ Q7：Windows 防火墙弹窗提示
第一次运行 `openclaw gateway` 时，Windows 可能弹出防火墙提示，点击 **"允许访问"**。
## 十、安全注意事项（必看）
⚠️ OpenClaw 能访问你电脑上的所有文件，请务必注意安全！
### 10.1 必做安全配置
**① 设置网关认证密码**（防止别人远程控制你的电脑）
编辑配置文件 `C:\Users\你的用户名\.openclaw\openclaw.json`，在文件中添加：
```json{"gateway": {"auth": { "mode": "token","token": "你自己设一个复杂密码"}}}```
**② 设置每日花费上限**（防止 AI 疯狂烧钱）
同样在配置文件中添加：
```json{ "agents": { "defaults": { "budget": {"maxTokensPerDay": 500000,"maxCostPerDay": 5.00 } } }}
```
> 每天最多花 5 块钱，对新手来说绝对够用了。
### 10.2 安全规则
| 规则 | 说明 |
|------|------|
| 🔒 **保护 API Key** | 绝对不要把 Key 发到聊天群、论坛等公开场合 |
| 🛡️ **只用官方包名** | npm 安装时包名必须是 `openclaw`，**拒绝**`@openclaw-ai/openclawai` 等变体（恶意软件！） |
| 🔍 **谨慎安装第三方插件** | 安装 Skill 前查看它的源码和评价 |
| 📁 **敏感文件隔离** | 不要把密码、密钥等敏感信息放在 AI 能访问的文件夹里 |
## 📋 常用命令速查表
| 命令 | 用途 | 什么时候用 |
|------|------|-----------|
| `openclaw --version` | 查看版本号 | 确认安装成功 |
| `openclaw doctor` | 全面环境诊断 | 出问题了排查用 |
| `openclaw onboard` | 初始化配置向导 | 第一次使用 / 重新配置 |
| `openclaw gateway` | 启动 AI 核心服务 | 每次使用前启动 |
| `openclaw gateway status` | 查看服务是否在运行 | 检查状态 |
| `openclaw gateway restart` | 重启服务 | 更新后 / 出问题时 |
| `openclaw dashboard` | 打开 Web 管理面板 | 想用网页界面时 |
| `openclaw health` | 健康检查 | 检查一切是否正常 |
| `openclaw backup create` | 创建备份 | 定期备份配置 |
| `openclaw skills list` | 查看已安装的扩展 | 管理插件 |
| `openclaw skills search "关键词"` | 搜索扩展 | 发现新功能 |
| `npm install -g openclaw@latest` | 更新到最新版 | 有新版本时 |
🦞 恭喜！到这里你就已经完成了 OpenClaw 小龙虾的全部安装和配置，开始享受 AI 助手带来的便利吧！
🦞 如果你还不会，请留言发表你的看法........
🦞做好人做到家吧，再附你高清版安装教程，请下载：
下载地址：
https://pan.quark.cn/s/0203788eb039
参考资源: 如有违反版权，请告知删除！
| OpenClaw 官方文档（中文）
| OpenClaw 中国社区 |
| GitHub 仓库 |
| Gitee 国内镜像 |
| Node.js 中文网 |
| DeepSeek 开放平台 |
| 通义千问控制台 |
| 硅基流动 |
