Skills

• Omettez agents.defaults.skills pour laisser toutes les Skills sans restriction par défaut.
• Omettez agents.list[].skills pour hériter de agents.defaults.skills.
• Définissez agents.list[].skills: [] pour n’exposer aucune skill à cet agent.
• Une liste agents.list[].skills non vide constitue l’ensemble final : elle ne fusionne pas avec les valeurs par défaut.
• La liste d’autorisation effective s’applique à la construction des prompts, à la découverte des commandes slash, à la synchronisation du sandbox et aux instantanés de skills.
• Ce n’est pas une frontière d’autorisation du shell hôte. Si le même agent peut utiliser exec, restreignez ce shell séparément avec du sandboxing, l’isolation des utilisateurs OS, des listes d’interdiction/d’autorisation pour exec et des identifiants par ressource.

openclaw skills install installe par défaut dans le répertoire skills/ de l’espace de travail actif. Ajoutez --global pour installer dans le répertoire partagé ~/.openclaw/skills, visible par tous les agents locaux sauf restriction par les listes d’autorisation d’agents.

Les installations Git et locales attendent SKILL.md à la racine de la source. Le slug provient du frontmatter name de SKILL.md lorsqu’il est valide, puis se rabat sur le nom du répertoire ou du dépôt. Utilisez --as <slug> pour le remplacer. openclaw skills update suit uniquement les installations ClawHub : réinstallez les sources Git ou locales pour les actualiser.

openclaw skills verify @owner/<slug> demande à ClawHub l’enveloppe de confiance clawhub.skill.verify.v1 de la skill. Les Skills ClawHub installées se vérifient par rapport à la version et au registre enregistrés dans .clawhub/origin.json. Les slugs nus restent acceptés pour les Skills existantes installées ou non ambiguës, mais les références qualifiées par propriétaire évitent l’ambiguïté de l’éditeur.

Les pages de skills ClawHub exposent le dernier état d’analyse de sécurité avant l’installation, avec des pages de détail pour VirusTotal, ClawScan et l’analyse statique. La commande se termine avec un code non nul lorsque ClawHub marque la vérification comme échouée. Les éditeurs corrigent les faux positifs via le tableau de bord ClawHub ou clawhub skill rescan @owner/<slug>.

Les clients Gateway qui ont besoin d’une distribution hors ClawHub peuvent préparer une archive zip de skill avec skills.upload.begin, skills.upload.chunk et skills.upload.commit, puis l’installer avec skills.install({ source: "upload", ... }). Ce chemin est désactivé par défaut et nécessite skills.install.allowUploadedArchives: true dans openclaw.json. Les installations ClawHub normales n’ont jamais besoin de ce paramètre.

La découverte des Skills d’espace de travail, d’agent de projet et de répertoire supplémentaire n’accepte que les racines de skills dont le chemin réel résolu reste dans la racine configurée, sauf si skills.load.allowSymlinkTargets approuve explicitement une racine cible. Atelier Skills écrit via ces cibles approuvées uniquement lorsque skills.workshop.allowSymlinkTargetWrites est activé. Les répertoires gérés ~/.openclaw/skills et personnels ~/.agents/skills peuvent contenir des dossiers de skills liés symboliquement, mais chaque chemin réel de SKILL.md doit toujours rester dans son répertoire de skill résolu.

Configurez security.installPolicy pour exécuter une commande de politique locale approuvée avant la poursuite des installations de skills. La politique reçoit les métadonnées et le chemin source préparé, s’applique aux chemins ClawHub, téléversé, Git, local, de mise à jour et d’installation de dépendances, et échoue de manière fermée lorsque la commande ne peut pas retourner une décision valide.

skills.entries.*.env et skills.entries.*.apiKey injectent des secrets dans le processus hôte pour ce tour d’agent uniquement, pas dans le sandbox. Gardez les secrets hors des prompts et des journaux.

• Quand plusieurs programmes d'installation sont listés, le Gateway choisit une option préférée (brew si disponible, sinon node).
• Si tous les programmes d'installation sont download, OpenClaw liste chaque entrée afin que vous puissiez voir tous les artefacts disponibles.
• Les spécifications peuvent inclure os: ["darwin"|"linux"|"win32"] pour filtrer par plateforme.
• Les installations Node respectent skills.install.nodeManager dans openclaw.json (valeur par défaut : npm ; options : npm / pnpm / yarn / bun). Cela n'affecte que les installations de Skills ; le runtime Gateway doit toujours être Node.
• Préférence d'installation du Gateway : Homebrew → uv → gestionnaire node configuré → go → download.

• Homebrew : OpenClaw n'installe pas automatiquement Homebrew et ne traduit pas les formules brew en commandes de paquet système. Dans les conteneurs Linux sans brew, les programmes d'installation exclusivement brew sont masqués ; utilisez une image personnalisée ou installez la dépendance manuellement.
• Go : OpenClaw nécessite Go 1.21 ou une version plus récente pour les installations automatiques de Skills et conserve les paramètres GOBIN, GOPATH et GOTOOLCHAIN existants. Si la chaîne d'outils configurée ne peut pas satisfaire la version Go requise par un module, l'onboarding groupe le Skill avec les prérequis Go manuels après la tentative d'installation. Si go est absent et que Homebrew est disponible, OpenClaw installe d'abord Go via Homebrew et définit GOBIN sur le répertoire bin de Homebrew. Sur Linux, OpenClaw peut plutôt utiliser apt-get en tant que root ou via sudo sans mot de passe lorsque le candidat golang-go actualisé satisfait la version minimale.
• Download : url (obligatoire), archive (tar.gz | tar.bz2 | zip), extract (valeur par défaut : automatique lorsqu'une archive est détectée), stripComponents, targetDir (valeur par défaut : ~/.openclaw/tools/<skillKey>).

requires.bins est vérifié sur l'hôte au moment du chargement du Skill. Si un agent s'exécute dans un bac à sable, le binaire doit aussi exister dans le conteneur. Installez-le via agents.defaults.sandbox.docker.setupCommand ou une image personnalisée. setupCommand s'exécute une fois après la création du conteneur et nécessite une sortie réseau, un système de fichiers racine inscriptible et un utilisateur root dans le bac à sable.

Par défaut, OpenClaw surveille les dossiers de Skills et incrémente l'instantané lorsque les fichiers SKILL.md changent. Configurez sous skills.load :

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Utilisez allowSymlinkTargets pour les dispositions de liens symboliques intentionnelles où un lien symbolique racine de Skill pointe en dehors de la racine configurée, par exemple <workspace>/skills/manager -> ~/Projects/manager/skills. Activez skills.workshop.allowSymlinkTargetWrites uniquement lorsque Skill Workshop doit aussi appliquer les propositions via ces chemins symboliques approuvés.

Si le Gateway s'exécute sur Linux mais qu'un nœud macOS est connecté avec system.run autorisé, OpenClaw peut considérer les Skills réservés à macOS comme éligibles lorsque les binaires requis sont présents sur ce nœud. L'agent doit exécuter ces Skills via l'outil exec avec host=node.

Les nœuds hors ligne ne rendent pas les Skills disponibles uniquement à distance visibles. Si un nœud cesse de répondre aux sondes de binaires, OpenClaw efface ses correspondances de binaires mises en cache.