Skills

ClawHub

ClawHub est le registre public des Skills et plugins OpenClaw.

  • Utilisez les commandes natives openclaw pour rechercher, installer et mettre à jour des Skills, ainsi que pour installer des plugins depuis ClawHub.
  • Utilisez la CLI clawhub séparée pour les workflows d’authentification au registre, de publication, de suppression/restauration et de synchronisation.

Site : clawhub.ai

Démarrage rapide

  • Rechercher

    openclaw skills search "calendar"
    
  • Installer

    openclaw skills install <skill-slug>
    
  • Utiliser

    Démarrez une nouvelle session OpenClaw : elle prend en compte la nouvelle Skill.

  • Publier (facultatif)

    Pour les workflows authentifiés auprès du registre (publier, synchroniser, gérer), installez la CLI clawhub séparée :

    npm i -g clawhub
    # or
    pnpm add -g clawhub
    
  • Flows OpenClaw natifs

    Skills

    openclaw skills search "calendar"
    openclaw skills install <skill-slug>
    openclaw skills update --all
    

    Les commandes natives openclaw installent dans votre espace de travail actif et conservent les métadonnées de source afin que les appels ultérieurs à update puissent rester sur ClawHub.

    Plugins

    openclaw plugins search "calendar"
    openclaw plugins install clawhub:<package>
    openclaw plugins update --all
    

    plugins search interroge le catalogue de plugins ClawHub et affiche des noms de packages prêts à installer. Utilisez clawhub:<package> lorsque vous voulez la résolution ClawHub. Les spécifications de plugins npm valides sans préfixe s’installent depuis npm pendant la transition de lancement :

    openclaw plugins install openclaw-codex-app-server
    

    npm:<package> est également limité à npm et s’avère utile lorsqu’une spécification pourrait autrement être ambiguë :

    openclaw plugins install npm:openclaw-codex-app-server
    

    Les installations de plugins valident la compatibilité annoncée de pluginApi et minGatewayVersion avant l’installation de l’archive, afin que les hôtes incompatibles échouent de manière fermée tôt, au lieu d’installer partiellement le package. Lorsqu’une version de package publie un artefact ClawPack, OpenClaw privilégie le .tgz npm-pack exact téléversé, vérifie l’en-tête de condensat ClawHub et les octets téléchargés, puis enregistre le type d’artefact, l’intégrité npm, le shasum npm, le nom du tarball et les métadonnées de condensat ClawPack pour les mises à jour ultérieures. Les anciennes versions de packages sans métadonnées ClawPack utilisent toujours le chemin hérité de vérification d’archive de package.

    Ce qu’est ClawHub

    • Un registre public pour les Skills et plugins OpenClaw.
    • Un magasin versionné de bundles de Skills et de métadonnées.
    • Une surface de découverte pour la recherche, les tags et les signaux d’utilisation.

    Une Skill typique est un bundle versionné de fichiers qui comprend :

    • Un fichier SKILL.md avec la description principale et l’utilisation.
    • Des configurations, scripts ou fichiers de support facultatifs utilisés par la Skill.
    • Des métadonnées telles que les tags, le résumé et les exigences d’installation.

    ClawHub utilise les métadonnées pour alimenter la découverte et exposer en toute sécurité les capacités des Skills. Le registre suit les signaux d’utilisation (étoiles, téléchargements) pour améliorer le classement et la visibilité. Chaque publication crée une nouvelle version semver, et le registre conserve l’historique des versions afin que les utilisateurs puissent auditer les changements.

    Espace de travail et chargement des Skills

    La CLI clawhub séparée installe également les Skills dans ./skills sous votre répertoire de travail actuel. Si un espace de travail OpenClaw est configuré, clawhub utilise cet espace de travail par défaut sauf si vous remplacez --workdir (ou CLAWHUB_WORKDIR). OpenClaw charge les Skills d’espace de travail depuis <workspace>/skills et les prend en compte dans la session suivante.

    Si vous utilisez déjà ~/.openclaw/skills ou des Skills groupées, les Skills d’espace de travail ont la priorité. Pour plus de détails sur la façon dont les Skills sont chargées, partagées et soumises à des garde-fous, consultez Skills.

    Fonctionnalités du service

    Fonctionnalité Notes
    Navigation publique Les Skills et leur contenu SKILL.md sont publiquement consultables.
    Recherche Basée sur les embeddings (recherche vectorielle), pas seulement sur des mots-clés.
    Versionnement Semver, changelogs et tags (y compris latest).
    Téléchargements Zip par version.
    Étoiles et commentaires Retours de la communauté.
    Résumés des analyses de sécurité Les pages de détail affichent le dernier état d’analyse avant l’installation ou le téléchargement.
    Pages de détail des scanners Les résultats VirusTotal, ClawScan et d’analyse statique ont des liens profonds.
    Tableau de bord de récupération propriétaire Les éditeurs peuvent voir le contenu leur appartenant retenu par analyse depuis /dashboard.
    Réanalyses demandées par le propriétaire Les propriétaires peuvent demander des réanalyses limitées pour la récupération de faux positifs.
    Modération Approbations et audits.
    API adaptée à la CLI Adaptée à l’automatisation et aux scripts.

    Sécurité et modération

    ClawHub est ouvert par défaut : tout le monde peut téléverser des Skills, mais un compte GitHub doit avoir au moins une semaine pour publier. Cela ralentit les abus sans bloquer les contributeurs légitimes.

    Analyses de sécurité

    ClawHub exécute des contrôles de sécurité automatisés sur les Skills et les releases de plugins publiées. Les pages de détail publiques résument le résultat actuel, et les lignes de scanners renvoient vers des pages de détail dédiées pour VirusTotal, ClawScan et l’analyse statique.

    Les releases retenues par analyse ou bloquées peuvent être indisponibles dans le catalogue public et les surfaces d’installation tout en restant visibles par leur propriétaire dans /dashboard.

    Signalement
    • Tout utilisateur connecté peut signaler une Skill.
    • Les motifs de signalement sont obligatoires et enregistrés.
    • Chaque utilisateur peut avoir jusqu’à 20 signalements actifs à la fois.
    • Les Skills avec plus de 3 signalements uniques sont masquées automatiquement par défaut.
    Modération
    • Les modérateurs peuvent voir les Skills masquées, les réafficher, les supprimer ou bannir des utilisateurs.
    • L’abus de la fonctionnalité de signalement peut entraîner des bannissements de compte.
    • Vous souhaitez devenir modérateur ? Demandez dans le Discord OpenClaw et contactez un modérateur ou un mainteneur.

    CLI ClawHub

    Vous n’en avez besoin que pour les workflows authentifiés auprès du registre, tels que la publication/synchronisation.

    Options globales

    "--workdir
    "--dir
    "--site
    "--registry
    --no-inputboolean

    Désactiver les invites (non interactif).

    -V, --cli-versionboolean

    Afficher la version de la CLI.

    Commandes

    Auth (login / logout / whoami)
    clawhub login              # browser flow
    clawhub login --token <token>
    clawhub logout
    clawhub whoami
    

    Options de connexion :

    • --token <token> - coller un jeton d’API.
    • --label <label> - libellé stocké pour les jetons de connexion navigateur (par défaut : CLI token).
    • --no-browser - ne pas ouvrir de navigateur (nécessite --token).
    Rechercher
    clawhub search "query"
    

    Recherche des Skills. Pour la découverte de plugins/packages, utilisez clawhub package explore.

    • --limit <n> - nombre maximal de résultats.
    Parcourir / inspecter les plugins
    clawhub package explore --family code-plugin
    clawhub package explore "episodic-claw" --family code-plugin
    clawhub package inspect episodic-claw
    

    package explore et package inspect sont les surfaces de la CLI ClawHub pour la découverte de plugins/packages et l’inspection des métadonnées. Les installations OpenClaw natives utilisent toujours openclaw plugins install clawhub:<package>.

    Options :

    • --family skill|code-plugin|bundle-plugin - filtrer la famille de package.
    • --official - afficher uniquement les packages officiels.
    • --executes-code - afficher uniquement les packages qui exécutent du code.
    • --version <version> / --tag <tag> - inspecter une version de package spécifique.
    • --versions, --files, --file <path> - inspecter l’historique et les fichiers du package.
    • --json - sortie lisible par machine.
    Installer / mettre à jour / lister
    clawhub install <slug>
    clawhub update <slug>
    clawhub update --all
    clawhub list
    

    Options :

    • --version <version> - installer ou mettre à jour vers une version spécifique (slug unique uniquement avec update).
    • --force - écraser si le dossier existe déjà, ou lorsque les fichiers locaux ne correspondent à aucune version publiée.
    • clawhub list lit .clawhub/lock.json.
    Publier des Skills
    clawhub skill publish <path>
    

    Options :

    • --slug <slug> - slug de Skill.
    • --name <name> - nom d’affichage.
    • --version <version> - version semver.
    • --changelog <text> - texte du changelog (peut être vide).
    • --tags <tags> - tags séparés par des virgules (par défaut : latest).
    Publier des plugins
    clawhub package publish <source>
    

    <source> peut être un dossier local, owner/repo, owner/repo@ref ou une URL GitHub.

    Options :

    • --dry-run - construire le plan de publication exact sans rien téléverser.
    • --json - émettre une sortie lisible par machine pour la CI.
    • --source-repo, --source-commit, --source-ref - remplacements facultatifs lorsque l’auto-détection ne suffit pas.
    Demander des réanalyses
    clawhub skill rescan <slug>
    clawhub skill rescan <slug> --yes --json
    
    clawhub package rescan <name>
    clawhub package rescan <name> --yes --json
    

    Les commandes de réanalyse nécessitent un jeton propriétaire connecté et ciblent la dernière version de Skill publiée ou release de plugin. Dans les exécutions non interactives, passez --yes.

    Les réponses JSON incluent le type de cible, le nom, la version, l’état de réanalyse, ainsi que les nombres de demandes restantes/maximales pour cette version ou cette release.

    Supprimer / restaurer (propriétaire ou administrateur)
    clawhub delete <slug> --yes
    clawhub undelete <slug> --yes
    
    Synchroniser (analyser localement + publier les nouveaux ou mis à jour)
    clawhub sync
    

    Options :

    • --root <dir...> - racines d’analyse supplémentaires.
    • --all - téléverser tout sans invites.
    • --dry-run - afficher ce qui serait téléversé.
    • --bump <type> - patch|minor|major pour les mises à jour (par défaut : patch).
    • --changelog <text> - changelog pour les mises à jour non interactives.
    • --tags <tags> - tags séparés par des virgules (par défaut : latest).
    • --concurrency <n> - contrôles de registre (par défaut : 4).

    Workflows courants

    Recherche

    clawhub search "postgres backups"
    

    Trouver un Plugin

    clawhub package explore --family code-plugin
    clawhub package explore "memory" --family code-plugin
    clawhub package inspect episodic-claw
    

    Installer

    clawhub install my-skill-pack
    

    Tout mettre à jour

    clawhub update --all
    

    Publier un seul skill

    clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
    

    Synchroniser plusieurs skills

    clawhub sync --all
    

    Publier un Plugin depuis GitHub

    clawhub package publish your-org/your-plugin --dry-run
    clawhub package publish your-org/your-plugin
    clawhub package publish your-org/[email protected]
    clawhub package publish https://github.com/your-org/your-plugin
    

    Métadonnées du package Plugin

    Les Plugins de code doivent inclure les métadonnées OpenClaw requises dans package.json :

    {
      "name": "@myorg/openclaw-my-plugin",
      "version": "1.0.0",
      "type": "module",
      "openclaw": {
        "extensions": ["./src/index.ts"],
        "runtimeExtensions": ["./dist/index.js"],
        "compat": {
          "pluginApi": ">=2026.3.24-beta.2",
          "minGatewayVersion": "2026.3.24-beta.2"
        },
        "build": {
          "openclawVersion": "2026.3.24-beta.2",
          "pluginSdkVersion": "2026.3.24-beta.2"
        }
      }
    }
    

    Les packages publiés doivent inclure du JavaScript compilé et faire pointer runtimeExtensions vers cette sortie. Les installations par checkout Git peuvent toujours se replier sur la source TypeScript lorsqu’aucun fichier compilé n’existe, mais les entrées d’exécution compilées évitent la compilation TypeScript à l’exécution dans les chemins de démarrage, de diagnostic et de chargement des Plugins.

    Versionnement, lockfile et télémétrie

    Versionnement et tags
    • Chaque publication crée une nouvelle SkillVersion semver.
    • Les tags (comme latest) pointent vers une version ; déplacer les tags vous permet de revenir en arrière.
    • Les journaux des modifications sont associés à chaque version et peuvent être vides lors de la synchronisation ou de la publication de mises à jour.
    Modifications locales et versions du registre

    Les mises à jour comparent le contenu du skill local aux versions du registre à l’aide d’un hash de contenu. Si les fichiers locaux ne correspondent à aucune version publiée, la CLI demande confirmation avant d’écraser (ou exige --force lors des exécutions non interactives).

    Analyse de synchronisation et racines de secours

    clawhub sync analyse d’abord votre répertoire de travail actuel. Si aucun skill n’est trouvé, il se replie sur les emplacements hérités connus (par exemple ~/openclaw/skills et ~/.openclaw/skills). Cette logique est conçue pour retrouver les anciennes installations de skills sans indicateurs supplémentaires.

    Stockage et lockfile
    • Les skills installés sont enregistrés dans .clawhub/lock.json sous votre répertoire de travail.
    • Les jetons d’authentification sont stockés dans le fichier de configuration de la CLI ClawHub (remplacement possible via CLAWHUB_CONFIG_PATH).
    Télémétrie (nombre d’installations)

    Lorsque vous exécutez clawhub sync en étant connecté, la CLI envoie un instantané minimal pour calculer le nombre d’installations. Vous pouvez désactiver entièrement cette option :

    export CLAWHUB_DISABLE_TELEMETRY=1
    

    Variables d’environnement

    Variable Effet
    CLAWHUB_SITE Remplace l’URL du site.
    CLAWHUB_REGISTRY Remplace l’URL de l’API du registre.
    CLAWHUB_CONFIG_PATH Remplace l’emplacement où la CLI stocke le jeton/config.
    CLAWHUB_WORKDIR Remplace le répertoire de travail par défaut.
    CLAWHUB_DISABLE_TELEMETRY=1 Désactive la télémétrie sur sync.

    Associé