配置操作界面演进¶

产品方向重大修正¶

决策者：Dad
时间：2026-03-12 下午到晚上

从监控到操作¶

Dad 明确指出 ClawCraft 的发展方向：

"监控和操作都很重要，目标是用 RTS 界面替代传统 channel 对话和配置工作"

这直接推动 PRD 从"监控面板游戏化"升级为"OpenClaw 操作系统游戏化"。

UI 结构重大调整¶

全屏世界视图¶

决策者：Dad 提需求，bot 实现

设计要求： - world view 占整个屏幕 - 其他内容用浮窗展示 - 状态区域在右侧，用卡片方式显示，像 RTS 游戏

实现方案¶

bot 完成的 UI 重构： - WorldCanvas：全屏绝对定位 - 浮窗化组件： - ReconnectBanner - ResourceBar - EventTicker - UnitCard - DeveloperFilter

体验提升¶

更符合 RTS 操作体验
主视觉聚焦"世界"而非传统 dashboard
减少界面元素对操作的干扰

从只读到可配置¶

问题发现¶

Dad 发现当前界面"全是只读"，要求把 OpenClaw 配置功能逐步集成到 RTS 游戏中。

功能规划¶

bot 制定了配置功能进度表，并开始推进 Wave 2 功能： 1. 基础状态展示（已完成） 2. 配置查看（进行中） 3. 配置修改（规划中） 4. 操作执行（规划中）

后端能力验证¶

全面 API 自测¶

bot 对 plugin/gateway 进行全面验证：

验证的 Endpoint¶

Health endpoint：系统健康检查
State endpoint：包含 incidents, channels, onboardingProgress
Config endpoint：API key 脱敏处理
Files endpoint：文件系统访问
Skills endpoint：技能状态管理
SSE：实时事件流
Memory endpoint：记忆系统访问

关键问题修复¶

Files endpoint 对 main agent 返回空 - 根因：main agent 没有 config entry，代码优先命中 ~/.openclaw/agents/main/agent/，但该目录无 markdown 文件 - 解决：只有目录中至少存在 .md 文件时才返回，否则 fallback 到默认 workspace

Memory recall 不工作 - 根因：/tools/invoke 只暴露已注册工具，测试机 memory plugin 暴露的不是 memory_recall - 解决： - 改用 memory_search - sessionKey 统一为 agent:main:main 格式

验证结果¶

所有 7 个 endpoint 通过测试
真实数据可经 SSE 流入前端
为可配置功能提供了完整的后端支持

架构演进意义¶

系统性思考转变¶

从"OpenClaw 的可视化监控工具"转变为"OpenClaw 的操作系统界面"，这个定位变化带来了：

功能范围扩大：不仅展示状态，还要执行操作
交互复杂度提升：从只读界面到可操作界面
数据一致性要求：需要确保界面操作与实际状态同步

技术架构影响¶

API 设计：需要支持读写操作，不仅是查询
状态管理：需要处理配置变更和状态同步
错误处理：需要处理操作失败和回滚
权限控制：需要考虑操作权限和安全性

这次演进为后续技能安装、配置管理等高级功能奠定了重要基础，标志着 ClawCraft 从概念验证走向实用工具的关键转折点。