Clawdbot Release Check

核心功能

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 访问依赖网络连通性，企业内网需配置代理
• 状态文件明文存储于用户目录，虽无敏感数据但需注意备份

核心用法

clawdbot-release-check 是 Clawdbot 官方维护的轻量级版本检查 Skill，专为 Clawdbot 用户设计。它每日自动查询 GitHub API 获取最新发布版本，与本地安装的版本对比，若存在更新则展示 Release Notes 中的关键更新亮点，且每个版本仅通知一次，避免骚扰式推送。

安装后通过 setup.sh 配置 cron 定时任务（支持自定义时间和 Telegram 推送），或手动执行 check.sh 进行即时检查。提供 --force 强制通知、--all-highlights 查看所有未读版本更新、--reset 清除通知状态等实用选项。

显著优点

1. 官方出品，来源可信：由 Clawdbot 核心团队维护，GitHub 组织账号认证，代码透明开源，符合 T1 最高可信度标准。

2. 功能极简，攻击面小：仅 392 行代码，2 个核心脚本，零第三方依赖，仅使用系统预装的 curl 和 jq，无供应链攻击风险。

3. 智能状态管理：本地 JSON 文件记录已通知版本和检查时间，24 小时缓存机制减少 API 调用，既节省资源又避免重复打扰。

4. 隐私友好：所有数据本地存储于 ~/.clawdbot/，仅收集版本号等公开元数据，无敏感信息上传，完全符合 GDPR 数据最小化原则。

5. 输出友好：自动提取 Release Notes 中的 Highlights，附带升级命令提示，降低用户更新门槛。

潜在局限

• 功能单一：仅支持 Clawdbot 自身的版本检查，无法泛化用于其他项目。
• 网络依赖：需稳定访问 api.github.com，部分网络受限环境可能失效。
• 通知渠道有限：原生仅支持终端输出和 Telegram，无邮件/Slack/Discord 等内置集成。
• 缓存延迟：默认 24 小时缓存，紧急安全更新可能存在感知延迟（可手动 --clear-cache 刷新）。

适合人群

• Clawdbot 重度用户：希望第一时间获取新功能和安全修复
• 服务器运维人员：管理多台 Clawdbot 实例，需要集中化更新监控
• 注重安全的开发者：偏好最小权限、零依赖、可审计的工具

常规风险

经 CLS-Certify 完整扫描，该 Skill 无高危安全威胁。唯一需关注的低危项是外部网络请求（GitHub API），但目标可信且 HTTPS 加密。建议生产环境配置请求超时参数以提升健壮性。