随记 (Suiji) - 轻量任务管理

注意：本 Skill 的按钮交互功能仅在 Telegram 上可用。其他渠道仅支持文本交互。

它能做什么？

用自然语言记录任务，系统自动帮你：

智能解析时间 — "明天上午 10 点"、"下周一"、"4 月 18 日" 都能理解
自动定时推送 — 每天 8:30 提醒你今日任务，15:30 汇报进度 + 明日预览
一键快捷操作 — Telegram 推送消息带按钮，点一下就能标记完成
智能备注 — 说"看医生"自动提醒你带病历本，说"开会"提醒准备材料
周期任务 — "每天吃药"、"每周一晨会" 自动循环
时间冲突检测 — 同一时间段有任务会主动提醒

怎么安装？

前提条件

已安装 OpenClaw

一键安装

clawhub install suiji

配置

安装后运行配置向导（自动配置 Cron）：

cd ~/.openclaw/workspace/skills/suiji
bash install.sh

按提示操作：

配置 Cron（推荐，自动启用定时推送）

Cron 会自动配置：

每天 8:30 → 早间推送
每天 15:30 → 下午推送

无需配置 Bot Token：随记使用 OpenClaw 主 Bot 推送，复用你正在聊天的这个 Bot！

启用

编辑 ~/.openclaw/config.json，添加 suiji 到 skills 列表：

{
  "skills": ["suiji"]
}

重启 OpenClaw：

openclaw restart

Telegram 按钮操作

这是本 Skill 的核心体验！

早间推送 (8:30)

📅 早安！今天是 4 月 17 日 周五

📋 今日任务 (3 项)
🕐 10:00 团队会议
🕐 14:00 提交代码
🕐 16:00 客户电话

[✅ 10:00] [✅ 14:00] [✅ 16:00]
[✅ 全部完成] [➕ 添加任务]

下午推送 (15:30)

📊 下午好！今日进度 1/4

⚠️ 逾期任务 (1 项)
14:00 提交代码 (已逾期 1.5h)

📋 今日剩余 (2 项)
🕐 16:00 客户电话
🕐 18:00 健身

[✅ 提交代码] [✅ 客户电话]
[✅ 全部完成] [➕ 添加任务]

按钮功能：

✅ [时间] — 点一下标记该任务完成
✅ 全部完成 — 一键完成今日所有任务
➕ 添加任务 — 快速添加新任务

使用示例

添加任务

随记 明天 10:00 团队会议
随记 每天 8:00 吃药
随记 周五 14:00 看医生 - 带病历本
随记 每周一 9:00 晨会

智能备注

系统会自动根据任务内容添加提醒：

| 你说 | 自动备注 | |------|---------| | 看医生/医院 | 带病历本、医保卡 | | 开会/会议 | 准备材料、预定会议室 | | 健身/运动 | 带运动装备、水杯 | | 出差/旅行 | 带身份证、充电宝 | | 面试 | 带简历、作品集 | | 考试 | 带准考证、文具 |

查询任务

随记列表 今天      # 查看今日任务
随记列表 明天      # 查看明日任务
随记列表 本周      # 查看本周任务
随记帮助          # 显示完整帮助

标记完成

完成 团队会议       # 标记特定任务完成
✅ 10:00 团队会议   # 或者用按钮

导出备份

随记导出 2026-04   # 导出月度任务 (CSV)
随记备份          # 手动备份

定时推送

Cron 自动配置（安装时自动询问）：

# 早间推送 - 每天 8:30
30 8 * * * cd /root/.openclaw/workspace/skills/suiji && python3 push.py morning

# 下午推送 - 每天 15:30
30 15 * * * cd /root/.openclaw/workspace/skills/suiji && python3 push.py afternoon

手动配置（如安装时跳过）：

crontab -e
# 添加上面两行

验证 Cron：

crontab -l  # 查看当前 Cron

测试推送：

cd /root/.openclaw/workspace/skills/suiji
python3 push.py morning   # 测试早间推送
python3 push.py afternoon # 测试下午推送

推送内容：

| 推送 | 时间 | 内容 | |------|------|------| | 早间 | 8:30 | 今日任务 + 完成按钮 | | 下午 | 15:30 | 今日剩余 + 明日预览 + 完成按钮 |

数据存储

任务存储在本地：

~/.openclaw/workspace/tasks/
├── 2026-04.md          # 月度任务文件
├── 2026-05.md
├── backup/             # 自动备份
│   └── 2026-04.backup.csv
└── config.json         # 配置文件

隐私保证：所有数据存在你的服务器，不会上传到外部。

常见问题

Q: 只能在 Telegram 上用吗？

核心功能（记录任务、推送）在所有渠道都可用，但按钮交互仅在 Telegram 支持。其他渠道用文本命令操作。

Q: 可以多人使用吗？

当前版本支持单用户。多用户版本开发中。

Q: Cron 不工作怎么办？

检查 Cron 状态：crontab -l
手动测试推送：python3 push.py morning
查看系统日志：grep CRON /var/log/syslog
检查 pending_push.json：cat ~/.openclaw/workspace/tasks/pending_push.json

触发器

消息触发

关键词：随记 或 sj

示例：

随记明天 10 点开会
sj 每天 8 点吃药
随记 4 月 20 日提交报告

推送触发

Cron 定时触发（每天 8:30 和 15:30）：

30 8 * * * cd /root/.openclaw/workspace/skills/suiji && python3 push.py morning
30 15 * * * cd /root/.openclaw/workspace/skills/suiji && python3 push.py afternoon

推送处理逻辑：

Cron 执行 push.py，生成推送消息
push.py 写入 ~/.openclaw/workspace/tasks/pending_push.json
OpenClaw 检测到文件后，调用 message 工具发送格式化推送（带按钮）到 Telegram
用户可在推送消息下直接回复（如"完成 10:00 会议"）

推送消息格式：

{
  "type": "suiji_push",
  "push_type": "morning|afternoon",
  "text": "格式化文本",
  "buttons": [...],
  "timestamp": "ISO-8601"
}

手动触发推送：

python3 /root/.openclaw/workspace/skills/suiji/push.py morning

OpenClaw 会自动检测并发送到你当前的 Telegram 会话。

版本历史

v1.0.7 (2026-04-19)

🎉 修复自动推送：push.py 执行后自动触发 OpenClaw 处理
✅ Cron 执行后立即发送推送（无需等待）
✅ 失败时有备份机制（pending_push.json）
优化推送触发流程

v1.0.6 (2026-04-18)

🎉 重大更新：通过 OpenClaw 主 Bot 推送
✅ 无需配置 Bot Token 和 Chat ID
✅ 推送消息下可直接回复交互
✅ 简化安装流程
优化推送处理逻辑

v1.0.5 (2026-04-17)

重新发布，修复 ClawHub 显示问题

v1.0.4 (2026-04-17)

修复代码块背景色问题（改用缩进文本）
优化 ClawHub 网站阅读体验

v1.0.3 (2026-04-17)

优化可读性（加粗重点、换行清晰）
修复核心体验部分字体颜色问题
更新联系方式

v1.0.2 (2026-04-17)

新增 push.py 推送脚本
安装脚本自动配置 Cron
文档更新 Cron 配置说明
优化时间解析逻辑

v1.0.1 (2026-04-16)

首次发布
智能时间解析
Telegram 按钮交互
定时推送
智能备注
周期任务
时间冲突检测

联系与反馈

遇到问题或有建议？欢迎联系：

邮箱：guesslu@126.com
WhatsApp：+1 3366717804
Telegram：+86 13661604516
微信：guesslu