Skill GitHub (gh) pour OpenClaw — Guide Complet

Présentation du Skill GitHub pour OpenClaw

Le skill GitHub (gh) connecte OpenClaw à la plateforme GitHub via le GitHub CLI (gh) officiel. Une fois installé, votre agent OpenClaw peut interagir avec les dépôts, pull requests, issues, workflows Actions et plus encore — en utilisant des commandes en langage naturel.

C'est l'un des skills les plus populaires et polyvalents de l'écosystème OpenClaw. Que vous triiez des issues, ouvriez des PRs ou vérifiiez le statut du CI, le skill GitHub transforme les workflows Git multi-étapes en conversations simples.

Workflow typique :

1. Demandez à OpenClaw de vérifier vos PRs en attente.
2. L'agent exécute gh pr list en arrière-plan.
3. Les résultats sont renvoyés sous forme de résumé lisible — pas de changement de contexte nécessaire.

Prérequis pour le Skill GitHub

Avant d'installer le skill GitHub, assurez-vous d'avoir :

• OpenClaw installé et en cours d'exécution (v1.0+)
• GitHub CLI (gh) installé — guide d'installation
• Un compte GitHub avec accès aux dépôts que vous souhaitez gérer
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier la version de GitHub CLI
gh --version

# Vérifier l'authentification GitHub
gh auth status

Comment Installer le Skill GitHub

Installez le skill GitHub avec une seule commande :

npx clawhub@latest install github

Pour vérifier l'installation :

clawhub list

Vous devriez voir github dans la liste des skills installés.

Guide de Configuration du Skill GitHub

Le skill GitHub nécessite un Personal Access Token (PAT) ou une authentification GitHub CLI. Nous recommandons d'utiliser gh auth login pour la configuration la plus simple.

Portées du Token

Si vous préférez un PAT, créez-en un sur github.com/settings/tokens avec ces portées :

| Portée | Requis | Objectif | |--------|--------|----------| | repo | Oui | Accès complet aux dépôts | | read:org | Recommandé | Lire l'appartenance à l'organisation | | workflow | Optionnel | Gérer les workflows GitHub Actions | | read:project | Optionnel | Lire les tableaux de projet | | gist | Optionnel | Créer et gérer les gists |

Configuration de l'Environnement

# Option 1 : Utiliser l'authentification GitHub CLI (recommandé)
gh auth login

# Option 2 : Définir un Personal Access Token
export GITHUB_TOKEN=ghp_your_token_here

Important : Ne codez jamais les tokens en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets (comme 1Password ou Bitwarden).

Exemples d'Utilisation du Skill GitHub

1. Lister et Trier les Issues Ouvertes

Vous : « Montre-moi les issues ouvertes sur notre repo principal avec le label bug. »

L'agent exécute l'équivalent de gh issue list --label bug --state open et renvoie un résumé formaté avec les numéros d'issues, titres et assignés.

Vous : « Assigne-moi l'issue #42 et ajoute le label priority:high. »

L'agent exécute gh issue edit 42 --add-assignee @me --add-label priority:high.

2. Créer une Pull Request

Vous : « Crée une PR depuis la branche feature/auth vers main avec le titre 'Add OAuth2 login' et un résumé des modifications. »

L'agent prépare la PR en utilisant gh pr create, remplit le titre et génère une description basée sur le diff des commits.

3. Réviser une Pull Request

Vous : « Résume les modifications du PR #128. »

L'agent récupère le diff avec gh pr diff 128, analyse les modifications et fournit un résumé concis incluant :

• Fichiers modifiés et lignes ajoutées/supprimées
• Modifications logiques clés
• Préoccupations potentielles ou suggestions

4. Vérifier le Statut du CI

Vous : « Quel est le statut de la dernière exécution Actions sur main ? »

L'agent vérifie gh run list --branch main --limit 1 et rapporte si l'exécution a réussi, échoué ou est encore en cours — avec un lien vers le journal complet.

Sécurité et Bonnes Pratiques

Le skill GitHub peut effectuer des opérations d'écriture sur vos dépôts. Suivez ces directives pour rester en sécurité :

• Utilisez le principe du moindre privilège. N'accordez que les portées de token dont vous avez réellement besoin. Si vous ne lisez que des repos, ignorez la portée workflow.
• Authentifiez-vous avec gh auth login plutôt qu'avec des PATs à longue durée de vie quand c'est possible. Le CLI gère automatiquement le renouvellement des tokens.
• Vérifiez avant de fusionner. Confirmez toujours les fusions de PRs et les actions destructives. OpenClaw demandera l'approbation par défaut.
• Renouvelez les tokens régulièrement. Si vous utilisez un PAT, définissez une date d'expiration et renouvelez-le au moins tous les 90 jours.
• Évitez d'accorder les portées admin. Les portées admin:org et delete_repo sont rarement nécessaires. Ne les accordez pas sauf si c'est indispensable.
• Auditez l'activité. Vérifiez périodiquement le journal d'audit GitHub pour examiner les actions effectuées via l'API.

Erreurs Courantes et Dépannage

"gh: command not found"

Le GitHub CLI n'est pas installé ou n'est pas dans votre PATH.

# macOS
brew install gh

# Ubuntu / Debian
sudo apt install gh

# Windows
winget install GitHub.cli

Après l'installation, authentifiez-vous avec gh auth login.

"HTTP 401: Bad credentials"

Votre token est manquant, expiré ou n'a pas les portées requises.

1. Exécutez gh auth status pour vérifier l'état d'authentification actuel.
2. S'il est expiré, ré-authentifiez-vous avec gh auth login.
3. Si vous utilisez un PAT, vérifiez qu'il a la portée repo sur github.com/settings/tokens.

"Resource not accessible by integration"

Vous essayez d'accéder à un dépôt ou une organisation pour lesquels votre token n'a pas l'autorisation.

1. Vérifiez que votre token inclut la portée read:org.
2. Confirmez que votre compte GitHub a accès au dépôt cible.
3. Pour les repos d'organisation, un administrateur peut devoir approuver votre token dans Settings → Third-party access.