73 lines
1.2 KiB
Markdown
73 lines
1.2 KiB
Markdown
# 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）
|
||
- 所有依赖已在虚拟环境中安装
|