核心用法
ClawTime 作为 OpenClaw 的 Web 前端界面，提供三类核心能力：
1. 交互式小部件系统
通过 [[WIDGET:...]] 语法嵌入六种组件：Buttons（多选按钮）、Confirm（确认对话框）、Progress（进度条）、Code（代码块带复制）、Form（表单输入）、Datepicker（日期选择）。小部件响应以 [WIDGET_RESPONSE:...] 格式回传，实现结构化用户输入替代自由文本。
2. 任务面板
基于本地 ~/.clawtime/tasks.json 的 Markdown 格式任务看板，分 Active（进行中🟡）、Blocked（阻塞⏳）、Backlog（待办）、Done（完成✅）四栏，作为代理的规范任务追踪系统。
3. 3D 体素化身
基于 Three.js 的模块化角色系统，支持 JavaScript 编写自定义 avatar，通过 initAvatarScene、setAvatarState、setConnectionState 等标准接口控制。内置 10 种状态（idle/thinking/talking/listening/working/happy/celebrating/sleeping/error/reflecting），每种状态需设计独特的视觉表现。
显著优点
- 可视化交互密度高：小部件将多轮对话压缩为单次点击，显著降低用户认知负荷
- 状态表达丰富：10 种 avatar 状态配合粒子特效（❓💡❤️⭐💤），使 AI 内部状态外化为可感知的角色表演
- 本地优先架构：任务、配置、化身均存储于本地文件，无云端依赖
- 开发者友好：widget 语法简洁，avatar 模板完整注释，支持热重载
潜在缺点与局限性
- 部署复杂度：需 systemd 用户服务、Cloudflare Tunnel 等基础设施，非开箱即用
- 浏览器依赖：Three.js 化身需 WebGL 支持，低端设备可能性能受限
- 生态封闭：与 OpenClaw 深度绑定，难以独立用于其他后端
- 状态同步风险：本地 JSON 任务文件存在并发写入冲突可能，无事务保护
适合人群
- 需要高交互密度的 AI 应用开发者（客服、配置向导、创作工具）
- 追求角色化体验的 C 端产品团队
- 已采用 OpenClaw 后端的技术用户
- 愿意投入前端定制的创意开发者
常规风险
- XSS 风险：widget 的
code字段若渲染 HTML 需严格转义；avatar JS 在沙箱外执行 - 路径遍历：任务文件路径拼接需验证，防止
~/.clawtime/../../../etc/passwd - DoS：复杂 Three.js 场景可能耗尽 GPU/CPU，建议设置渲染限帧
- 凭证泄露：
.env与credentials.json需严格权限控制（600），避免提交至版本控制