名称： clawdbot-release-check
描述： 检查新的 clawdbot 版本，每个新版本仅通知一次。
主页： https://github.com/clawdbot/clawdbot
元数据： {"clawdbot":{"emoji":"🔄","requires":{"bins":["curl","jq"]}}}

Clawdbot 版本更新检查

从 GitHub 检查新的 clawdbot 版本，每个版本仅通知一次，避免重复提醒。

安装

clawdhub install clawdbot-release-check

快速设置（使用 cron）

# 每天上午 9 点检查更新，并通过 Telegram 通知
{baseDir}/scripts/setup.sh --telegram YOUR_TELEGRAM_ID

# 自定义检查时间（例如上午 8 点）
{baseDir}/scripts/setup.sh --hour 8 --telegram YOUR_TELEGRAM_ID

# 移除 cron 任务
{baseDir}/scripts/setup.sh --uninstall

设置完成后，重启网关服务：

launchctl kickstart -k gui/$(id -u)/com.clawdis.gateway

手动使用

# 检查更新（如果已是最新版本或已通知过，则静默运行）
{baseDir}/scripts/check.sh

# 显示版本信息
{baseDir}/scripts/check.sh --status

# 强制发送通知（绕过“已通知”状态）
{baseDir}/scripts/check.sh --force

# 显示所有错过的版本更新亮点
{baseDir}/scripts/check.sh --all-highlights

# 清除状态记录（下次检查时将再次通知）
{baseDir}/scripts/check.sh --reset

# 查看帮助
{baseDir}/scripts/check.sh --help

工作原理

1. 从 github.com/clawdbot/clawdbot/releases 获取最新版本信息
2. 与已安装版本（从 package.json 读取）进行比较
3. 如果版本落后，则显示版本说明中的亮点内容
4. 保存状态以防止重复通知

示例输出

🔄 **Clawdbot 有可用更新！**

当前版本：`2.0.0-beta5`
最新版本：`2026.1.5-3`

_(落后 3 个版本)_

**更新亮点：**
- 模型：新增图像专用模型配置
- 代理工具：新增 `image` 工具
- 配置：默认模型简写功能

🔗 https://github.com/clawdbot/clawdbot/releases/tag/v2026.1.5-3

更新方法：`cd /path/to/clawdis && git pull && pnpm install && pnpm build`

文件说明

状态文件 — ~/.clawdbot/clawdbot-release-check-state.json：

{
  "lastNotifiedVersion": "v2026.1.5-3",
  "lastCheckMs": 1704567890123
}

缓存文件 — ~/.clawdbot/clawdbot-release-check-cache.json：
- 版本数据缓存 24 小时（减少 API 调用）
- 每个版本的亮点内容仅提取一次（节省 token 使用）
- 使用 --clear-cache 强制刷新缓存

配置选项

环境变量：
- CLAWDBOT_DIR — clawdbot 源代码路径（自动检测 ~/dev/clawdis、~/clawdbot 或 npm 全局安装目录）
- CACHE_MAX_AGE_HOURS — 缓存有效期（小时），默认为 24 小时