核心用法
openclaw-todo 是一款面向 OpenClaw 框架的本地 TODO 管理插件,通过命令行方式操作单一的 Markdown 文件(默认路径 ~/.openclaw/workspace/TODO.md)。用户可通过 /todo-add 创建任务,支持 #标签、!优先级 和 @due(YYYY-MM-DD) 三种内联标记;/todo-list 按逾期优先排序展示未完成任务;/todo-done、/todo-edit、/todo-remove 分别用于状态变更、内容修改与删除;/todo-search 则提供基于文本、标签、优先级、截止日期及特殊筛选词(@overdue、@today)的检索能力。
显著优点
- 零外部依赖:纯本地文件操作,无需 API 密钥或网络连接,隐私性极强
- Markdown 原生:任务数据以标准 Markdown 存储,可读可手动编辑,便于版本控制
- 标记系统灵活:标签、优先级、截止日期三位一体,满足轻量级 GTD 需求
- 逾期优先排序:自动将逾期任务置顶,强化时间管理
- 路径可配置:通过
openclaw.json自定义存储位置,适应多工作区场景
潜在缺点与局限性
- 单文件架构:所有任务集中于一个文件,数据量大时性能与可读性下降
- 无协作能力:缺乏同步机制,无法支持多用户或跨设备实时协作
- 索引功能有限:检索依赖线性扫描,复杂查询效率有限
- 无提醒机制:逾期任务仅视觉高亮,无系统级通知或邮件提醒
- 优先级仅三级:
!high/medium/low粒度较粗,难以适应精细优先级策略
适合人群
- 偏好本地优先、隐私敏感的个人开发者
- 需要轻量级任务追踪而不愿部署复杂系统的技术用户
- 已将工作流构建于 OpenClaw 生态的现有用户
常规风险
- 数据丢失风险:本地单文件存储,若无备份策略(如 Git),误删或磁盘故障将导致不可恢复损失
- 并发写入冲突:多进程同时操作同一文件可能引发写入覆盖(OpenClaw 框架需自行保障文件锁机制)
- 路径遍历隐患:若配置路径未做严格校验,存在被诱导写入敏感目录的理论风险
- 无加密存储:任务内容以明文 Markdown 保存,敏感信息需自行加密处理