ClawHub : Le Guide Complet du Registre Public de Skills pour Agents IA
L'essor des agents IA autonomes a créé un nouveau défi : comment partager, découvrir et gérer les capacités que ces agents peuvent utiliser ? Tout comme npm a révolutionné la gestion des paquets JavaScript et Docker Hub a standardisé la distribution de conteneurs, ClawHub s'impose comme le registre de skills définitif pour l'écosystème des agents IA.
Conçu comme la marketplace officielle pour OpenClaw — la plateforme d'agents IA open-source et auto-hébergée — ClawHub permet aux développeurs de publier, versionner, rechercher et installer des skills d'agents basés sur du texte grâce à une interface web soignée et un CLI puissant. Avec plus de 5 200 étoiles GitHub, 832 forks et 72 contributeurs, il est rapidement devenu le plus grand registre communautaire de skills dans l'univers des agents.
Dans ce guide complet, nous explorerons tout ce que vous devez savoir sur ClawHub : son architecture, ses workflows CLI, ses considérations de sécurité, le format SKILL.md, et sa comparaison avec les registres alternatifs.
Qu'est-ce que ClawHub ?
ClawHub est le répertoire public de skills pour Clawdbot (l'agent IA au cœur d'OpenClaw). Un « skill » dans ce contexte est un fichier SKILL.md accompagné de fichiers texte optionnels qui définissent ce qu'un agent peut faire — de la recherche web à la gestion de dépôts Git, en passant par l'automatisation d'emails et le contrôle d'appareils IoT.
Pensez-y de cette manière :
| Analogie | Gestionnaire de paquets | Registre |
|---|---|---|
| JavaScript | npm CLI | npmjs.com |
| Python | pip | PyPI |
| Conteneurs | docker CLI | Docker Hub |
| Skills IA | clawhub CLI | clawhub.ai |
Le registre est accessible sur clawhub.ai et propose :
- Navigation et rendu des fichiers SKILL.md avec support complet Markdown
- Recherche sémantique vectorielle alimentée par les embeddings OpenAI (
text-embedding-3-small), pour trouver des skills par requêtes en langage naturel - Versioning avec changelogs, semver et tags (dont
latest) - Étoiles et commentaires pour la curation communautaire
- Hooks de modération pour les administrateurs et modérateurs
- Registre SOUL.md via onlycrabs.ai — un registre jumeau pour le « system lore » qui définit comment un agent se comporte
Statistiques Clés du Projet
| Métrique | Valeur |
|---|---|
| Étoiles GitHub | 5 200+ |
| Forks | 832 |
| Contributeurs | 72 |
| Langage | TypeScript |
| Licence | MIT |
| Date de création | Janvier 2026 |
| Dernière MAJ | Mars 2026 |
Architecture et Stack Technique
ClawHub repose sur une architecture TypeScript full-stack moderne :
Application Web
- Framework : TanStack Start (React + Vite/Nitro)
- Rendu : SSR avec Vite en développement et Nitro en production
Backend
- Base de données et stockage : Convex — un backend réactif gérant la BDD, le stockage fichiers et les actions HTTP
- Authentification : Convex Auth avec GitHub OAuth
- Recherche : Embeddings OpenAI (
text-embedding-3-small) + recherche vectorielle Convex
Structure du Dépôt
src/ → Application TanStack Start (routes, composants, styles)
convex/ → Schéma, requêtes, mutations, actions, routes API HTTP
packages/schema/ → Types API partagés pour le CLI et l'application
docs/ → Documentation du projet
Le Format SKILL.md
Au cœur de ClawHub se trouve le fichier SKILL.md — un document Markdown avec frontmatter YAML qui déclare tout ce qu'un agent doit savoir :
---
name: mon-skill
description: Fait quelque chose avec une API.
metadata:
openclaw:
requires:
env:
- MY_API_KEY
bins:
- curl
primaryEnv: MY_API_KEY
---
# Mon Skill
Instructions pour l'agent ici...
Champs du Frontmatter
| Champ | Objectif |
|---|---|
name | Nom lisible du skill |
description | Résumé des fonctionnalités |
metadata.openclaw.requires.env | Variables d'environnement requises |
metadata.openclaw.requires.bins | Binaires système requis |
metadata.openclaw.primaryEnv | Clé API principale |
Le corps du SKILL.md contient des instructions en langage naturel qu'un agent propulsé par LLM peut interpréter. C'est ce qui rend le format puissant : les skills sont essentiellement des documents de prompt engineering.
Support des Plugins Nix
Pour des skills complexes regroupant des binaires CLI, ClawHub supporte les pointeurs de plugins Nix dans le frontmatter :
---
name: peekaboo
description: Capture et automatisation de l'UI macOS avec le CLI Peekaboo.
metadata:
clawdbot:
nix:
plugin: "github:clawdbot/nix-steipete-tools?dir=tools/peekaboo"
systems: ["aarch64-darwin"]
---
Analyse de Sécurité
Le backend de ClawHub effectue une analyse de sécurité sur les déclarations de métadonnées des skills, vérifiant que les exigences d'exécution (variables d'env, binaires) correspondent au comportement réel du skill.
CLI : Référence Complète des Commandes
Le CLI ClawHub est le moyen principal d'interagir avec le registre depuis le terminal.
Authentification
# Connexion via navigateur
clawhub login
# Connexion headless avec token
clawhub login --token clh_...
# Vérifier votre identité
clawhub whoami
Découverte
# Recherche sémantique en langage naturel
clawhub search "gestion de calendrier"
# Parcourir les derniers skills
clawhub explore
clawhub explore --sort trending --limit 50
# Inspecter un skill sans l'installer
clawhub inspect mon-skill
clawhub inspect mon-skill --versions
clawhub inspect mon-skill --files
La commande explore supporte plusieurs modes de tri : newest, downloads, rating, installs, installsAllTime et trending.
Installation et Gestion
# Installer la dernière version
clawhub install mon-skill
# Installer dans un répertoire personnalisé
clawhub install mon-skill --workdir /tmp/demo --dir skills
# Lister les skills installés
clawhub list
# Mettre à jour tous les skills
clawhub update --all
# Désinstaller (suppression locale uniquement)
clawhub uninstall mon-skill
Publication
# Publier une nouvelle version
clawhub publish ./mon-skill \
--slug mon-skill-unique \
--name "Mon Skill" \
--version 1.0.0 \
--tags latest \
--changelog "Version initiale"
Important : Publier un skill signifie qu'il est diffusé sous licence MIT-0 sur ClawHub. Les skills publiés sont libres d'utilisation, de modification et de redistribution sans attribution.
Sync (Publication par Lots)
# Scanner et publier les skills nouveaux/modifiés
clawhub sync
# Aperçu uniquement
clawhub sync --all --dry-run --no-input
# Contrôler la concurrence et le versioning
clawhub sync --bump minor --concurrency 8
Modération
# Suppression douce d'un skill
clawhub delete mon-skill
# Restaurer un skill supprimé
clawhub undelete mon-skill
# Transférer la propriété
clawhub transfer request mon-skill utilisateur-cible
# Bannir un utilisateur (admin)
clawhub ban-user utilisateur-malveillant --reason "Distribution de malware"
Démarrage Rapide : Développement Local
La mise en place d'un environnement de développement local ClawHub nécessite Bun :
Étape 1 : Cloner et Installer
git clone https://github.com/openclaw/clawhub.git
cd clawhub
bun install
Étape 2 : Configurer l'Environnement
cp .env.local.example .env.local
Variables requises :
| Variable | Objectif |
|---|---|
VITE_CONVEX_URL | URL de déploiement Convex |
AUTH_GITHUB_ID | ID App OAuth GitHub |
AUTH_GITHUB_SECRET | Secret OAuth GitHub |
OPENAI_API_KEY | Pour les embeddings et la recherche |
Étape 3 : Démarrer les Serveurs
# Terminal A : Backend Convex local
bunx convex dev
# Terminal B : Application web (port 3000)
bun run dev
Pour les instructions détaillées, consultez le CONTRIBUTING.md.
Sécurité : Comprendre les Risques et Atténuations
La sécurité est le sujet le plus discuté dans l'écosystème ClawHub. Parce que les skills sont des instructions exécutables qui fonctionnent avec les permissions de l'agent, un skill malveillant peut potentiellement accéder à des fichiers sensibles et des ressources système.
Risques Connus
- Attaques de chaîne d'approvisionnement : Des skills malveillants ont été signalés avec des commandes encodées en base64 ou des instructions de téléchargement de malware
- Compromission déléguée : Les skills s'exécutent avec les mêmes permissions que l'agent
- Ingénierie sociale : Un nombre élevé de téléchargements ne garantit pas la sécurité
Atténuations
- Intégration VirusTotal : Tous les skills publiés sont analysés par la plateforme de renseignement sur les menaces de VirusTotal
- Validation des métadonnées : L'analyse de sécurité vérifie la cohérence des déclarations de runtime
- Modération : Les admins peuvent rapidement masquer ou supprimer les skills problématiques
- Contrôle de télémétrie : Désactivable via
CLAWHUB_DISABLE_TELEMETRY=1
Bonnes Pratiques
| Pratique | Détails |
|---|---|
| Lire SKILL.md | Toujours examiner le skill avant installation |
| Chercher les drapeaux rouges | Contenu base64, téléchargements externes excessifs |
| Espaces de travail isolés | Exécuter les skills non vérifiés dans des environnements sandbox |
| Épingler les versions | Utiliser --version au lieu de toujours récupérer latest |
Cas d'Usage Réels
Workflows de Développement
Skills pour gérer les dépôts, les pull requests, les issues et les pipelines CI/CD — transformant l'agent en assistant de codage complet.
Productivité et Communication
Skills pour créer des boîtes mail d'agents, des générateurs de briefings quotidiens et des capacités de recherche en mémoire.
Recherche Web
Skills de recherche web combinés à la capacité de synthèse de l'agent pour l'analyse concurrentielle et la recherche de marché.
IoT et Automatisation
Plugins Nix comme « peekaboo » (automatisation UI macOS) et « padel » (gestion de réservations de terrains).
ClawHub vs Alternatives
Ce comparatif porte sur les registres de skills pour agents IA :
| Fonctionnalité | ClawHub | awesome-agent-skills | Agent Skills Directory | Agent Skills Open Standard |
|---|---|---|---|---|
| Étoiles GitHub | 5 200+ | 2 850+ | 7 | N/A (spécification) |
| Type | Registre complet + CLI | Liste awesome curatée | Outil de découverte | Spécification ouverte |
| Recherche sémantique | ✅ Embeddings vectoriels | ❌ Markdown statique | ✅ Recommandations intelligentes | ❌ N/A |
| CLI | ✅ Install/publish complet | ❌ Aucun | ❌ Aucun | N/A |
| Versioning | ✅ Semver + tags | ❌ Commits Git uniquement | ❌ Aucun | ❌ N/A |
| Scan sécurité | ✅ VirusTotal | ❌ Review manuelle | ✅ Scan intégré | ❌ N/A |
| Support multi-agent | OpenClaw/Clawdbot | Claude, Codex, Copilot | 41 répertoires | Tous agents compatibles |
Quand Choisir Chaque Option
- ClawHub : Idéal pour les utilisateurs OpenClaw/Clawdbot souhaitant une expérience de gestion de paquets complète
- awesome-agent-skills : Idéal pour la découverte multi-plateformes (Claude Code, Codex, Copilot)
- Agent Skills Directory : Idéal pour la découverte orientée qualité avec scan de sécurité intégré
- Agent Skills Open Standard : Idéal pour l'interopérabilité entre plateformes
Questions Fréquemment Posées
L'installation d'un skill donne-t-elle accès à tout mon système ?
Oui — les skills s'exécutent avec les mêmes permissions que l'agent. Examinez toujours le SKILL.md avant installation et utilisez des environnements sandbox pour les skills non vérifiés.
Puis-je utiliser les skills ClawHub sans OpenClaw ?
ClawHub est conçu comme registre pour l'écosystème OpenClaw/Clawdbot. Bien que le format SKILL.md soit du Markdown interprétable par n'importe quel agent, l'infrastructure CLI et registre est étroitement intégrée à OpenClaw.
Comment fonctionne la recherche sémantique ?
ClawHub utilise le modèle text-embedding-3-small d'OpenAI pour générer des embeddings vectoriels. Votre requête est également transformée en embedding, et la recherche vectorielle de Convex trouve les correspondances les plus proches — vous pouvez chercher en langage naturel comme « gérer mon calendrier ».
Que se passe-t-il quand je supprime un skill ?
clawhub delete effectue une suppression douce — le skill est masqué mais pas supprimé définitivement. Les propriétaires, modérateurs et admins peuvent le restaurer avec clawhub undelete.
Quelle est la différence entre Skills et Souls ?
Les Skills définissent ce qu'un agent peut faire. Les Souls définissent comment un agent se comporte (personnalité, style de communication, garde-fous). Les Skills sont sur ClawHub ; les Souls sur onlycrabs.ai.
Puis-je exécuter ClawHub localement ?
Oui ! Le projet est entièrement open-source. Vous avez besoin de Bun, d'un déploiement Convex, d'une app OAuth GitHub et d'une clé API OpenAI. Consultez le guide de démarrage rapide.
Conclusion
ClawHub représente une pièce d'infrastructure critique pour l'écosystème des agents IA. Avec sa recherche vectorielle sémantique, son CLI complet, ses systèmes de versioning et modération, et sa communauté croissante de 5 200+ stargazers, ClawHub s'est imposé comme le registre de skills leader du domaine.
Que vous construisiez des skills pour votre propre agent, publiiez des outils pour la communauté, ou exploriez simplement les possibilités des agents IA, ClawHub fournit l'infrastructure nécessaire.