Suiji

随记 - 轻量任务管理。用自然语言记录任务，自动定时推送，Telegram 按钮一键操作。

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

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

---

它能做什么？

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

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

---

怎么安装？

前提条件

• 已安装 OpenClaw

一键安装

clawhub install suiji

配置

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

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

按提示操作：

1. 配置 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 不工作怎么办？

1. 检查 Cron 状态：crontab -l
2. 手动测试推送：python3 push.py morning
3. 查看系统日志：grep CRON /var/log/syslog
4. 检查 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

推送处理逻辑：

1. Cron 执行 push.py，生成推送消息
2. push.py 写入 ~/.openclaw/workspace/tasks/pending_push.json
3. OpenClaw 检测到文件后，调用 message 工具发送格式化推送（带按钮）到 Telegram
4. 用户可在推送消息下直接回复（如"完成 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 按钮交互
• 定时推送
• 智能备注
• 周期任务
• 时间冲突检测

---

联系与反馈

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

• 邮箱：[e-mail]
• WhatsApp：[phone]
• Telegram：[phone]
• 微信：guesslu