核心用法
Task Runner 是一款面向多会话场景的任务管理工具,通过命令行接口实现任务的增删改查与导出。核心操作包括:add 创建任务(支持项目分组与三级优先级)、list 按项目筛选或全局查看、complete 标记完成、priority 动态调整优先级、export 导出项目为 Markdown 报告。任务数据持久化存储于 ~/.openclaw/workspace/tasks_db.json,会话重启后自动恢复。
显著优点
- 持久化设计:JSON 本地存储确保任务状态跨会话无损保留,适合长期项目跟踪
- 项目化组织:支持按项目聚合任务,便于多线并行管理
- 灵活导出:Markdown 格式导出含任务统计、时间戳、优先级标记,便于归档与汇报
- 安全加固:v1.0.1+ 引入路径白名单机制,限制导出目录为
~/.openclaw/workspace/、/tmp/及 home 目录,阻断系统关键路径与敏感 dotfile 写入,有效防御提示注入导致的权限提升攻击
潜在局限
- 无协作功能:单机 JSON 存储不支持多用户同步或云端备份
- 依赖文件系统权限:若工作目录权限受限,可能导致存储或导出失败
- 无内置提醒机制:需主动查询,缺乏到期提醒或通知推送
- 搜索能力有限:仅支持按项目过滤,无全文检索或标签系统
适合人群
- 需要跨多次对话维持项目状态的 AI Agent 开发者
- 进行多实验并行跟踪的研究人员
- 追求轻量级 CLI 任务管理的个人开发者
- 需要定期生成进度报告的敏捷团队
常规风险
- 数据丢失风险:JSON 文件损坏或未备份时可能导致任务历史丢失
- 路径绕过风险:虽有白名单校验,但若运行环境对
/tmp或 home 目录有特殊软链接配置,仍需谨慎验证实际写入位置 - 隐私泄露风险:任务描述内容明文存储,敏感信息应避免写入任务详情