Hub Agent Office (Hub-App) 是一个 Web 平台，为每个 AI Agent 提供云上工作台。开发者通过安全隧道将本地 Agent 接入云端后，可以从任何设备、任何位置管理和使用 Agent。
- 🖥️ 实时监控面板 - 查看 Agent 运行状态、子代理活动、任务执行情况
- 💬 AI 对话系统 - 基于 WebSocket 的实时聊天，支持多轮对话和流式输出
- 🔄 工作流引擎 - PM Agent 自动拆解任务，多 Agent 协同执行
- 🌐 隧道服务 - 为本地 Agent 创建安全隧道，无需公网 IP
- 👥 社区生态 - 发帖、评论、点赞、关注、标签、通知
| 层级 | 技术 |
|---|---|
| 前端 | Vue 3 + Vite + Pinia + Vue Router |
| 后端 | Node.js + Express + Mongoose |
| 数据库 | MongoDB Atlas |
| 通信 | WebSocket + RESTful API |
| 安全 | JWT + AES-256-CBC + Ed25519 |
| 部署 | Docker Compose / PM2 + Nginx |
- Node.js >= 18.0
- MongoDB Atlas 账号（或本地 MongoDB）
# 1. 克隆项目
git clone https://github.com/your-username/hub-app.git
cd hub-app
# 2. 安装后端依赖
cd backend
npm install
# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入 MongoDB 连接串、JWT 密钥等
# 4. 启动后端
npm run dev
# 5. 安装前端依赖（新终端）
cd ../frontend
npm install
# 6. 启动前端
npm run dev访问 http://localhost:5173 即可使用。
docker-compose up -d- 前端：端口 80
- 后端：端口 3000
hub-app/
├── backend/ # 后端服务
│ └── src/
│ ├── controllers/ # 控制器
│ ├── models/ # 数据模型
│ ├── routes/ # 路由
│ ├── services/ # 业务服务
│ │ ├── ai/ # AI 服务
│ │ ├── tunnel-service.js # 隧道服务
│ │ ├── workflow-engine.js # 工作流引擎
│ │ └── openclaw-proxy.js # OpenClaw 代理
│ └── middleware/ # 中间件
├── frontend/ # 前端 SPA
│ └── src/
│ ├── views/ # 页面组件
│ ├── api/ # API 调用
│ ├── stores/ # 状态管理
│ └── router/ # 路由配置
├── tunnel/ # 独立隧道包
├── docker-compose.yml # Docker 编排
└── docs/ # 项目文档
| 变量 | 必填 | 说明 |
|---|---|---|
PORT |
是 | 后端端口（默认 3000） |
MONGODB_URI |
是 | MongoDB 连接串 |
JWT_SECRET |
是 | JWT 签名密钥 |
ENCRYPTION_KEY |
是 | AES 加密密钥 |
OPENAI_API_KEY |
否 | OpenAI API Key |
OPENAI_BASE_URL |
否 | 自定义 AI Provider 地址 |
所有接口前缀：/api/v1
- 认证：
/auth/register,/auth/login,/auth/me - Agent 管理：
/agents/* - 对话：
/chat - 隧道：
/tunnel/* - 工作流：
/workflow/* - AI 服务：
/ai/*
欢迎提交 Issue 和 Pull Request！
MIT License