mini-openclaw/START_GUIDE.md

mini-OpenClaw 启动指南

🚀 快速启动（推荐）

Windows 用户

双击运行：

start.bat

或在终端中：

./start.sh

手动启动

1. 启动后端

cd backend
./start_backend.sh    # Linux/Mac/Git Bash
# 或
start_backend.bat      # Windows CMD

2. 启动前端

npm run dev

✅ 验证运行状态

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

🔧 问题排查

问题：Connection error / 代理错误

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

解决方案：

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

问题：端口被占用

解决方案：

# Windows
netstat -ano | findstr :8002
taskkill /F /PID <PID>

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

问题：LlamaIndex 警告

解决方案：确保使用项目虚拟环境

cd backend
source venv/Scripts/activate  # Git Bash
# 或
venv\Scripts\activate.bat     # Windows CMD

📝 说明

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