# openclaw-project

**Repository Path**: jockerzo/openclaw-project

## Basic Information

- **Project Name**: openclaw-project
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw Windows 一键安装工具

> 基于 CSDN 官方教程和 [openclaw-windows-installer](https://gitee.com/jockerzo/openclaw-windows-installer) 项目特性  
> **版本**: v8.2  
> **状态**: ✅ 完成

---

## 🚀 快速开始

### 方式 1：一键安装（推荐）

```cmd
# 1. 下载项目
# 2. 双击运行
one_click_install.bat
```

**特点**：
- ✅ 自动检测并安装 Node.js
- ✅ 配置国内镜像加速
- ✅ 一键安装所有依赖
- ✅ 创建桌面快捷方式
- ✅ 无需手动配置

### 方式 2：交互式安装

```cmd
# 运行完整安装配置工具
install_and_configure.bat
```

**特点**：
- ✅ 图形化菜单
- ✅ 分步骤引导
- ✅ 支持 Ollama 配置

### 方式 3：Go 程序

```cmd
# 运行 Go 编译的程序
cd skyclaw-go\bin
openclaw-toolkit.exe
```

**特点**：
- ✅ 独立可执行文件
- ✅ 跨平台支持
- ✅ 性能优秀

---

## 📦 安装模式

### 模式 1：一键安装（推荐）

**适合人群**：所有用户

**功能**：
- ✅ 自动检测 Node.js 安装
- ✅ 配置 npm 淘宝镜像
- ✅ 安装 pnpm 包管理器
- ✅ 安装 OpenClaw 最新版本
- ✅ 创建桌面快捷方式
- ✅ 自动验证安装

**预计时间**：5-10 分钟

### 模式 2：快速安装

**适合人群**：已安装 Node.js 的用户

**功能**：
- ✅ 仅安装 OpenClaw
- ✅ 配置 npm 镜像
- ✅ 快速验证

**预计时间**：2-3 分钟

### 模式 3：离线安装

**适合人群**：无网络环境

**功能**：
- ✅ 使用本地离线包
- ✅ 无需联网下载

**需要文件**：
- `node-v22.11.0-win-x64.zip`
- `pnpm_offline.tgz`
- `openclaw_offline.tgz`

---

## 🛠️ 特性

### 核心特性

- ✅ **一体化安装** - Node.js + pnpm + OpenClaw 全部集成
- ✅ **国内镜像** - 预配置 npm 淘宝镜像，下载飞快
- ✅ **离线支持** - 支持离线安装模式
- ✅ **自动配置** - 环境变量、快捷方式自动创建
- ✅ **配置向导** - 安装后自动启动交互式配置
- ✅ **一键初始化** - 自动配置 Token、API 等

### 增强功能

- ✅ **管理员权限检测** - 自动检测并提示
- ✅ **安装日志** - 完整记录安装过程
- ✅ **卸载功能** - 支持完全卸载
- ✅ **状态检查** - 实时检查安装状态
- ✅ **桌面快捷方式** - 一键启动 Gateway

---

## 📁 项目结构

```
openclaw-project/
├── 📖 文档/
│   ├── DELIVERY.md                 - 项目交付说明
│   ├── INDEX.md                    - 资源索引
│   ├── QUICK_START.md              - 快速入门
│   ├── README.md                   - 本文件
│   ├── README_COMPLETE_GUIDE.md    - 完整安装指南
│   ├── WINDOWS_INSTALL_FIX_GUIDE.md - 修复指南
│   ├── ONBOARD_FIX_GUIDE.md        - 配置向导修复
│   └── START_HERE.md               - 快速开始
│
├── 🛠️ 安装工具/
│   ├── one_click_install.bat       ⭐ 一键安装工具
│   ├── install_and_configure.bat   完整安装配置工具
│   ├── quick_start_gateway.bat     Gateway 快速启动
│   └── start_dashboard.bat         Dashboard 快速启动
│
├── 💻 Go 程序/
│   └── skyclaw-go/
│       ├── cmd/skyclaw/main.go     Go 源代码
│       ├── go.mod                  Go 模块配置
│       └── bin/
│           └── openclaw-toolkit.exe Go 可执行程序
│
└── .gitignore                      Git 忽略配置
```

---

## 🎯 安装流程

### 步骤 1：运行安装工具

```cmd
# 双击运行
one_click_install.bat

# 或选择 [1] 一键安装 OpenClaw
```

### 步骤 2：等待安装完成

安装过程：
1. 检查 Node.js 安装
2. 配置 npm 镜像
3. 安装 pnpm
4. 安装 OpenClaw
5. 验证安装
6. 创建桌面快捷方式

### 步骤 3：配置 OpenClaw

```cmd
# 打开新的 CMD 窗口
openclaw onboard --install-daemon
```

**配置向导操作**：
1. 使用方向键选择选项
2. 按空格键确认（出现 [x]）
3. 按回车键提交

### 步骤 4：启动 Gateway

**方式 1**：双击桌面上的「OpenClaw Gateway」快捷方式

**方式 2**：
```cmd
openclaw gateway run
```

### 步骤 5：访问 Dashboard

```cmd
# 打开新窗口
openclaw dashboard

# 或手动访问浏览器
http://127.0.0.1:18789
```

---

## 🔧 自定义配置

### 修改 npm 镜像源

编辑 `config/.npmrc`（如果需要）：

```ini
registry=https://registry.npmmirror.com/
electron_mirror=https://npmmirror.com/mirrors/electron/
```

### 修改安装目录

默认安装目录：
- Node.js: `%LOCALAPPDATA%\openclaw\node`
- OpenClaw: 全局安装（npm）

---

## 📊 版本信息

| 组件 | 版本 |
|------|------|
| Node.js | 22.x LTS |
| pnpm | 9.x |
| OpenClaw | latest |
| 安装包大小 | ~50MB（脚本） |

---

## 🐛 常见问题

### Q1: 提示需要管理员权限？

**A**: 右键点击脚本，选择「以管理员身份运行」

### Q2: npm 安装失败？

**A**: 
```cmd
# 重新配置 npm 路径
npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"

# 重新运行安装脚本
```

### Q3: 配置向导按回车没反应？

**A**: 
1. 使用方向键移动选项
2. 按空格键确认（出现 [x]）
3. 再按回车提交

### Q4: Gateway 启动失败？

**A**: 
```cmd
# 手动启动
openclaw gateway run

# 查看日志
Get-Content "$env:USERPROFILE\.openclaw\logs\*.log"
```

---

## 📞 参考资源

- **CSDN 教程**：https://blog.csdn.net/qq_57629629/article/details/158777998
- **OpenClaw 官网**：https://openclaw.ai
- **参考项目**：https://gitee.com/jockerzo/openclaw-windows-installer
- **Gitee 仓库**：https://gitee.com/jockerzo/openclaw-project.git

---

## 🎯 使用建议

| 场景 | 推荐工具 |
|------|---------|
| **首次安装** | `one_click_install.bat` |
| **日常使用** | `install_and_configure.bat` |
| **快速启动** | `quick_start_gateway.bat` |
| **开发调试** | `openclaw-toolkit.exe` |
| **批量部署** | Go 编译的 .exe |

---

**最后更新**: 2026-03-26  
**版本**: v8.2  
**状态**: ✅ 完成