跳到主要内容

实施路线图 & 待办清单

最后更新：2026-03-05

当前进度总览​

Phase 1  →  Phase 2 ✅（大部分）  →  Phase 3 📋
   MVP              增强                    完善
  规划            规划                 规划中

Phase 1 — MVP（规划）​

  • OpenClaw 实例部署（小龙 ai-jp-1 × 1 + 小二 ai-jp-2 × 10，共 11 个实例）
  • LiteLLM Proxy 部署 + 多模型注册（GPT-5.2-Pro / GPT-4o / Claude / Gemini）
  • Virtual Key 三级体系（all / openai / google / anthropic 各子 Key）
  • Google OAuth 接入（Portal + Admin 双端）
  • 员工-实例映射（user_instances 表）
  • 管理后台（Soybean Admin）：服务器 / 实例 / 用量 / API Key 管理
  • Portal 前端：自助领取实例、TG Bot 绑定、AI 对话、用量统计
  • Telegram Bot 自助配置（per-instance，allowlist 模式）
  • API Key Vault（AES-256-GCM 加密）
  • 多服务器 SSH 路由（admin-api 统一调度）
  • 聊天记录持久化（chat_messages 表）
  • 文档站（doc.sayclaw.ai，Docusaurus 3）
  • GitLab CE 私有仓库（git.sayclaw.ai，6 个仓库）

Phase 2 — 增强（规划）​

定时任务 & 自动运维​

  • 4 张 DB 表（task_queue / job_runs / server_metrics / usage_daily）
  • queueWorker（每 5 秒拉取执行异步任务）
  • init_instance（认领后 < 10s 自动初始化实例）
  • health_check（每 5 分钟，SSH + HTTP 双层检查）
  • auto_recovery（每 10 分钟，自动重启异常实例）
  • log_scan（每 10 分钟，日志巡检 + 自动修复 auth-profiles.json / doctor --fix / OOM 告警）
  • server_metrics（每 5 分钟，采集 CPU/内存/磁盘）
  • token_usage_sync（每 15 分钟，同步 Token 用量到 usage_daily）
  • key_validity_check（每 30 分钟，LiteLLM key 有效性 + auth-profiles.json 一致性修复）

应用市场​

  • DB 表（marketplace_items / marketplace_installs）
  • 11 个官方技能 + 2 个配置包上架
  • apply_marketplace_item Worker（SSH 安装 → 重启 → 更新 install_count）
  • Portal 应用市场页面（Tab 筛选 / 卡片 / 安装按钮）
  • 配置包「📄 详情」弹窗（左侧文件列表 + 右侧内容预览）
  • Admin 应用市场管理页面

实例模板​

  • instance_templates 表 + 9 个模板文件
  • Admin 模板管理页面（CRUD + 一键同步到实例）
  • Portal「配置中心」页面

其他​

  • API Key 管理三 Tab（Key Vault / 模型注册 / 子 Key 清单）
  • Admin 调度管理页面（Job 执行记录 / 任务队列 / Token 统计）
  • 实例列表 30s 自动刷新 Token 数据
  • 小龙 TG 切换直连模式（去掉 pproxy/SSH 隧道，GCP JP 可直连 api.telegram.org）

🔴 待完成（高优先级）​

邀请码模块​

详见：邀请码模块

  • 建 invite_codes + invite_code_uses DB 表
  • portal-api claimInstanceHandler 加邀请码校验
  • Portal 领取弹窗加邀请码输入框
  • Admin 邀请码管理页面（生成 / 列表 / 作废 / 使用记录）

安全加固​

  • admin-api 登录密码 SHA2 → bcrypt
  • oc_api_keys.raw_key 明文 → AES 加密存储

🟡 待完成（中优先级）​

  • key_balance_alert：LiteLLM key 余额 < 阈值时 TG 告警（已预留，待激活）
  • oc-deploy-instance skill：部署后自动写 DB + 自检
  • GitLab Google OAuth：配置 google_oauth2 OmniAuth
  • admin-api Docker TLS：getDockerClient() 接入 TLS 证书

🟢 待完成（低优先级）​

  • LiteLLM fallback 压测：gpt-5.2-pro rate limit 时确认 fallback 到 gpt-4o
  • Soybean Admin → GitLab CI/CD 自动 build + deploy
  • 批量操作（批量入职、批量分配实例）
  • 数据导出（用量报告 CSV/PDF）

技术栈现状​

层技术
认证Google OAuth 2.0（GCP 凭证）
Portal 前端Vue 3 CDN SPA（app.sayclaw.ai）
Admin 后台Soybean Admin + Vue 3 Vite（admin.sayclaw.ai）
Portal APIGo + Gin（portal-api.sayclaw.ai，port 8082）
Admin APIGo + Gin（api.sayclaw.ai，port 8081）
AI 代理LiteLLM Proxy（port 4000，STORE_MODEL_IN_DB=True）
AI 实例OpenClaw v2026.3.2（小龙 × 1 + 小二 × 10）
数据库MySQL 8.0（业务）+ PostgreSQL 15（LiteLLM）
代码托管GitLab CE（git.sayclaw.ai，6 个仓库）
基础设施GCP Japan（ai-jp-1 / ai-jp-2）+ Cloudflare DNS + Certbot SSL
通知Telegram Bot（per-instance，直连 api.telegram.org）
加密AES-256-GCM（Key Vault）

文档状态修订（2026-03-05）​

阶段验收规则（DoD）​

  • Phase 项目标记“完成”必须满足：
    1. 有对应 commit / MR；
    2. 有测试或回归记录；
    3. 有部署或发布记录（若适用）。

证据字段（新增）​

每个阶段条目建议补：

  • owner
  • evidence（MR/commit/report 链接）
  • updated_at