# openclaw-windows-installer

**Repository Path**: jockerzo/openclaw-windows-installer

## Basic Information

- **Project Name**: openclaw-windows-installer
- **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-25
- **Last Updated**: 2026-04-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw Windows 安装器

一键安装 OpenClaw 到 Windows 系统，无需手动配置 Node.js、pnpm 等环境。

## 📦 特性

- ✅ **一体化打包** - Node.js + pnpm + OpenClaw 全部集成
- ✅ **国内镜像** - 预配置 npm 淘宝镜像，下载飞快
- ✅ **离线安装** - 核心依赖预缓存，无需联网下载
- ✅ **自动配置** - 环境变量、快捷方式自动创建
- ✅ **静默安装** - 支持命令行静默安装模式
- ✅ **配置向导** - 安装后自动启动交互式配置
- ✅ **一键初始化** - 自动配置 Web Token、阿里云 API、飞书机器人
- ✅ **多种启动方式** - BAT、PowerShell、Go EXE 三种选择
- ✅ **便携版本** - 不污染系统环境，即开即用

## 🚀 快速开始

### 下载安装包

从 [Gitee Releases](https://gitee.com/jockerzo/openclaw-windows-installer/releases) 下载最新版本：
- `OpenClaw-Portable-1.0.0.zip` - 便携版 (41 MB)

### 使用步骤

1. **解压到任意目录**（推荐 `C:\OpenClaw`）

2. **安装 OpenClaw**（三选一）：
   ```cmd
   install-openclaw.bat          # BAT 脚本（推荐）
   ```
   ```powershell
   .\install-openclaw.ps1        # PowerShell
   ```
   ```cmd
   OpenClaw-Installer.exe        # Go 编译版
   ```

3. **启动服务**：
   ```cmd
   OpenClaw-Launcher.exe
   ```

4. **访问 Dashboard**：
   ```cmd
   openclaw dashboard
   ```

## 🛠️ 构建说明

### 前置要求

- Windows 10/11 环境
- Node.js 22 LTS
- pnpm
- Go 1.24+ (用于编译 Go 启动器)

### 构建步骤

```bash
# 1. 下载 Node.js 便携版
./scripts/download-node.ps1

# 2. 准备依赖缓存
./scripts/prepare-deps.ps1

# 3. 编译 Go 启动器
./scripts/build-launcher.ps1
./scripts/build-install-launcher.ps1

# 4. 构建便携版安装包
./scripts/build-portable.ps1
```

### 输出

构建完成后，安装包位于 `output/` 目录：
- `OpenClaw-Portable-1.0.0.zip` - 便携版 (41 MB)

## 📁 项目结构

```
openclaw-windows-installer/
├── scripts/
│   ├── build-portable.ps1          # 构建便携版安装包
│   ├── build-launcher.ps1          # 编译 Go 启动器
│   ├── build-install-launcher.ps1  # 编译 Go 安装器
│   ├── install-openclaw.bat        # BAT 安装脚本
│   ├── install-openclaw.ps1        # PowerShell 安装脚本
│   └── install-launcher.go         # Go 安装器源码
├── src/openclaw/                   # OpenClaw 源代码
│   └── index.js                    # 主程序（含 HTTP 服务器）
├── node-portable/                  # Node.js 便携版（构建时下载）
├── output/                         # 输出的安装包
└── README.md
```

## 🎯 安装流程

1. 解压便携包到任意目录
2. 运行安装脚本（三选一）
3. 自动安装 OpenClaw（使用国内镜像）
4. 交互式配置向导
5. 启动服务并打开浏览器

## 📝 版本信息

- **Node.js**: v22.17.0 LTS
- **pnpm**: v10.x
- **OpenClaw**: v2026.3.24 (latest)
- **安装包大小**: 41 MB (便携版)

## 🔧 核心功能

### 1. 自动安装 OpenClaw

安装脚本会自动：
- 检测 Node.js 环境
- 设置 PATH 环境变量
- 使用淘宝镜像安装 OpenClaw
- 验证安装结果
- 启动配置向导

### 2. WebChat Token 自动生成

首次启动时自动生成 WebChat Token 并保存到配置文件：
```
C:\Users\%USERNAME%\.openclaw\openclaw.json
```

### 3. HTTP 服务器

内置 HTTP 服务器，提供以下端点：
- `/` - 欢迎页面
- `/health` - 健康检查
- `/api/status` - 服务状态
- `/webchat?token=xxx` - WebChat 页面

### 4. 多种启动方式

- **OpenClaw-Launcher.exe** - Go 编译版，性能最佳
- **Start-OpenClaw.bat** - BAT 脚本，兼容性好
- **Start-OpenClaw.ps1** - PowerShell，功能完整

## 🐛 常见问题

### Q: 安装失败怎么办？

A: 查看 `MANUAL_INSTALL.md` 获取详细的手动安装指南和故障排除方法。

### Q: 如何获取 WebChat Token？

A: Token 存储在配置文件中，启动时会自动生成。查看 `HOW_TO_GET_TOKEN.md` 获取详细说明。

### Q: 如何配置本地 Ollama 模型？

A: 编辑配置文件 `C:\Users\%USERNAME%\.openclaw\openclaw.json`，修改 model 部分：
```json
{
  "model": {
    "provider": "openai",
    "name": "llama3",
    "apiBase": "http://localhost:11434/v1",
    "apiKey": "ollama-local"
  }
}
```

## 📄 文档

- `INSTALL_OPENCLAW.md` - 完整安装说明
- `MANUAL_INSTALL.md` - 手动安装指南
- `HOW_TO_GET_TOKEN.md` - Token 获取说明
- `AUTO_TOKEN_GENERATION.md` - Token 自动生成说明

## 🔗 链接

- Gitee 仓库：https://gitee.com/jockerzo/openclaw-windows-installer
- OpenClaw 官方：https://github.com/openclaw/openclaw

## 📄 许可证

MIT