# openclawpack

**Repository Path**: AuroraGravity/openclawpack

## Basic Information

- **Project Name**: openclawpack
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClawPack - OpenClaw 图形化安装程序

[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](https://github.com/AuroraGravity/openclawpack)
[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/AuroraGravity/openclawpack/blob/main/LICENSE)

> 让 OpenClaw 安装变得简单 —— 无需命令行，一键完成安装

## 📖 简介

OpenClawPack 是一个跨平台的图形化安装程序，专为 OpenClaw 设计。它让非技术人员也能轻松安装和配置 OpenClaw，无需任何命令行操作。

### ✨ 特性

- 🖥️ **跨平台支持** - Windows、macOS、Linux 全支持
- 🚀 **一键安装** - 图形界面引导，无需命令
- 🎯 **智能检测** - 自动检测系统环境和依赖
- 📦 **Node.js 自动安装** - 未安装时自动下载并配置
- 🔄 **卸载/重装** - 支持检测已安装，可卸载或重装
- 🎛️ **运维管理** - 启动/停止/重启 Gateway，实时状态监控
- 🌐 **WebUI 嵌入** - 内置 Dashboard，支持嵌入模式
- 🔧 **灵活配置** - 可选组件，按需安装
- 📱 **桌面快捷方式** - 自动创建，快速启动
- 📊 **实时进度** - 下载和安装进度实时显示

## 📦 下载安装

### 从 Release 下载

访问 [Releases](https://github.com/AuroraGravity/openclawpack/releases) 页面下载对应系统的安装包：

| 系统 | 文件格式 | 说明 |
|------|----------|------|
| Windows | `.exe` | NSIS 安装程序或便携版 |
| macOS | `.dmg` | 拖拽安装 |
| Linux | `.AppImage` / `.deb` | AppImage 或 Debian 包 |

### 从源码构建

```bash
# 克隆仓库
git clone https://gitee.com/AuroraGravity/openclawpack.git
cd openclawpack

# 安装依赖
npm install

# 开发模式运行
npm start

# 打包构建
npm run build          # 当前平台
npm run build:win      # Windows
npm run build:mac      # macOS
npm run build:linux    # Linux
```

## 🚀 使用指南

### 安装步骤

1. **启动安装程序**
   - 双击下载的安装包

2. **欢迎页面**
   - 阅读功能介绍
   - 如已安装 OpenClaw，可选择**卸载**、**重装**或**管理**
   - 如未安装，点击"开始安装"

3. **管理模式**（已安装时）
   - **状态监控**: 实时显示 Gateway 运行状态
   - **运维控制**: 启动 / 停止 / 重启 Gateway
   - **Web 控制台**: 打开或嵌入 Dashboard
   - **日志查看**: 实时查看操作日志
   - **健康检查**: 一键运行系统健康检查

3. **系统检测**
   - 自动检测操作系统和依赖
   - 如未安装 Node.js，会自动提示并支持一键下载安装

4. **选择安装类型**
   - **快速安装**: 默认配置，推荐大多数用户
   - **自定义安装**: 高级用户可自定义路径和组件

5. **安装配置**
   - 选择安装路径
   - 勾选需要的组件：
     - 核心组件 (必选)
     - 飞书集成
     - 天气技能
     - 健康检查

6. **等待安装**
   - 查看实时进度
   - 查看安装日志

7. **完成安装**
   - 选择是否创建桌面快捷方式
   - 选择是否立即启动
   - 点击"完成"

### 组件说明

| 组件 | 说明 | 推荐 |
|------|------|------|
| 核心组件 | OpenClaw 核心功能 | 必选 |
| 飞书集成 | 飞书文档、云空间、知识库支持 | 飞书用户必选 |
| 天气技能 | 实时天气和预报查询 | 按需选择 |
| 健康检查 | 系统安全审计和风险评估 | 推荐安装 |

### 运维功能

| 功能 | 说明 | 适用场景 |
|------|------|----------|
| **启动** | 启动 Gateway 服务 | 服务未运行时 |
| **停止** | 停止 Gateway 服务 | 需要维护时 |
| **重启** | 重启 Gateway 服务 | 配置更改后 |
| **状态监控** | 实时显示运行状态 | 日常监控 |
| **Web 控制台** | 打开 Dashboard | 高级配置 |
| **嵌入 WebUI** | 在应用内显示控制台 | 快速访问 |
| **日志查看** | 查看操作日志 | 故障排查 |
| **健康检查** | 系统健康状态检查 | 定期维护 |

## 📋 系统要求

### 最低要求

- **操作系统**: Windows 10 / macOS 10.15 / Ubuntu 18.04 或更高
- **内存**: 2GB RAM
- **磁盘空间**: 500MB 可用空间

### 前置依赖

- **Node.js**: 18.x 或更高版本（如未安装，安装程序会自动下载）
- **npm**: 随 Node.js 自动安装

## 🛠️ 技术栈

- **框架**: Electron 28
- **前端**: React 18 + 原生 JavaScript
- **UI**: 自定义 CSS (Ant Design 风格)
- **打包**: electron-builder
- **语言**: 中文界面

## 📁 项目结构

```
openclawpack/
├── src/
│   ├── main/              # Electron 主进程
│   │   ├── main.js        # 主进程入口
│   │   └── preload.js     # 预加载脚本
│   ├── renderer/          # 渲染进程 (UI)
│   │   ├── index.html     # HTML 入口
│   │   ├── styles.css     # 样式文件
│   │   └── app.js         # 前端逻辑
│   └── installer/         # 安装逻辑 (可选)
├── resources/             # 资源文件 (图标等)
├── package.json           # 项目配置
├── README.md              # 说明文档
└── LICENSE                # 许可证
```

## 🔧 开发指南

### 本地开发

```bash
# 安装依赖
npm install

# 启动开发服务器
npm start
```

### 构建发布

```bash
# 构建所有平台
npm run build

# 构建特定平台
npm run build:win
npm run build:mac
npm run build:linux
```

### 添加新组件

1. 在 `src/renderer/index.html` 中添加组件选项
2. 在 `src/main/main.js` 中添加安装逻辑
3. 更新组件说明文档

## ❓ 常见问题

### Q: 安装时提示"Node.js 未安装"

A: 请先安装 Node.js。访问 [nodejs.org](https://nodejs.org/) 下载并安装 LTS 版本。

### Q: 安装后无法启动 OpenClaw

A: 请检查：
1. Node.js 是否正确安装
2. 环境变量是否配置
3. 尝试在终端运行 `openclaw` 命令查看错误信息

### Q: 如何卸载 OpenClaw？

A: 使用安装程序的**卸载**功能：
1. 启动安装程序
2. 如已安装会显示"卸载"按钮
3. 选择是否删除配置文件
4. 点击"确认卸载"

或手动卸载：
- **Windows**: 使用控制面板的"程序和功能"
- **macOS/Linux**: 运行 `npm uninstall -g openclaw`

## 📝 更新日志

### v1.0.0 (2026-03-14)
- 🎉 首次发布
- ✨ 支持 Windows、macOS、Linux
- ✨ 图形化安装界面
- ✨ 智能系统检测
- ✨ 可选组件安装
- ✨ 自动创建快捷方式

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 👥 作者

- **AuroraGravity** - [Gitee](https://gitee.com/AuroraGravity)

## 🔗 相关链接

- [OpenClaw 官方文档](https://docs.openclaw.ai)
- [OpenClaw GitHub](https://github.com/openclaw/openclaw)
- [Electron 文档](https://www.electronjs.org/docs)
- [Node.js 下载](https://nodejs.org/)

---

**让安装变得简单 🐾**