用户在浏览器输入消息 | v [Frontend] Vite+React (端口 3080) | WebSocket 连接 v [Platform Gateway] FastAPI (端口 8080) --对应platform目录和项目 | 1. JWT 认证 | 2. 查找/启动用户容器 | 3. WebSocket 代理 v [用户容器] — 每个用户一个独立 Docker 容器 | | 容器内部结构: | ┌─────────────────────────────────────────┐ | │ Bridge (Node.js, 端口 18080) │ | │ - HTTP API 服务器 │ | │ - WebSocket 中继 │ | │ | │ | │ v │ | │ OpenClaw Gateway (端口 18789, loopback) │ | │ - Agent 处理引擎 │ | │ - 工具调用 (bash/文件/搜索等) │ | │ - Skills 系统 │ | │ - Session 管理 │ | └─────────────────────────────────────────┘ | | Agent 需要调用 LLM 时: v [Platform Gateway] /llm/v1/chat/completions | 1. 验证容器 Token | 2. 检查用户配额 | 3. 根据模型名匹配 Provider | 4. 注入真实 API Key v [LLM 提供商] (Anthropic / OpenAI / DashScope / DeepSeek / ...) | | 响应沿原路返回 v 用户在浏览器看到回复 

 1. Frontend (前端) - 运行在 3080 端口 - Vite 配置将 /api 代理到 http://localhost:8080（gateway） 2. Gateway / Platform (平台后端) - 运行在 8080 端口，由 ./platform 构建 - 处理认证、用户管理、数据库 - 对于 /api/openclaw/* 路径，通过 platform/app/routes/proxy.py 反向代理到用户的 OpenClaw 容器 3. OpenClaw Bridge (用户容器内) - 每个用户有独立的 Docker 容器 - Bridge 服务运行在 18080 端口（WebSocket）和 8080 端口（HTTP API） - 提供 agents、sessions、skills、cron 等功能 

浏览器 --> frontend:3080 --(JS请求)--> gateway(platform):8080 --> 用户容器(openclaw) | | postgres:5432 gateway/llm/v1 (用户/配额) (注入API Key) | 实际 LLM 提供商 

本地开发环境已启动 PostgreSQL http://127.0.0.1:5432 (存储用户表信息，参考doc/table.md) OpenClaw Bridge http://127.0.0.1:18080 (每个用户容器启动时都会创建，用于控制openclaw) Platform Gateway http://127.0.0.1:8080 # 控制openclaw的网关 Frontend Dev http://127.0.0.1:3080 #用户使用界面 Manage Admin http://127.0.0.1:3081 #管理界面 

 ┌──────────────────────┐ │ 浏览器 (Frontend) │ │ Vite+React :3080 │ └──────────┬───────────┘ │ HTTP + WebSocket v ┌──────────────────────┐ │ Platform Gateway │ │ FastAPI :8080 │ │ ┌────────────────┐ │ │ │ Auth (JWT) │ │ │ │ Container Mgr │ │ │ │ LLM Proxy │ │ │ │ Quota Control │ │ │ └────────────────┘ │ └───┬──────────┬───────┘ │ │ ┌─────────┘ └──────────┐ v v ┌──────────────┐ ┌──────────────────┐ │ PostgreSQL │ │ 用户容器 (N个) │ │ :5432 │ │ ┌──────────────┐ │ │ 用户/配额/ │ │ │ Bridge :18080│ │ │ 容器元数据 │ │ │ HTTP + WS │ │ └──────────────┘ │ └──────┬───────┘ │ │ v │ │ ┌──────────────┐ │ │ │ OpenClaw GW │ │ │ │ :18789 │ │ │ │ (loopback) │ │ │ │ │ │ │ │ Agent Engine │ │ │ │ Tools/Skills │ │ │ │ Sessions │ │ │ └──────────────┘ │ └──────────────────┘ │ LLM 请求通过 Gateway 代理 │ v ┌──────────────────┐ │ LLM Providers │ │ Anthropic/OpenAI │ │ DashScope/... │ └──────────────────┘ 

1. 读取环境变量 (NANOBOT_PROXY__URL, NANOBOT_PROXY__TOKEN, 模型名) 2. 写入 ~/.openclaw/openclaw.json（配置 LLM 代理、模型、Gateway 模式） 3. 启动 OpenClaw Gateway 子进程: node openclaw.mjs gateway run --port 18789 --bind loopback 4. 等待 Gateway WebSocket 就绪（最多 60 秒） 5. 建立 Bridge → Gateway 的 WS 连接（Ed25519 握手） 6. 启动 HTTP 服务器（0.0.0.0:18080），对外暴露 API 

用户首次聊天 → create_container() ├─ 在 DB 中占位（防并发） ├─ 创建 Docker Volume（workspace + sessions） ├─ 启动容器（资源限制：2GB RAM, 4 CPU） └─ 记录容器 IP、Token 空闲 30 分钟 → pause（暂停容器，释放 CPU） 再次访问 → unpause（秒级恢复） 空闲 30 天 → archive（归档） 用户删除 → destroy（移除容器，保留数据 Volume） 

容器内 OpenClaw → POST http://gateway:8080/llm/v1/chat/completions Authorization: Bearer <container-token> Body: { model: "claude-sonnet-4-5", messages: [...] } Gateway 处理： 1. 通过 container-token 查找用户 2. 检查每日 Token 配额（free: 100K, basic: 1M, pro: 10M） 3. 根据模型名匹配 Provider（claude→Anthropic, gpt→OpenAI, qwen→DashScope...） 4. 注入对应的真实 API Key 5. 调用 LLM，流式/非流式返回结果 6. 记录 Token 用量 

frontend/ ├── Dockerfile # 生产镜像（npm build → nginx 静态服务） ├── nginx.conf # nginx 配置：/ 静态文件，/api → gateway 反代 ├── package.json # 依赖管理 ├── vite.config.ts # Vite 配置（开发代理 /api → localhost:8080） ├── tailwind.config.js # Tailwind 主题配色 ├── index.html # SPA 入口 HTML └── src/ ├── main.tsx # React 入口，挂载 <App /> ├── App.tsx # 路由定义（React Router） ├── index.css # 全局样式 + Tailwind @import ├── lib/ │ └── api.ts # API 客户端（fetch + WebSocket，相对路径 /api/...） ├── store/ │ └── agents.ts # Agent 数据请求（fetchAgents、fetchDashboardStats 等） ├── types/ │ └── agent.ts # TypeScript 类型定义（BackendAgent、DashboardStats 等） ├── components/ │ ├── Layout.tsx # 全局布局：Sidebar + TopBar + <Outlet /> │ ├── Sidebar.tsx # 左侧导航栏（仪表盘、Agents、会话、技能…） │ ├── TopBar.tsx # 顶部栏（用户信息、退出登录） │ └── MarkdownContent.tsx # Markdown 渲染组件（代码块 + 复制按钮） └── pages/ ├── Dashboard.tsx # 仪表盘：统计卡片 + Agent 列表概览 ├── Login.tsx # 登录页 ├── Agents.tsx # Agent 列表页 ├── AgentCreate.tsx # 创建 Agent ├── AgentDetail.tsx # Agent 详情（配置、身份编辑） ├── Chat.tsx # 聊天页：会话列表 + 消息区 + WebSocket + 斜杠命令自动补全 ├── Sessions.tsx # 会话管理 ├── SkillStore.tsx # 技能商店（搜索、安装、启用/禁用） ├── CronJobs.tsx # 定时任务管理 ├── KnowledgeBase.tsx # 知识库文件管理 ├── FileManager.tsx # 工作空间文件浏览 ├── Channels.tsx # 渠道配置 ├── AIModels.tsx # AI 模型管理 ├── Plugins.tsx # 插件管理 ├── Nodes.tsx # 节点管理 ├── ApiAccess.tsx # API Token 管理 ├── AuditLog.tsx # 审计日志 └── SystemSettings.tsx # 系统设置 

deploy_copy/ ├── openclaw_defaults.json # OpenClaw 默认配置（合并到 ~/.openclaw/openclaw.json） ├── Agents/ # 预置 Agent 工作空间 │ ├── hr/ # 人力资源顾问 │ │ ├── SOUL.md # Agent 人格与核心原则 │ │ ├── AGENTS.md # Agent 行为规范与工具指南 │ │ └── USER.md # 用户画像与交互偏好 │ ├── researcher/ # 资深研究员 │ │ ├── SOUL.md │ │ ├── AGENTS.md │ │ └── USER.md │ └── programmer/ # 全栈工程师 │ ├── SOUL.md │ ├── AGENTS.md │ └── USER.md └── skills/ # 预置技能 ├── infoxmed-search/ # 医学信息检索 │ ├── SKILL.md # 技能定义（名称、描述、触发条件） │ └── scripts/infoxmed_search.py # 执行脚本 └── medical-research-agent/ # 医学研究 Agent ├── SKILL.md ├── scripts/search.py └── references/ # 参考资料（模板、工具说明） 

deploy_copy/Agents/hr/ → ~/.openclaw/workspace-hr/ (Agent 工作空间) ~/.openclaw/agents/hr/ (Agent 注册目录) openclaw.json → agents.list[] (注册到配置文件) deploy_copy/skills/infoxmed-search/ → ~/.openclaw/skills/infoxmed-search/ deploy_copy/openclaw_defaults.json → 合并到 ~/.openclaw/openclaw.json（只添加缺失的 key） 

项目根目录/ ├── .env # API Key 配置（不提交到 git） ├── .env.example # 环境变量模板 ├── docker-compose.yml # 多租户部署编排（postgres + gateway + frontend） ├── docker-compose.yml.prod # 生产环境 compose 配置 ├── deploy_docker.py # Docker 一键部署脚本（支持本地/远程/重建/清理） ├── start_local.py # 本地开发启动脚本（全服务一键启动） ├── start_local_wins.py # Windows 本地启动脚本 ├── prepare.py # 环境准备脚本（检查 Docker、拉镜像） ├── check_status.py # 服务状态检查 ├── call_agent_api.py # API 调用示例脚本 ├── sync_upstream.py # 上游 OpenClaw 同步工具 ├── inspect_db.py # 数据库检查工具 ├── pyproject.toml # Python 项目配置 │ ├── deploy_copy/ # 部署模板（自动拷贝到用户容器） │ ├── openclaw_defaults.json # OpenClaw 默认配置（合并到 openclaw.json） │ ├── Agents/ # 预置 Agent 工作空间模板 │ │ ├── hr/ # HR 助手（SOUL.md + AGENTS.md + USER.md） │ │ ├── researcher/ # 研究员助手 │ │ └── programmer/ # 程序员助手 │ └── skills/ # 预置技能 │ ├── infoxmed-search/ # 医学信息检索技能 │ └── medical-research-agent/ # 医学研究 Agent 技能 │ ├── openclaw/ # OpenClaw Agent 框架 + Bridge 适配层 ├── platform/ # 多租户平台网关（FastAPI） ├── frontend/ # Web 前端（Vite + React） ├── doc/ # 文档和截图 └── ssh_key/ # SSH 密钥（远程部署用） 

openclaw/ ├── Dockerfile # OpenClaw 基础镜像 ├── Dockerfile.bridge # Bridge 镜像（基于基础镜像 + bridge 代码） ├── bridge-entrypoint.sh # 容器入口脚本（同步 deploy_copy、注册 Agent） ├── package.json # Node.js 依赖 ├── openclaw.mjs # OpenClaw CLI 入口 │ └── bridge/ # Bridge 适配层源码 ├── start.ts # 启动入口：写入配置 → 启动 Gateway 子进程 → 启动 HTTP 服务 ├── server.ts # Express HTTP 服务器（端口 18080）+ WebSocket 中继 ├── gateway-client.ts # 连接本地 OpenClaw Gateway 的 WS 客户端（Ed25519 握手） ├── config.ts # 环境变量读取（代理 URL、Token、模型）、工作目录创建 ├── utils.ts # 通用工具函数 ├── types.d.ts # TypeScript 类型定义 ├── package.json # Bridge 独立依赖 │ └── routes/ # REST API 路由（挂载到 /api/*） ├── agents.ts # Agent 管理：列表、详情、创建、删除、身份配置 ├── sessions.ts # 会话管理：列表、历史消息、创建、删除 ├── skills.ts # 技能管理：列表、上传、删除、导出（扫描 3 个目录） ├── commands.ts # 斜杠命令：列出可用命令供前端自动补全 ├── plugins.ts # 插件管理：列表、安装、卸载 ├── cron.ts # 定时任务：创建、删除、启用/禁用、手动执行 ├── channels.ts # 渠道管理：配置 Telegram/Discord/Email 等 ├── events.ts # SSE 事件流：实时推送 Agent 执行状态 ├── files.ts # 文件操作：上传、下载（知识库用） ├── filemanager.ts # 文件管理器：浏览、创建目录、删除（工作空间用） ├── nodes.ts # 节点管理 ├── settings.ts # 设置：读写 openclaw.json 配置 ├── status.ts # 状态：Gateway 健康检查、版本信息 ├── workspace.ts # 工作空间：文件浏览和编辑 └── marketplaces.ts # 技能市场：搜索和安装 skills.sh 上的技能 

platform/ ├── Dockerfile # Gateway 镜像（Python 3.11 + uvicorn） ├── pyproject.toml # Python 依赖（fastapi, sqlalchemy, docker, jose...） ├── alembic.ini # 数据库迁移配置 ├── README.md # Platform 说明文档 │ ├── alembic/ # 数据库迁移脚本 │ ├── env.py # Alembic 环境配置 │ └── script.py.mako # 迁移脚本模板 │ └── app/ # FastAPI 应用 ├── __init__.py ├── main.py # 应用入口：创建 FastAPI app、挂载路由、启动事件 ├── config.py # 配置中心：API Key、数据库 URL、配额等级、默认模型 ├── logging_setup.py # 日志配置 │ ├── auth/ # 认证模块 │ ├── __init__.py │ ├── service.py # JWT + bcrypt 认证服务（注册/登录/刷新 Token） │ └── dependencies.py # FastAPI 依赖注入（get_current_user 等） │ ├── container/ # 容器管理模块 │ ├── __init__.py │ └── manager.py # Docker API 封装：创建/暂停/恢复/归档/销毁用户容器 │ ├── db/ # 数据库模块 │ ├── __init__.py │ ├── engine.py # SQLAlchemy 异步引擎 + 会话工厂 │ └── models.py # ORM 模型：User、Container、Usage │ ├── llm_proxy/ # LLM 代理模块 │ ├── __init__.py │ └── service.py # API Key 注入、Provider 匹配、配额检查、用量记录 │ └── routes/ # API 路由 ├── __init__.py ├── auth.py # POST /auth/register, /auth/login, /auth/refresh ├── proxy.py # /api/openclaw/* → 用户容器（HTTP 反代 + WebSocket 代理） ├── llm.py # POST /llm/v1/chat/completions（容器调 LLM 的入口） └── admin.py # 管理接口：用户列表、容器管理、系统状态