Configuration et découverte des hooks d’OpenClaw

Les hooks qui tournent sont le produit de deux décisions : quelles sources la passerelle parcourt et quels noms elle sélectionne. OpenClaw rend la forme sûre facile, activer des hooks nommés plutôt qu’ouvrir une découverte large, et la documentation détaille exactement comment l’interrupteur général, les entrées nommées, les répertoires supplémentaires et les paquets suivis se combinent. Voici la table de sélection, les réglages par hook et la règle d’environnement, la clé retirée et sa migration, les cinq sources de découverte et la résolution des collisions, ce qui compte comme paquet ou comme collection, et comment les paquets s’installent.

Sélection

• Avec l’interrupteur général à faux, les hooks internes sont désactivés ; sans interrupteur et sans entrées activées, répertoires supplémentaires ni installations suivies, la passerelle saute entièrement le chargement des hooks de répertoires.
• Des entrées nommées avec l’interrupteur omis ou vrai forment une liste d’autorisation, et un interrupteur vrai ne l’élargit pas ; une entrée sans faux explicite apporte son nom. Un interrupteur vrai sans entrées nommées ni installations nommées signifie une découverte ouverte des hooks éligibles, tout comme une liste non vide de répertoires supplémentaires ou une installation suivie sans liste de noms de hooks.
• Les paquets de hooks suivis qui déclarent des noms rejoignent la sélection, tandis qu’un faux explicite par hook désactive encore un hook hors extension ; les hooks d’espace de travail exigent toujours une activation explicite même en découverte ouverte, et ajouter la première entrée nommée peut rétrécir une sélection auparavant large, donc inspectez les hooks existants avant de la changer.
• Les entrées acceptent des champs arbitraires définis par le gestionnaire, seuls le booléen d’activation et la carte d’environnement étant typés par le cœur ; l’environnement par hook satisfait les contrôles d’éligibilité mais ne modifie pas l’environnement du processus, et un gestionnaire le lit dans la configuration portée par les événements qui en incluent une, puisque les autres événements ne promettent pas de champ de configuration.

N’ajoutez que des répertoires de confiance : tout chemin supplémentaire ouvre la sélection des noms de hooks à toutes les sources de découverte au-delà des entrées nommées, même quand ce chemin ne sélectionne qu’un seul hook ou un seul paquet.

Sources de découverte

La découverte par répertoires fusionne les hooks par nom à travers cinq sources. Les hooks intégrés sont livrés avec OpenClaw ; les répertoires de hooks déclarés par les extensions actives peuvent remplacer les noms intégrés ; le répertoire géré sous le répertoire d’état peut remplacer les noms intégrés et d’extensions ; les répertoires supplémentaires suivent la même politique que les hooks gérés, les derniers l’emportant sur les premiers et le répertoire géré l’emportant sur tous ; et le dossier de hooks de l’espace de travail peut ajouter des noms mais jamais remplacer ceux qui sont intégrés, d’extensions ou gérés, et exige une adhésion explicite. Les emplacements intégré, géré, d’espace de travail et d’extensions sont des répertoires de collections dont les enfants immédiats sont inspectés à la recherche de hooks ou de paquets déclarant des hooks dans leur manifeste. Un chemin explicite de répertoire supplémentaire peut au contraire être une racine de paquet, qui ne charge que ses chemins de hooks déclarés sans descendre dans d’autres paquets ou collections et reste vide quand il ne déclare aucun hook valide, ou une racine de hook unique, qui charge son propre manifeste et son gestionnaire ; seule une racine de collection ordinaire reçoit le parcours des enfants immédiats. Les fichiers de gestionnaires doivent rester dans leur répertoire de hook et les chemins de hooks de paquets dans leur racine de paquet, les liens symboliques qui s’en échappent étant rejetés. Les changements de configuration des hooks et d’espace de travail sélectionné rechargent la découverte en mode hybride, y compris la configuration écrite par l’installation d’un nouveau paquet, mais les fichiers et métadonnées des hooks ne sont pas surveillés, donc modifier le code d’un hook existant exige un redémarrage puis la vérification de l’effet réel du gestionnaire.

Migration et paquets

• L’ancienne clé des gestionnaires est retirée et échoue à la validation normale : avant de lancer la correction du doctor, migrez chaque module enregistré vers un répertoire de hook géré ou d’espace de travail avec un manifeste de hook et un gestionnaire, parce que le doctor retire les anciens enregistrements sans créer de fichiers exécutables ; pour une configuration héritée seule avec l’interrupteur général activé, le doctor retire aussi cet interrupteur pour éviter une découverte large, tandis que les entrées nommées, les répertoires supplémentaires non vides et les désactivations explicites sont préservés.
• Un paquet de hooks est un paquet dont le manifeste déclare des répertoires de hooks, installé comme paquet relu ou répertoire local par l’installateur unifié des extensions ; les options d’installation et de mise à jour, les restrictions npm, la confiance des racines liées et les anciens alias d’installation de hooks sont documentés avec la CLI.
• Pour un comportement prévisible, la documentation recommande la forme en liste d’autorisation : interrupteur général activé, chaque hook voulu nommé et activé, les hooks intégrés indésirables nommés et désactivés, et aucun répertoire supplémentaire sauf à accepter qu’il élargisse la sélection à toutes les sources.

Hooks et webhooks dans OpenClaw est le guide que cette configuration sert, et Les extensions d’OpenClaw l’installateur par lequel passent les paquets de hooks et la source qui peut remplacer les noms intégrés.

Pourquoi l’ordre compte

Les règles de remplacement sont un ordre de confiance : géré bat extension bat intégré, et l’espace de travail ne peut qu’ajouter, ce qui empêche un fichier que l’agent écrit dans son propre espace de travail de remplacer en silence un hook installé par l’opérateur. OpenClaw doctor effectue la migration de la clé retirée, et L’espace de travail de l’agent OpenClaw explique le dossier d’espace de travail qui reçoit la règle d’ajout seul.

Sur Diali

Sur Diali, les répertoires de hooks gérés et d’espace de travail vivent sur le volume de l’assistant, et la liste d’entrées nommées est aussi la forme la plus sûre ici, puisqu’une découverte ouverte ramasserait tout ce que l’assistant lui-même écrit dans son dossier de hooks d’espace de travail. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qui l’entoure.

• Nommez les hooks que vous voulez ; n’ouvrez pas la découverte.
• Géré bat extension bat intégré ; l’espace de travail ne fait qu’ajouter.
• L’environnement satisfait l’éligibilité ; il ne touche jamais au processus.