LiteClaw 的目标不是一次性复刻完整 OpenClaw，而是以更轻量、更清晰、更易验证的方式，逐步演进到具备 OpenClaw 核心能力的 Agent 系统。
这份 roadmap 用来说明项目将如何从当前的最小可运行链路，逐步走向更完整的能力闭环。
当前版本已经具备：
- 飞书长连接接入
- webhook 兼容回退入口
- 本地 OpenAI-compatible 模型调用
- 基础多轮上下文
- 可替换的会话存储抽象
- Redis 会话持久化（可选）
event_id去重- 群聊仅在
@机器人时响应 - 基础命令路由：
/help、/reset、/status、/tools - 最小工具调用骨架：tool registry +
local_status - 结构化日志与基础错误分类
- 超时、重试与基础限流
- 基础错误兜底
当前版本尚未具备：
- 长期记忆与摘要机制
- 模型自主决策的工具调用
- 任务执行
- 流式输出
- 更丰富的交互协议
- 更完整的 Agent 编排能力
- 优先保证最小链路稳定，再扩展能力
- 优先做通用能力，再做场景定制
- 保持 TypeScript 优先，降低理解和维护成本
- 避免过早引入复杂基础设施
- 每一阶段都应具备可验证的交付结果
目标：
让用户可以在飞书中稳定地向 LiteClaw 发消息，并拿到本地模型返回的回复。
重点能力：
- 飞书事件订阅接入
- 文本消息解析
- 本地模型调用
- 基础会话上下文
- 重复事件保护
- 健康检查与基础错误处理
交付物：
- 飞书长连接接入能力
POST /feishu/webhook兼容回退入口GET /healthz.env.local配置方式- README 与基础使用文档
完成标准：
- 能完成飞书私聊或群聊中的基础问答闭环
- 服务重启后不影响再次接入
- 对重复事件、空消息、非文本消息有明确兜底行为
目标：
在“能聊”的基础上，补齐一个轻量 Agent 所需的基础设施，让系统从 demo 走向可持续迭代。
重点能力：
- Redis 会话持久化
- 更完善的日志和错误分类
- 超时、重试、限流等稳定性治理
- 更清晰的命令路由，例如
/help、/reset
交付物：
- 可替换的 memory store
- 更清晰的 observability 基础
- 面向运维和调试的日志结构
- 明确的命令入口
当前进度：
- 已完成可替换的 store abstraction
- 已支持 Redis 会话持久化
- 已接入结构化日志和基础错误分类
- 已接入超时、重试和基础限流
- 已落地基础命令路由，后续仍可继续扩展
- Phase 2 核心骨架已基本完成，可开始承接 Phase 3 的能力扩展
完成标准：
- 重启服务后能保留近期会话状态
- 群聊场景中不会对所有消息误回复
- 常见异常可定位、可追踪、可复现
目标：
让 LiteClaw 从“会聊天”升级到“会执行受控动作”，开始接近 OpenClaw 的核心价值。
重点能力：
- Tool registry
- 工具调用协议
- 工具权限边界
- 工具执行结果回传
- 工具失败兜底与审计
优先级较高的工具方向：
- 文档查询
- 内部 API 调用
- 简单状态查询
- 受控命令执行
交付物：
- 标准化工具接口
- 工具调用日志
- 工具级错误处理
- 基础权限控制策略
当前进度：
- 已落地
tool registry - 已接入首个内置工具
local_status - 已通过
/status和/tools打通命令触发的最小工具闭环 - 模型自主选择工具仍是下一步
完成标准：
- 模型可在受控范围内可靠调用工具
- 工具调用结果能够进入后续回复链路
- 工具失败不会破坏主链路稳定性
目标：
把会话上下文升级为更长期、更结构化的记忆体系，使 LiteClaw 更接近长期协作型 Agent。
重点能力：
- 短期记忆与长期记忆分层
- 用户级和会话级状态管理
- 可归档的摘要机制
- 记忆裁剪与回收策略
交付物：
- 可持久化的 memory abstraction
- 摘要与压缩策略
- 明确的记忆生命周期设计
完成标准：
- 系统可以在多轮、多天甚至跨会话场景下保留有效信息
- 长上下文不会无限膨胀
- 记忆管理不会明显影响主链路延迟
目标：
让 LiteClaw 具备执行多步任务的能力，从单轮响应走向真正的 Agent workflow。
重点能力：
- 多步任务拆解
- 中间状态保存
- 任务恢复与重试
- 受控的 action pipeline
- 面向任务的反馈协议
交付物：
- task runtime
- 执行状态机
- 任务级日志和可观测性
- 多步执行结果汇总
完成标准：
- 能稳定执行多步任务而不是只返回单轮文本
- 任务中断后可恢复或明确失败
- 用户能理解任务当前进度和结果
目标：
逐步补齐更完整的 OpenClaw 核心能力，让 LiteClaw 不只是“一个小型聊天服务”，而是一个真正可演进的 OpenClaw 风格实现。
对齐方向：
- 更完整的 Agent 编排
- 更成熟的工具生态
- 更丰富的消息交互形式
- 更可控的权限和审计体系
- 更完善的任务和记忆协同
- 更强的可观测性与部署能力
长期愿景：
- 让 LiteClaw 既能保持轻量易懂，又能逐步承担 OpenClaw 所代表的复杂 Agent 工作流能力
以下内容不作为当前阶段优先目标：
- 为了“看起来完整”而一次性引入过多复杂基础设施
- 过早支持所有平台和所有消息协议
- 在基础稳定性不足时提前堆叠复杂 Agent 能力
如果按实际工程推进，推荐优先顺序是：
- Phase 2：先把稳定性和持久化补上
- Phase 3：继续扩展工具调用
- Phase 4：补齐长期记忆
- Phase 5：进入任务执行
- Phase 6：系统性向 OpenClaw 能力对齐