跳转至

03-10~12:项目立项与 PRD 形成

Dad 的关键产品决策

从像素风网页到 RTS 游戏界面

03-10 背景:最初目标是做一个"项目管理平台",基于 shadcn/ui 设计。

03-11 转折: - Dad 对初版反馈"太简单""太普通,看不出项目更新感" - 明确要求:不要传统企业 Admin Dashboard,要突出"研究型项目"氛围 - 最终定调:把整个 OpenClaw 系统可视化成类似 Age of Empires / RTS 的游戏界面

关键语录

"目标不是'像素字体网页',而是真正有游戏感的系统操作界面"

技术路线选择

放弃 Next.js 的原因: - Next.js 16 / Turbopack 在当前服务器环境构建卡死 - 响应慢、难以稳定部署 - 目标是快速验证"游戏化交互",不需要 SSR

最终选型: - Vite + React + TypeScript + shadcn/ui - 先用纯 HTML/JS/CSS 做像素风原型,再逐步演进

产品命名

03-11 深夜: - Dad 决定将"OpenClaw 系统游戏化展示"作为全新研究项目 - bot 提出多个名字,最终采用 ClawCraft

技术问题与根因分析

早期原型迭代中的数据问题

问题:项目卡片出现 undefined

根因:数据库缺少 emoji 列,前端直接渲染导致显示 undefined

解决: 1. 补数据库 emoji 字段 2. 检查 server.js 查询逻辑与 init schema 3. 同步修正项目阶段数据

解决方案

多模型头脑风暴机制

Dad 决策:拉起子代理,用 github-copilot/gemini-3.1-pro-preview 进行 10 轮头脑风暴

10 轮辩论核心主题: 1. 2.5D 等距像素风是否合适 2. OpenClaw 实体如何映射到 RTS 世界 3. 实时数据如何驱动世界状态 4. 多实例/多系统如何展示 5. 资源系统、建筑、科技树 6. MVP 范围界定

辩论结论: - ClawCraft 不应只是"监控面板套游戏皮肤" - 应是可操作的系统控制界面 - 世界中的对象需要和 OpenClaw 核心概念一一映射

架构方案定型(03-12 凌晨)

Plugin + Frontend 方案: - ClawCraft 作为 OpenClaw plugin + 独立 frontend 实现 - Plugin 能直接接入 Gateway 事件流与运行时 API - 比外部轮询脚本更稳定

源码调研成果: - Gateway 事件列表 - RPC 方法 - Plugin SDK TypeScript 类型 - runtime 对象能力

OpenClaw 概念映射

OpenClaw 概念 RTS 映射 说明
gateway 王国核心/主城 系统入口
agents 领主/指挥官 执行单元
sessions 探险者/单位 会话实例
channels 港口/使馆 通信通道
skills 技能工坊 能力扩展
plugins 插件工厂 功能模块
memory 记忆宝库 持久存储
models 模型熔炉 AI 模型
tools 工具库 可用工具
files / agent docs 领主档案/铭文编辑器 配置文件

PRD 演进

v1.0:概念映射、前端世界观、插件架构、MVP 范围

v1.1:增加阶段划分(MVP、Wave 1、Wave 2...)

v1.2/v1.3(关键纠偏): - Dad 指出价值优先级不对 - 监控和操作都很重要 - 目标是用 RTS 界面替代传统 channel 对话和配置工作

v2.0: - 每个场景包含操作步骤、涉及组件、API 调用、验收标准 - 生成 HTML 在线版

里程碑

03-10

  • [x] 前端技术选型确定:Vite + React + TypeScript + shadcn/ui
  • [x] 项目管理原型搭建完成

03-11

  • [x] 产品方向从"项目管理网页"升级为"RTS 游戏化界面"
  • [x] 项目正式命名为 ClawCraft
  • [x] 代码入库

03-12

  • [x] 确定 Plugin + Frontend 架构方案
  • [x] 完成 OpenClaw 概念到 RTS 世界的映射
  • [x] PRD v2.0 定稿
  • [x] MVP 正式开工
  • [x] 首次跑通前端白模 + HUD + 实时事件流
  • [x] E2E 测试 7/7 通过
  • [x] UI 重构为真正 RTS 布局(WorldCanvas 全屏 + 浮窗化 HUD)
  • [x] 频道管理设计完成("港口使馆"概念)
  • [x] 技能工坊支持搜索、评分、一键安装