# openclaw-loader

**Repository Path**: dot123dot/openclaw-loader

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw Loader

OpenClaw 启动器 —— Windows 一键安装与 WebUI 配置工具。

## 功能

- 一键安装 OpenClaw 项目及所有依赖 (Node.js, pnpm, Git)
- 自动从 Git 仓库克隆 OpenClaw 项目并构建 (Server + Web)
- 现代化 WebUI 管理界面
- 模型提供者配置 (API Key, Base URL, 模型列表)
- Server 启动/停止/状态监控
- 智能体默认参数配置
- 实时安装进度反馈 (WebSocket)

## 快速开始

### 方式一：一键安装脚本 (推荐)

打开 PowerShell，运行：

```powershell
irm https://gitee.com/dot123dot/openclaw-loader/raw/main/install.ps1 | iex
```

### 方式二：手动安装

```bash
# 克隆仓库
git clone https://gitee.com/dot123dot/openclaw-loader.git
cd openclaw-loader

# 安装依赖
pnpm install

# 构建前端界面（首次运行自动安装 UI 依赖）
pnpm ui:build

# 构建核心服务
pnpm build

# 启动
pnpm start
```

启动后在浏览器中打开 `http://localhost:19900`，进入「安装部署」页面即可一键安装 OpenClaw 项目。

## 安装流程

Loader 启动后会提供 WebUI，通过 WebUI 的「安装部署」功能自动完成：

1. 检查 Node.js、pnpm、Git 基础依赖
2. 从 Git 仓库克隆 OpenClaw 项目到 `~/.openclaw/openclaw`
3. 安装 Server (NestJS) 后端依赖
4. 安装 Web (React + Vite) 前端依赖
5. 构建 Server 和 Web 项目
6. 初始化配置文件 (.env.local)

## 开发模式

```bash
# 启动后端开发服务器
pnpm dev

# 启动前端开发服务器 (另一个终端)
pnpm ui:dev
```

## 项目结构

```
openclaw-loader/
├── package.json          # 主 package.json
├── pnpm-workspace.yaml   # pnpm 工作区配置
├── tsconfig.json         # TypeScript 配置
├── install.ps1           # Windows 一键安装脚本
├── scripts/
│   ├── check-deps.js     # 依赖检查脚本
│   └── build-ui.js       # UI 自动安装依赖并构建
├── src/                  # 核心服务 (TypeScript)
│   ├── index.ts          # 入口 - 启动服务并打开浏览器
│   ├── server.ts         # Express API 服务器
│   ├── installer.ts      # 安装器逻辑 (克隆项目 + 安装依赖 + 构建)
│   └── config.ts         # 配置文件管理
└── ui/                   # 前端 WebUI (Vue 3 + Vite)
    ├── package.json
    ├── index.html
    ├── vite.config.ts
    └── src/
        ├── main.ts
        └── App.vue       # 主界面组件
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/status` | 获取系统状态 |
| GET | `/api/config` | 读取配置 |
| POST | `/api/config` | 覆盖配置 |
| PATCH | `/api/config` | 部分更新配置 |
| GET | `/api/server-env` | 读取 Server 环境变量 |
| POST | `/api/server-env` | 更新 Server 环境变量 |
| POST | `/api/gateway/start` | 启动 OpenClaw Server |
| POST | `/api/gateway/stop` | 停止 OpenClaw Server |
| WS | `/ws` | WebSocket 安装进度 |

## 配置文件

- Loader 配置: `~/.openclaw/openclaw.json` (JSON5 格式)
- Server 配置: `~/.openclaw/openclaw/server/.env.local`

## 系统要求

- Windows 10/11
- Node.js >= 18
- pnpm
- Git

## 许可

MIT