# mini-OpenClaw 启动指南

## 🚀 快速启动（推荐）

### Windows 用户
双击运行：
```
start.bat
```

或在终端中：
```bash
./start.sh
```

### 手动启动

#### 1. 启动后端
```bash
cd backend
./start_backend.sh    # Linux/Mac/Git Bash
# 或
start_backend.bat      # Windows CMD
```

#### 2. 启动前端
```bash
npm run dev
```

## ✅ 验证运行状态

- 后端：http://localhost:8002
- 前端：http://localhost:3000

## 🔧 问题排查

### 问题：Connection error / 代理错误

**原因**：系统配置了代理（127.0.0.1:7890）但代理服务未运行

**解决方案**：
1. 使用提供的启动脚本（已自动禁用代理）
2. 或启动你的代理服务器（端口 7890）

### 问题：端口被占用

**解决方案**：
```bash
# Windows
netstat -ano | findstr :8002
taskkill /F /PID <PID>

# Linux/Mac
lsof -ti:8002 | xargs kill -9
```

### 问题：LlamaIndex 警告

**解决方案**：确保使用项目虚拟环境
```bash
cd backend
source venv/Scripts/activate  # Git Bash
# 或
venv\Scripts\activate.bat     # Windows CMD
```

## 📝 说明

- 启动脚本会自动禁用代理设置
- 后端使用项目虚拟环境（backend/venv）
- 所有依赖已在虚拟环境中安装