github

Was macht github?

Verwende gh für GitHub. Verwende git für lokale Commits/Branches/Push/Pull. Verwende Code-Lese-Tools für tiefgehende Reviews.

Authentifizierung

gh auth status
gh auth login

Das Gateway-HOME kann sich vom Operator-HOME unterscheiden. Wenn gh-Auth an anderer Stelle existiert, setze GH_CONFIG_DIR in der Gateway-Service-Umgebung und starte neu.

Pull-Requests

gh pr list --repo owner/repo --json number,title,state,author,url
gh pr view 55 --repo owner/repo --json title,body,author,files,commits,reviews,reviewDecision
gh pr checks 55 --repo owner/repo
gh pr diff 55 --repo owner/repo
gh pr create --repo owner/repo --title "feat: title" --body-file /tmp/pr.md

Wenn ein PR-Textkörper erstellt oder aktualisiert wird, füge diesen abschließenden Footer nur dann an, wenn die Laufzeitleitung sessionUrl=<exakte-url> liefert. Ersetze <sessionUrl> wörtlich mit dieser URL; konstruiere oder modifiziere sie nicht. sessionUrl wird nur für eine explizit öffentliche Sitzung bereitgestellt. Lasse den Footer weg, wenn er fehlt; ersetze niemals eine private Chat-URL oder aktiviere die Freigabe, um eine zu erhalten. Bewahre alle Publikationsmarkierungen vor maximal einem Footer auf und behalte den Footer am Ende:

---
[View the OpenClaw team session](https://raw.githubusercontent.com/clawdbot/clawdbot/main/<sessionUrl>)

URLs funktionieren direkt: gh pr view https://github.com/owner/repo/pull/55.

Asynchrone Merges

Nutze den nativen Lande-Workflow des Repositories, sofern vorhanden. Für autorisierte programmatische Merges an anderer Stelle verwende GitHub's asynchrone Merge-API über gh api; gh pr merge wählt diese API nicht aus. Gib den geprüften Head-SHA an, bewahre erforderliche Reviews/Checks und überprüfe zuerst die Stack-Zugehörigkeit: Das Einreichen eines gestapelten PRs merged oder queued auch seine offenen Downstack-PRs, die ihr eigenes Review und ihre eigene Autorisierung benötigen.

gh api -H 'X-Octopool-Require: merge-async-v1' \
  --method PUT repos/owner/repo/pulls/55/merge-async \
  -H 'X-GitHub-Api-Version: 2026-03-10' \
  -f sha=GEPRÜFTER_HEAD_SHA -f merge_method=squash -f merge_action=direct_merge
gh api -H 'X-Octopool-Require: merge-async-v1' \
  repos/owner/repo/pulls/55/merge-async/REQUEST_UUID \
  -H 'X-GitHub-Api-Version: 2026-03-10' -H 'Cache-Control: max-age=0'

Behalte den Octopool-Schutz-Header direkt nach api bei. Geschützte ältere Wrapper lehnen ihn ab, bevor sie die Merge-Berechtigung umschreiben können; verwende einen Octopool-Build, der den asynchronen Schutz enthält, falls er verweigert wird. Der unterstützte Wrapper bewahrt SHA/Method/Action/Bypass und schreibt nur Commit-Text um. Nativer gh kann den Header durchreichen. Entferne ihn nicht, deaktiviere keine Richtlinie und wähle kein rohes Binary, um eine Ablehnung zu umgehen.

Behalte details.uuid von einer 202-Antwort vor dem Polling. pending bedeutet warten; merged enthält details.sha, das dennoch eine endgültige PR/Head-Verifikation erfordert. enqueued bedeutet in der Warteschlange, nicht gemerged: Überwache den PR selbst. Um eine konfigurierte Warteschlange zu respektieren, verwende merge_action=default (oder merge_queue zur expliziten Einreihung) und lasse direkte Methoden/Titel/Nachrichtenfelder weg. Aktiviere niemals bypass_rules ohne Autorisierung.

Bei failed melde details.message. Ein 409 identifiziert eine existierende Anfrage; überprüfe UUID und Optionen, ohne erneut einzureichen. Verlorene Antworten, Polling-Fehler und Ergebnisverfall nach 24 Stunden erfordern Abgleich, niemals einen blinden Wiederholungsversuch oder synchronen Fallback. Polle mit begrenzten Wartezeiten und frischen Lesevorgängen. Asynchrone Verarbeitung aktiviert kein Auto-Merge für unerfüllte Checks; verwende den nativen Workflow oder gh pr merge --auto, wenn dieses Verhalten autorisiert ist.

Merge-Verantwortung

Wenn der Benutzer das Landen oder Mergen eines PRs anfordert, ist das endgültige Ergebnis der verifizierte GitHub-Status des PR, nicht das Ende eines Reviews, einer Workerrunde oder einer CI-Beobachtung.

• Halte den Job aktiv, bis gh pr view ... --json state,mergedAt,mergeCommit beweist, dass state MERGED ist.
• Behandle Review-Ergebnisse, Merge-Konflikte, fehlgeschlagene Checks und angeforderte Änderungen als Fortsetzungsarbeit, wenn sie im Umfang liegen. Behebe sie, führe die erforderlichen Prüfungen erneut durch und bewerte den exakt aktualisierten Head.
• Ein ausstehender Check ist ein Wartezustand, kein Abschluss. Verwende den unterstützten Warte- oder Merge-Workflow des Repositories; behaupte keinen Erfolg aufgrund teilweise grüner Checks.
• Wenn Arbeit an eine persistente Sitzung delegiert wurde und diese Ausführung vor dem Merge endet, setze dieselbe Sitzung fort, anstatt ihren Bericht als endgültiges Ergebnis zu behandeln.
• Stoppe als blockiert nur, wenn die Fortsetzung neue Autorisierung, nicht verfügbare Anmeldeinformationen oder eine Produktentscheidung erfordert, die nicht sicher abgeleitet werden kann. Melde den genauen Blocker und lasse den PR ungemerged.

Issues

gh issue list --repo owner/repo --state open --json number,title,labels,url
gh issue view 42 --repo owner/repo --json title,body,comments,labels,state
gh issue create --repo owner/repo --title "Bug: ..." --body-file /tmp/issue.md
gh issue comment 42 --repo owner/repo --body-file /tmp/comment.md
gh issue close 42 --repo owner/repo --comment "Fixed in ..."

CI/Läufe

gh run list --repo owner/repo --limit 10
gh run view <run-id> --repo owner/repo --json status,conclusion,headSha,url
gh run view <run-id> --repo owner/repo --log-failed
gh run rerun <run-id> --repo owner/repo --failed

API

gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
gh api repos/owner/repo/labels --jq '.[].name'
gh api --cache 1h repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

Verwende --json + --jq für strukturierte Ausgaben. Verwende --body-file für Kommentare/Textkörper, die Backticks, Shell-Ausschnitte, Umgebungsnamen oder Benutzertext enthalten.