back
loading skill details...
随记 - 轻量任务管理。用自然语言记录任务，自动定时推送，Telegram 按钮一键操作。
---
name: suiji
description: 随记 - 轻量任务管理。用自然语言记录任务，自动定时推送，Telegram 按钮一键操作。
author: Clawdbot
version: 1.0.6
license: MIT
tags: [task, reminder, telegram, productivity]
---
# 随记 (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 会议"）
**推送消息格式**：
```json
{
"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
don't have the plugin yet? install it then click "run inline in claude" again.