Clawdbot Release Check

Check for new clawdbot releases and notify once per new version.

Checks for new clawdbot releases from GitHub and notifies you once per version. No nagging.

Installation

bash

clawdhub install clawdbot-release-check

Quick Setup (with cron)

bash

# Add daily update check at 9am, notify via Telegram
{baseDir}/scripts/setup.sh --telegram YOUR_TELEGRAM_ID

# Custom hour (e.g., 8am)
{baseDir}/scripts/setup.sh --hour 8 --telegram YOUR_TELEGRAM_ID

# Remove cron job
{baseDir}/scripts/setup.sh --uninstall

After setup, restart the gateway:

bash

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

Manual Usage

bash

# Check for updates (silent if up-to-date or already notified)
{baseDir}/scripts/check.sh

# Show version info
{baseDir}/scripts/check.sh --status

# Force notification (bypass "already notified" state)
{baseDir}/scripts/check.sh --force

# Show highlights from ALL missed releases
{baseDir}/scripts/check.sh --all-highlights

# Clear state (will notify again on next check)
{baseDir}/scripts/check.sh --reset

# Help
{baseDir}/scripts/check.sh --help

How It Works

1. Fetches latest release from github.com/clawdbot/clawdbot/releases
2. Compares with your installed version (from package.json)
3. If behind, shows highlights from release notes
4. Saves state to prevent repeat notifications

Example Output

text

🔄 **Clawdbot Update Available!**

Current: `2.0.0-beta5`
Latest:  `2026.1.5-3`

_(3 versions behind)_

**Highlights:**
- Models: add image-specific model config
- Agent tools: new `image` tool
- Config: default model shorthands

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

To update: `cd /path/to/clawdis && git pull && pnpm install && pnpm build`

Files

State — ~/.clawdbot/clawdbot-release-check-state.json:

json

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

Cache — ~/.clawdbot/clawdbot-release-check-cache.json:

• Release data cached for 24 hours (saves API calls)
• Highlights extracted once per release (saves tokens)
• Use --clear-cache to force refresh

Configuration

Environment variables:

• CLAWDBOT_DIR — Path to clawdbot source (auto-detected from ~/dev/clawdis, ~/clawdbot, or npm global)
• CACHE_MAX_AGE_HOURS — Cache TTL in hours (default: 24)