核心功能
clawdbot-release-check 是一款面向 clawdbot 用户的轻量级版本监控工具，专注于解决"反复检查更新"的痛点。它通过 GitHub API 抓取最新 release 信息，与本地安装的版本比对，仅在新版本首次出现时推送通知，避免重复打扰。
显著优点
去重通知机制：核心亮点是"once per new version"状态管理。通过本地 JSON 状态文件记录已通知版本，即使多次运行脚本，同一版本不会二次提醒，显著降低用户认知负担。
智能缓存策略：24 小时 API 缓存减少 GitHub 请求频率，release notes 高亮点提取结果也持久化复用，兼顾实时性与 API 配额保护。
灵活的集成方式：内置 cron 设置脚本一键部署定时任务，支持 Telegram Bot 推送；同时保留完整的手动 CLI 接口，满足调试与自动化需求。
多版本追赶支持：--all-highlights 可展示所有遗漏版本的更新摘要，对长期未更新的用户尤其友好。
潜在局限
- 生态绑定：仅服务于 clawdbot 单一项目，不具备通用 GitHub release 监控能力
- 依赖外部工具：需要
curl和jq，在精简环境可能需额外安装 - macOS 生态导向：
launchctl重启指令暗示主要面向 macOS，Linux/Windows 用户需手动适配 - 状态文件本地存储：多设备同步使用时可能出现通知状态不一致
适合人群
clawdbot 的活跃用户，尤其是希望"安装后忘记更新检查"、偏好被动接收通知而非主动查询的开发者。也适合在服务器/网关设备上长期部署，保持工具链及时跟进上游。
常规风险
- 脚本执行权限与 cron 配置可能引入本地权限管理问题
- GitHub API 访问依赖网络连通性，企业内网需配置代理
- 状态文件明文存储于用户目录，虽无敏感数据但需注意备份