Retour

06. OpenClaw : le système de Skills en détail

Les Skills constituent le cœur extensible d'OpenClaw, avec plus de 5700 packs de compétences contribués par la communauté. Cet article présente en détail le concept des Skills, les méthodes d'installation, l'utilisation de ClawHub, la classification des compétences, la gestion de la configuration, et comment choisir les compétences adaptées pour renforcer votre assistant IA.

Compatible avec OpenClaw v2026.2 | Cet article suppose que vous avez terminé l’installation de base et que vous souhaitez étendre les capacités de votre assistant IA.

TL;DR : Les Skills sont des extensions de capacités prêtes à l’emploi. Installez avec openclaw skill install <name>, répertoire dans ~/.openclaw/workspace/skills/. ClawHub propose plus de 5 700 compétences communautaires : assistant de programmation, recherche web, DevOps, automatisation web, etc. Chaque compétence contient un SKILL.md (description + mots déclencheurs + instructions) et des outils optionnels. La vérification de sécurité est assurée via VirusTotal.

Qu’est-ce qu’un Skill ?

Explication du concept

Les Skills sont des modules d’extension de capacités prêts à l’emploi, composés de :

Composant Description
SKILL.md Fichier de définition de la compétence, contenant description, mots déclencheurs, instructions, exemples
Tools Fonctions d’outils appelables (optionnel)
Resources Fichiers de ressources associés (optionnel)
Package.json Déclaration des dépendances (optionnel)

Skills vs Tools

Caractéristique Skills Tools
Source Contributions communautaires Intégrés/personnalisés
Installation Installation requise Disponibles par défaut
Complexité Peut être très complexe Généralement simple
Partageable Oui Généralement non
Mises à jour Mises à jour indépendantes Mises à jour avec le système

Classification des compétences

Les compétences sur ClawHub sont organisées par catégories :

Catégorie Nombre Compétences phares
Assistants de programmation 133+ coding-agent, debug-pro, tdd-guide
Recherche web 253+ web-search, deepwiki, exa-search
DevOps 212+ docker-essentials, git-workflows
Automatisation web 139+ browser-control, puppeteer-skill
Outils de productivité 135+ calendar-skill, task-manager
Analyse de données 46+ data-analyzer, budget-variance
Domotique 56+ home-assistant, smart-home-io
Documents PDF 67+ pdf-reader, doc-summarizer
Images et vidéos 60+ image-gen, video-editor
Notes et connaissances 100+ obsidian, notion-sync

Méthodes d’installation des Skills

Méthode 1 : CLI ClawHub (recommandée)

# Rechercher une compétence
openclaw skill search gmail

# Installer une compétence
openclaw skill install gmail

# Installer une version spécifique
openclaw skill install [email protected]

# Installer depuis GitHub
openclaw skill install github:user/skill-repo

# Installer depuis un chemin local
openclaw skill install ./my-skill

Méthode 2 : Installation manuelle

# Cloner le dépôt de la compétence
git clone https://github.com/user/skill-repo.git

# Copier dans le répertoire des compétences
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

Méthode 3 : Coller un lien GitHub

Envoyez directement le lien GitHub de la compétence dans le chat, et l’Agent l’identifiera et l’installera automatiquement :

Veuillez installer cette compétence : https://github.com/user/skill-repo

Structure du répertoire des compétences

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

Guide d’utilisation de ClawHub

Accéder à ClawHub

Rendez-vous sur clawhub.com pour parcourir toutes les compétences disponibles.

Rechercher des compétences

# Recherche via CLI
openclaw skill search <mot-clé>

# Exemples
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

Détails d’une compétence

Chaque page de compétence contient :

Information Description
Nom et description Explication des fonctionnalités
Auteur Développeur de la compétence
Version Numéro de version actuel
Téléchargements Nombre d’installations
Dépendances Autres compétences ou paquets requis
Aperçu SKILL.md Fichier de définition de la compétence
Analyse de sécurité Résultats de l’analyse VirusTotal

Analyse de sécurité

ClawHub s’associe à VirusTotal pour analyser chaque compétence :

# Voir le statut de sécurité d'une compétence
openclaw skill info gmail --security

# Exemple de sortie :
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

Vérification avant installation

# Vérifier les dépendances de la compétence
openclaw skill check gmail

# Exemple de sortie :
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

Configuration des compétences

Emplacement du fichier de configuration

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

Structure détaillée du SKILL.md

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

Fichier de configuration de la compétence

Certaines compétences nécessitent une configuration supplémentaire :

# Configurer une compétence
openclaw skill config gmail

# Ou modifier manuellement le fichier de configuration
vi ~/.openclaw/workspace/skills/gmail/config.json

Exemple de configuration :

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

Variables d’environnement des compétences

# Définir les variables d'environnement de la compétence
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# Ou dans un fichier .env
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

Gestion des compétences

Voir les compétences installées

# Lister toutes les compétences
openclaw skill list

# Exemple de sortie :
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

Activer/Désactiver une compétence

# Désactiver une compétence
openclaw skill disable home-assistant

# Activer une compétence
openclaw skill enable home-assistant

Mettre à jour les compétences

# Mettre à jour une compétence
openclaw skill update gmail

# Mettre à jour toutes les compétences
openclaw skill update --all

# Vérifier les mises à jour disponibles
openclaw skill outdated

Désinstaller une compétence

# Désinstaller une compétence
openclaw skill uninstall gmail

# Désinstaller et purger la configuration
openclaw skill uninstall gmail --purge

Diagnostic d’une compétence

# Diagnostiquer les problèmes d'une compétence
openclaw skill diagnose gmail

# Exemple de sortie :
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

Compétences recommandées

Développement et programmation

Nom de la compétence Fonction Commande d’installation
coding-agent Exécuter Claude Code, Codex, etc. openclaw skill install coding-agent
debug-pro Méthodes de débogage systématique openclaw skill install debug-pro
tdd-guide Développement piloté par les tests openclaw skill install tdd-guide
git-workflows Workflows Git openclaw skill install git-workflows
docker-essentials Fondamentaux Docker openclaw skill install docker-essentials

Productivité

Nom de la compétence Fonction Commande d’installation
gmail Gestion Gmail openclaw skill install gmail
calendar Gestion d’agenda openclaw skill install calendar
task-manager Gestion de tâches openclaw skill install task-manager
notion-sync Synchronisation Notion openclaw skill install notion-sync
obsidian Notes Obsidian openclaw skill install obsidian

Recherche web

Nom de la compétence Fonction Commande d’installation
web-search Recherche web openclaw skill install web-search
deepwiki Recherche Wiki openclaw skill install deepwiki
exa-search Recherche IA openclaw skill install exa-search
research-paper Recherche d’articles scientifiques openclaw skill install research-paper

Domotique

Nom de la compétence Fonction Commande d’installation
home-assistant Contrôle Home Assistant openclaw skill install home-assistant
smart-home-io Appareils domotiques openclaw skill install smart-home-io
philips-hue Philips Hue openclaw skill install philips-hue

Bases du développement de compétences

Créer une nouvelle compétence

# Créer un modèle de compétence
openclaw skill create my-skill

# Structure du répertoire généré
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

Modèle SKILL.md

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

Ajouter des définitions d’outils

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

Publier une compétence

# Valider la compétence
openclaw skill validate my-skill

# Publier sur ClawHub
openclaw skill publish my-skill

# Ou soumettre sur GitHub
git add .
git commit -m "Initial skill release"
git push origin main

Sécurité des compétences

Bonnes pratiques de sécurité

Recommandation Description
Vérifier la source N’installer que des compétences de sources fiables
Contrôler les permissions Comprendre les permissions requises par la compétence
Examiner le code Inspecter le SKILL.md et le code d’implémentation
Tester en isolation Utiliser d’abord la compétence dans un environnement de test
Mettre à jour régulièrement Maintenir les compétences à jour

Permissions des compétences

# Voir les permissions d'une compétence
openclaw skill permissions gmail

# Exemple de sortie :
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

Restreindre les permissions

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

Résolution des conflits entre compétences

Conflits courants

Type de conflit Description Solution
Chevauchement de mots déclencheurs Plusieurs compétences répondent au même mot-clé Préciser les mots déclencheurs ou désactiver la compétence en conflit
Conflit de dépendances Différentes compétences requièrent des versions différentes Utiliser des environnements isolés
Conflit de permissions Les compétences requièrent les mêmes permissions Vérifier si c’est nécessaire

Résoudre les conflits

# Voir les conflits de compétences
openclaw skill conflicts

# Exemple de sortie :
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# Définir la priorité d'une compétence
openclaw skill priority gmail 10
openclaw skill priority outlook 5

Environnements isolés

Pour les compétences ayant des conflits de dépendances, vous pouvez utiliser des environnements isolés :

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

Dépannage

La compétence ne fonctionne pas

# Vérifier le statut de la compétence
openclaw skill list --status

# Vérifier le chargement de la compétence
openclaw skill load gmail --verbose

# Consulter les logs de la compétence
openclaw logs --filter skill:gmail

Échec d’authentification

# Réauthentifier
openclaw skill auth gmail --reauth

# Vérifier le statut d'authentification
openclaw skill auth gmail --status

Problèmes de dépendances

# Vérifier les dépendances
openclaw skill deps gmail

# Installer les dépendances
openclaw skill deps gmail --install

# Mettre à jour les dépendances
openclaw skill deps gmail --update

Erreur de chargement de la compétence

# Valider la syntaxe du SKILL.md
openclaw skill validate gmail

# Exemple de sortie :
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

Résumé

Le système de Skills est au cœur de l’extensibilité d’OpenClaw :

  • Écosystème riche : plus de 5 700 compétences communautaires couvrant tous les scénarios
  • Installation simple : une seule commande suffit
  • Configuration flexible : personnalisation et surcharge possibles
  • Sécurité maîtrisée : gestion des permissions et analyse de sécurité

En choisissant et configurant judicieusement les compétences, vous pouvez offrir à votre assistant IA des possibilités d’extension illimitées.


Résumé de cet article :

  • Compréhension du concept et de la structure des Skills
  • Maîtrise des différentes méthodes d’installation et de gestion des compétences
  • Apprentissage de la découverte et de l’évaluation des compétences sur ClawHub
  • Connaissance de la sécurité et de la gestion des permissions des compétences
  • Maîtrise des bases du développement de compétences

Historique des mises à jour :

  • 2026-02-26 : publication initiale, basée sur OpenClaw v2026.2

Navigation de la série :