---

name: todo-tracker-safe description: Secure TODO tracker with input validation and safe file operations. Use for task management across sessions. homepage: https://github.com/openclaw/openclaw metadata: openclaw: emoji: "📋" requires: bins: ["bash", "grep", "awk", "sed"]

📋 TODO Tracker (安全版本)

安全的跨会话任务追踪工具，带有输入验证和安全文件操作。

安全改进

相比原始版本，此版本包含以下安全增强：

1. 输入验证 - 所有用户输入经过 sanitize_input() 过滤
2. 固定字符串匹配 - 使用 grep -F 避免正则注入
3. 文件权限检查 - 验证 TODO 文件权限不过于宽松
4. 无动态执行 - 不使用 eval 或命令替换执行用户输入
5. 错误处理 - 使用 set -euo pipefail 严格模式
6. 长度限制 - 输入限制为 200 字符

用法

# 添加任务
todo.sh add high "完成项目报告"
todo.sh add medium "回复邮件"
todo.sh add low "整理文件"

# 标记完成
todo.sh done "项目报告"

# 删除任务
todo.sh remove "整理文件"

# 列出任务
todo.sh list          # 全部
todo.sh list high     # 高优先级
todo.sh list done     # 已完成

# 摘要（用于 heartbeat）
todo.sh summary

配置

• TODO_FILE - 自定义 TODO 文件路径（默认：~/.openclaw/workspace/TODO.md）

触发条件

当用户说：

• "添加到 TODO" / "add to TODO"
• "标记 X 完成" / "mark X done"
• "TODO 列表" / "TODO list"
• "还有什么任务" / "what's on the TODO"
• 心跳时自动显示摘要

安全审计

• ✅ 无外部 API 调用
• ✅ 无网络请求
• ✅ 无环境变量读取（除 TODO_FILE）
• ✅ 无动态代码执行
• ✅ 输入经过严格过滤
• ✅ 文件操作有权限检查