Github Workflow

Name: Github Workflow
Rating: 3.5 (1 reviews)
Author: chris-openclaw

By chris-openclaw 👁 46 views ▲ 0 votes

OpenClaw plugin: GitHub PR review, issue triage, release notes, weekly digest

GitHub

Install

openclaw plugins install @chris-openclaw/github-workflow

Configuration Example

{
  "plugins": {
    "github-workflow": {
      "auth": {
        "method": "pat",
        "tokenEnv": "GITHUB_TOKEN"
      },
      "defaultRepos": [
        "chris-openclaw/ministry-weekly",
        "chris-openclaw/podcast-pipeline"
      ]
    }
  }
}

README

# GitHub Workflow

An OpenClaw plugin that manages your GitHub work without leaving your AI assistant. Pull requests to review, issues to triage, release notes to draft, weekly digests of what shipped — all in one place.

**Current version: 0.1.0** (early release)

## What it does

Five agent tools, all surfaced to the LLM:

| Tool | What it does |
|---|---|
| `github_list_review_prs` | Lists open PRs across your configured repos where you've been requested as a reviewer. Sorted by age, with risk hints from PR titles. |
| `github_summarize_pr` | Summarizes a specific PR: what changed, risk signals (auth/migrations/public APIs), file groupings, and 3-5 suggested review questions. |
| `github_triage_issues` | Surfaces stale, un-triaged, high-heat, and assigned-to-you issues in a repo. |
| `github_release_notes` | Generates release notes between any two refs (tags, branches, SHAs). Three styles: Keep-a-Changelog, simple, or Conventional Commits. |
| `github_weekly_digest` | Cross-repo digest: what shipped this week, what's still open, what issues need attention. |

## Why this plugin

OpenClaw has plenty of plugins that observe your AI agent's behavior. This plugin observes *your* GitHub work and gives the agent the data it needs to actually help. The companion skill (`github-workflow`) teaches the agent when to call which tool and how to format the results.

## Installation

### 1. Set up authentication

Create a GitHub Personal Access Token at [github.com/settings/tokens](https://github.com/settings/tokens) with these scopes:

- `repo` (for private repos) or `public_repo` (for public-only)
- `read:user` (so the plugin knows who "you" are when listing review requests)

Set the token in your environment:

**macOS/Linux** (in `~/.bashrc` or `~/.zshrc`):
```bash
export GITHUB_TOKEN=ghp_yourTokenHere
```

**Windows (PowerShell, system-level)**:
```powershell
[Environment]::SetEnvironmentVariable("GITHUB_TOKEN", "ghp_yourTokenHere", "User")
```

Restart your terminal (and the OpenClaw gateway) after setting it.

### 2. Install the plugin

```bash
openclaw plugins install @chris-openclaw/github-workflow
```

Or install from a local clone for development (see DEVELOPMENT.md).

### 3. Configure default repos

In your OpenClaw config:

```jsonc
{
  "plugins": {
    "github-workflow": {
      "auth": {
        "method": "pat",
        "tokenEnv": "GITHUB_TOKEN"
      },
      "defaultRepos": [
        "chris-openclaw/ministry-weekly",
        "chris-openclaw/podcast-pipeline"
      ]
    }
  }
}
```

The `defaultRepos` list is what the cross-repo tools (`github_list_review_prs`, `github_weekly_digest`) use when you don't override them in the call.

### 4. Restart the gateway

```bash
openclaw gateway restart
```

You should see `[github-workflow] Registered 5 tools. Default repos: N. Auth: OK.` in the gateway logs.

## Usage

The agent automatically picks the right tool based on what you ask:

> "What PRs am I supposed to review?"
> → calls `github_list_review_prs`

> "Summarize PR #42 in the ministry-weekly repo."
> → calls `github_summarize_pr`

> "Triage open issues in chris-openclaw/podcast-pipeline. Anything stale?"
> → calls `github_triage_issues`

> "Generate release notes for ministry-weekly between v1.0.0 and v1.1.0."
> → calls `github_release_notes`

> "What shipped across my repos this week?"
> → calls `github_weekly_digest`

## What's coming in v0.2

- GitHub App authentication (in addition to PATs)
- `github_post_review` with explicit approval gating
- Auto-detection of repos from the authenticated user's account
- Per-file commentary on the largest changes (better `depth: "deep"` mode)
- Webhook receiver so the agent can react to PR events in real time
- Multi-page issue triage for large repos

See [CHANGELOG.md](CHANGELOG.md) for the full release history.

## Limits

- v0.1.0 is read-only. The plugin never posts comments, merges PRs, or modifies code.
- Token-bound: only sees repos the configured token can access.
- No webhook listener yet — all operations are on-demand.

## Plugin metadata

| Field | Value |
|---|---|
| ID | `github-workflow` |
| Version | 0.1.0 |
| Author | Chris Case ([chris-openclaw](https://github.com/chris-openclaw)) |
| Capabilities | Agent tools (5) |
| OpenClaw min version | 5.0.0 |
| Companion skill | `github-workflow` (shipped in plugin) |

tools