GitHub Triage#

Review GitHub repositories, group issues and pull requests by urgency, and take safe triage actions after confirmation.

This skill uses ClawLink for hosted GitHub access so the user does not need separate API setup.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect GitHub_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect GitHub

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   GitHub API     │
│   (User Chat)   │     │   (OAuth)    │     │   (REST/GraphQL) │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. Install Plugin    │                       │
         │  2. Pair Device       │                       │
         │  3. Connect GitHub    │                       │
         │                       │  4. Secure Token      │
         │                       │  5. Proxy Requests    │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ Dashboard│           │ GitHub   │
   │  File    │           │ Auth     │           │ Issues   │
   └──────────┘           └──────────┘           └──────────┘

Good Trigger Phrases#

• "Triage my GitHub issues"
• "Review open PRs and tell me what needs attention"
• "Find stale GitHub issues and propose actions"
• "Summarize what needs maintainer action in this repo"
• "Label and comment on these issues after I confirm"

Install#

Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Then tell the user: "OpenClaw has been restarted. Send /new as a standalone message to start a fresh chat, then ask for GitHub triage again."

Quick Start#

bash

# List open issues in a repository
clawlink_call_tool --tool "github_list_issues_for_a_repository" \
  --params '{"owner": "owner", "repo": "repo-name", "state": "open", "sort": "created", "direction": "desc"}'

# Get a specific issue
clawlink_call_tool --tool "github_get_an_issue" \
  --params '{"owner": "owner", "repo": "repo-name", "issue_number": 123}'

Authentication#

All GitHub tool calls are authenticated automatically by ClawLink using the user's connected GitHub account.

No API key is required in chat. ClawLink stores the OAuth token securely and injects it into every GitHub API request on the user's behalf.

Getting Connected#

1. Install the ClawLink plugin (see Install above).
2. Pair the plugin with clawlink_begin_pairing if it is not configured yet.
3. Open https://claw-link.dev/dashboard?add=github and connect GitHub.
4. Call clawlink_list_integrations to verify the connection is active.

Connection Management#

List Connections#

bash

clawlink_list_integrations

Response: Returns all connected integrations. Look for github in the list.

Verify Connection#

bash

clawlink_list_tools --integration github

Response: Returns the live tool catalog for GitHub.

Reconnect#

If GitHub tools are missing or the connection shows an error:

1. Direct the user to https://claw-link.dev/dashboard?add=github
2. After they confirm, call clawlink_list_integrations to verify
3. Then call clawlink_list_tools --integration github

Triage Workflow#

1. Define the Triage Scope#

Ask for:

• repo or org
• issues, pull requests, or both
• time range if needed
• what counts as urgent
• whether the user wants only a report or also wants actions applied

If the user is vague, default to a report first.

2. Gather the Current State#

Use GitHub read tools first to inspect:

• open issues
• open pull requests
• recent comments
• labels
• review status
• failed workflows
• stale items

Do not jump into writing comments or changing labels before you have a clear picture.

3. Group Items into Clear Buckets#

A good triage summary usually groups items into:

• needs reply
• needs review
• blocked
• stale
• merge-ready
• failing CI
• low-priority backlog

Explain why each item belongs in that bucket.

4. Propose Actions Before Making Changes#

Examples:

• add or normalize labels
• leave a maintainer follow-up comment
• identify issues safe to close
• summarize PRs that need review
• flag failing workflow runs

Prefer a short action plan before editing anything.

5. Discover the Live GitHub Tools#

1. Call clawlink_list_integrations to confirm GitHub is connected.
2. Call clawlink_list_tools with integration github.
3. If the exact action tool is unclear, call clawlink_search_tools with short queries such as list issues, comment issue, update labels, or pull requests.
4. Call clawlink_describe_tool before any write or unfamiliar operation.
5. Use the returned schema and guidance as the source of truth.

6. Preview and Confirm Writes#

For any write action:

1. Show the exact intended action first.
2. Use clawlink_preview_tool when available.
3. Ask for confirmation before commenting, relabeling, closing, reopening, or editing metadata.
4. Execute with clawlink_call_tool only after confirmation.

Triage Operations#

Read Operations (Safe — no confirmation needed for read-only triage)#

ToolDescriptiongithub_list_issues_for_a_repositoryList issues with filtering by state, labels, assigneegithub_get_an_issueGet issue details, body, commentsgithub_list_pull_requestsList PRs with filteringgithub_get_a_pull_requestGet PR details, review statusgithub_list_repository_workflowsList CI/CD workflowsgithub_list_workflow_runsList recent workflow runsgithub_get_a_commitInspect commit details

Write Operations (Require confirmation before executing)#

ToolDescriptionConfirmationgithub_add_labels_to_an_issueAdd labels to categorize issuesConfirmgithub_add_assignees_to_an_issueAssign users to issuesConfirmgithub_create_an_issueCreate a new issue for triaged itemsConfirmgithub_add_a_comment_to_an_issuePost a comment on an issueConfirmgithub_update_an_issueClose, reopen, or update issue fieldsConfirm

Code Examples#

List and triage open issues#

bash

clawlink_call_tool --tool "github_list_issues_for_a_repository" \
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "state": "open",
    "sort": "created",
    "direction": "desc",
    "per_page": 50
  }'

Get issue details for triage assessment#

bash

clawlink_call_tool --tool "github_get_an_issue" \
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "issue_number": 123
  }'

Add triage labels after confirmation#

bash

clawlink_call_tool --tool "github_add_labels_to_an_issue" \
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "issue_number": 123,
    "labels": ["triage", "needs-review"]
  }'

Good Workflow Behavior#

• Prefer read-first triage and short reports before writes.
• Quote or summarize the evidence behind recommendations.
• If a repo has many items, start with the most urgent or the top 10.
• Avoid aggressive closure suggestions unless the repo norms are clear.
• If there is uncertainty, propose a draft comment instead of posting immediately.

Rules#

• Always use ClawLink tools for GitHub actions. Do not ask for separate GitHub credentials.
• Do not invent GitHub tool names or schemas. Use the live ClawLink catalog in the current turn.
• Ask for confirmation before comments, label changes, issue closure, metadata edits, or other writes.
• Prefer reporting and recommendation before taking triage actions.
• If GitHub is not connected, direct the user to https://claw-link.dev/dashboard?add=github.

Example Prompts#

• Review open issues in this repo and group them by urgency.
• Triage my pull requests and tell me which ones need review, which are blocked, and which are merge-ready.
• Find stale issues in this repo, draft comments for them, and wait for my confirmation.
• Check the last 20 issues in this repository and propose labels for each one.

Resources#

• GitHub REST API
• GitHub GraphQL API
• ClawLink
• ClawLink Docs
• ClawLink Verification

---

Powered by ClawLink — an integration hub for OpenClaw