# clawd-news

> Track GitHub release news for Clawdbot/OpenClaw-related repos and output clean summaries. Use for monitoring one or more GitHub repositories for new releases, fetching release details, formatting markdown summaries, and marking releases as seen.

- Author: Henry
- Repository: whoknowsmann/clawd-news
- Version: 20260131095709
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/whoknowsmann/clawd-news
- Web: https://mule.run/skillshub/@@whoknowsmann/clawd-news~clawd-news:20260131095709

---

---
name: clawd-news
description: "Track GitHub release news for Clawdbot/OpenClaw-related repos and output clean summaries. Use for monitoring one or more GitHub repositories for new releases, fetching release details, formatting markdown summaries, and marking releases as seen."
metadata:
  clawdbot:
    emoji: "📰"
    requires:
      bins: ["gh", "jq"]
---

# clawd-news

## Overview

Monitor GitHub releases across multiple repos, summarize new releases, and persist last-seen state with safe, atomic JSON writes.

## Configuration

- Pass one or more `--repo owner/name` flags.
- If no `--repo` flags are provided, read `CLAWD_NEWS_REPOS` (comma-separated).
- If neither is set, default to `clawdbot/clawdbot`.
- Include prereleases by passing `--include-prereleases`.
- Override the state file path with `--state-file <path>` (defaults to `state/last-seen.json`).

## Script usage

- `scripts/check-releases.sh` → check configured repos for new releases.
- `scripts/get-release.sh` → fetch full release details for a tag or `latest`.
- `scripts/format-summary.sh` → read release JSON from stdin and output markdown.
- `scripts/mark-seen.sh` → mark a release as seen.

### Manual usage examples

```bash
scripts/check-releases.sh | jq
scripts/check-releases.sh --repo clawdbot/clawdbot --repo openclaw/openclaw | jq
scripts/get-release.sh --repo clawdbot/clawdbot latest | scripts/format-summary.sh
scripts/get-release.sh --repo clawdbot/clawdbot latest | scripts/mark-seen.sh --from-json | jq
```

## State management

- State lives at `state/last-seen.json` unless overridden with `--state-file`.
- Validate JSON before reading or writing with `jq -e .`.
- Write state atomically (write temp file, validate JSON, then `mv`).
- `check-releases.sh` updates only `lastCheck`.
- `mark-seen.sh` updates the per-repo `lastReleaseTag`, `lastReleasePublishedAt`, and `lastCheck`.
- Treat missing state files as empty defaults.

## Example agent workflow

1. Run `scripts/check-releases.sh` to detect new releases.
2. For each new release, call `scripts/get-release.sh --repo <owner/name> <tag>`.
3. Pipe the result to `scripts/format-summary.sh` for a markdown summary.
4. After posting the summary, call `scripts/mark-seen.sh --from-json` to update state.