Open-Claw

Éditeur : Open-Claw Nom d'installation : open-claw Statut : Préversion Configuration native : ~/.openclaw/openclaw.json

InstallationCopy Anchor Link

apothem install --harness open-claw

L'adaptateur écrit le fichier de configuration globale utilisateur d'OpenClaw, projette le profil partagé dans un document de profil et installe les cohortes de support Apothem sous la racine de l'environnement. La configuration native d'OpenClaw est en JSON ; le materializer rend une seule clé, skills.load.extraDirs, et un fichier existant conserve ses autres clés.

Fichiers écrits : ~/.openclaw/openclaw.json, le document de profil ~/.openclaw/apothem/rules/00-apothem-profile.md et des fichiers de support sous ~/.openclaw/.apothem/support/

Le document de profil se termine par une section consacrée aux fichiers de support Apothem, qui nomme le répertoire absolu sous ~/.openclaw/.apothem/support/ par rapport auquel se résout chaque citation de style dépôt (rules/<name>.md, templates/..., hooks/...).

Correspondance entre le profil et la configuration nativeCopy Anchor Link

L'adaptateur rédige une seule clé de configuration. Il ajoute ~/.openclaw/.apothem/support/skills à skills.load.extraDirs, la liste des répertoires de skills supplémentaires qu'OpenClaw lit, ce qui permet à OpenClaw de trouver les skills installés. L'entrée est placée après les entrées que vous listez déjà, et vos autres clés restent telles quelles. L'identité, les préférences et les règles du profil vont dans le document de profil. Les commandes, skills, règles, templates et prompts de hook partagés sont installés comme matériel de support sous ~/.openclaw/.apothem/support/.

Notes de compatibilitéCopy Anchor Link

Adaptateur en préversion. OpenClaw charge les skills d'Apothem via skills.load.extraDirs, mais ne charge pas de lui-même le reste de l'arborescence de support ni le document de profil : aucun de ses fichiers d'instructions d'espace de travail ni sa configuration n'y pointent ; après l'installation, OpenClaw s'exécute donc sans les règles ni les serveurs MCP d'Apothem.

Conflits de noms. OpenClaw lit les skills depuis ces sources, de la plus prioritaire à la moins prioritaire, et lorsque le même nom de skill apparaît à plusieurs endroits, la source la plus prioritaire l'emporte : le dossier skills/ de l'espace de travail, le dossier .agents/skills/ de l'espace de travail, ~/.agents/skills (répertoire d'état par défaut uniquement), le dossier skills/ du répertoire d'état (~/.openclaw/skills par défaut), les skills workshop, les skills intégrés et custodian, et en dernier les dossiers listés sous skills.load.extraDirs ainsi que les skills de plugins. Le répertoire d'Apothem est une entrée de extraDirs ; un skill du même nom que vous conservez dans l'une des sources précédentes est donc celui qu'OpenClaw utilise, et la copie Apothem de ce skill reste inutilisée sur le disque. Apothem n'écrit que dans openclaw.json et sous ~/.openclaw/.apothem/support/, jamais dans ces dossiers précédents ; l'installation, la mise à jour et la désinstallation ne remplacent donc pas un skill que vous y conservez.

agents.defaults.skills est la liste d'autorisation des noms de skills ; Apothem ne la modifie pas : si vous en tenez une, vérifiez donc qu'elle nomme les skills d'Apothem que vous voulez. apothem update conserve les clés que vous ajoutez à openclaw.json. Les serveurs MCP se trouvent dans le bloc mcp.servers de la configuration d'OpenClaw, que vous gérez avec openclaw mcp add et les sous-commandes associées ; l'adaptateur n'y écrit aucune entrée. (Comportement d'OpenClaw selon sa documentation sur les skills, sur la configuration des skills et sur les extensions de configuration, consultée le 2026-10-24, et sa documentation sur la CLI MCP, consultée le 2026-10-02.)

Commentaires dans openclaw.json. OpenClaw lit sa configuration en JSON5, et Apothem réécrit le fichier en JSON simple. Lorsque le fichier contient des commentaires ou une autre syntaxe JSON5 et que l'entrée manque, Apothem laisse le fichier intact et l'installation s'arrête avec un message qui nomme la clé. Fusionnez vous-même cette entrée dans votre fichier, ou convertissez le fichier en JSON simple, puis relancez l'installation :

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

Une entrée que vous ajoutez vous-même compte comme la vôtre : la désinstallation la laisse en place.

VérificationCopy Anchor Link

apothem verify --harness open-claw

La commande verify confirme que :

1. La configuration native existe au chemin attendu.
2. Chaque cible gérée existe ; les fichiers gérés ne sont pas vides, et les configurations JSON ou YAML s'analysent correctement. Ajoutez --profile PATH pour vérifier en plus que les fichiers installés correspondent à ce profil.
3. skills.load.extraDirs dans la configuration native liste ~/.openclaw/.apothem/support/skills. Sans cette entrée, OpenClaw ne charge pas les skills installés ; apothem update la rajoute.
4. La routine de vérification propre à l'adaptateur signale un succès.

Mise à jourCopy Anchor Link

apothem update --harness open-claw

Redérive le document de profil à partir de l'état actuel du profil partagé et actualise les fichiers de support ; openclaw.json conserve les clés qu'il possède déjà, et l'entrée Apothem de skills.load.extraDirs reste listée une seule fois, quel que soit le nombre de mises à jour. Exécutez cette commande après avoir modifié ~/.config/apothem/profile.yaml ou mis à niveau le paquet Apothem installé.

DésinstallationCopy Anchor Link

apothem uninstall --harness open-claw

Supprime ce que l'adaptateur a ajouté : son entrée dans skills.load.extraDirs, le document de profil et l'arborescence de support. Vos propres clés dans openclaw.json restent en place, y compris vos propres entrées extraDirs, et le fichier n'est supprimé que si Apothem l'a créé et qu'il n'y reste plus rien qui vous appartienne. Le YAML du profil partagé et le moteur Apothem ne sont pas affectés.

Portail de conformitéCopy Anchor Link

python -m apothem.conformity.gate --all .

DépannageCopy Anchor Link

Paramètres de configurationCopy Anchor Link

Voir aussiCopy Anchor Link

• Tous les environnements — le catalogue complet des outils pris en charge
• Guide d'installation — installer Apothem dans cet environnement
• Référence de apothem harnesses — lister et inspecter les adaptateurs depuis la CLI