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）
|
|||
|
|
- 所有依赖已在虚拟环境中安装
|