待办大师

Todo 技能 适用场景 需要在 OpenClaw 中维护本地待办，而不是依赖在线服务。 需要一个稳定的 Python 脚本入口，方便被代理或自动化直接调用。 需要让 技能 迭代升级时继续复用已有数据，而不是重建存储。 运行结构

脚本入口：

python3 ./todo-master/scripts/todo.py

主要文件：

./todo-master/config.json /todos.sqlite3 ./todo-master/requirements.txt

默认数据目录：

./todo-master/data 依赖说明

运行环境：

Python 3.10 或更高版本 当前实现仅依赖 Python 标准库，不需要额外第三方包

如需按统一流程安装，可执行：

python3 -m pip 安装 -r ./todo-master/requirements.txt

初始化

首次使用前必须先让用户确认数据目录：

python3 ./todo-master/scripts/todo.py init --default python3 ./todo-master/scripts/todo.py init --data-dir /absolute/existing/path

规则：

--default 会使用当前 技能 目录下的 data/ --data-dir 必须是一个已存在的绝对路径 未初始化前，除 init 和 show-config 外不要执行其他命令 命令说明

查看当前配置：

python3 ./todo-master/scripts/todo.py show-config

添加普通待办：

python3 ./todo-master/scripts/todo.py 添加 --title "准备周报" --content "汇总本周项目进展" --priority 4 python3 ./todo-master/scripts/todo.py 添加 --title "整理材料" --content "补齐投标附件" --priority 5 --due 2026-03-20 python3 ./todo-master/scripts/todo.py 添加 --title "联系客户" --content "确认下周演示时间" --priority 3 --due 2026-03-20T18:30

快速添加今日/明日待办：

python3 ./todo-master/scripts/todo.py 添加-today --title "回邮件" --content "回复合作方案" --priority 3 python3 ./todo-master/scripts/todo.py 添加-tomorrow --title "开复盘会" --content "准备会议提纲" --priority 4

查看今日待办（按今天到期）：

python3 ./todo-master/scripts/todo.py 列出-today python3 ./todo-master/scripts/todo.py 列出-today --json

查看全部待办：

python3 ./todo-master/scripts/todo.py 列出-all python3 ./todo-master/scripts/todo.py 列出-all --json python3 ./todo-master/scripts/todo.py 列出-all --状态 open --min-priority 4 python3 ./todo-master/scripts/todo.py 列出-all --keyword "周报" --limit 10 python3 ./todo-master/scripts/todo.py 列出-all --overdue

查看单条：

python3 ./todo-master/scripts/todo.py show --id python3 ./todo-master/scripts/todo.py show --id --json

更新、完成、重开、归档：

python3 ./todo-master/scripts/todo.py 更新 --id --title "新标题" --priority 5 python3 ./todo-master/scripts/todo.py 更新 --id --due 2026-03-21T18:00 python3 ./todo-master/scripts/todo.py 更新 --id --clear-due python3 ./todo-master/scripts/todo.py done --id python3 ./todo-master/scripts/todo.py reopen --id python3 ./todo-master/scripts/todo.py 归档 --id

查看统计：

python3 ./todo-master/scripts/todo.py stats

数据与升级规则 配置和数据分离：config.json 只保存数据目录和数据库文件名 SQLite 使用 PRAGMA user_version 管理 模式 版本 启动时会自动执行向前兼容的 迁移 若发现旧版 JSON 数据文件，会在首次打开 SQLite 时自动导入，避免已有数据丢失 不要手工修改 SQLite 文件 给代理的执行规则 新增待办时，title、content、priority 都必填 priority 只能是 1 到 5 列出-today 的语义是“今天到期的待办” 归档 是保留数据的软归档，不是物理删除 所有数据读写必须走 命令行工具，不要绕过脚本直接写数据库