OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migration depuis Hermes

Le fournisseur de migration Hermes intégré détecte l’état dans ~/.hermes, affiche un aperçu de chaque modification avant de l’appliquer, masque les secrets dans les plans et les rapports, et crée une sauvegarde OpenClaw vérifiée avant toute modification.

Deux méthodes d’importation

Assistant d’intégration

Détecte Hermes dans ~/.hermes et affiche un aperçu avant l’application.

bash
openclaw onboard --flow import

Vous pouvez également indiquer une source spécifique :

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

Utilisez openclaw migrate pour les exécutions scriptées ou reproductibles. Consultez openclaw migrate pour la référence complète.

bash
openclaw migrate hermes --dry-run    # aperçu uniquementopenclaw migrate apply hermes --yes  # application sans demander de confirmation

Ajoutez --from <path> lorsque Hermes se trouve en dehors de ~/.hermes.

Éléments importés

Configuration des modèles
  • Sélection du modèle par défaut depuis le fichier config.yaml de Hermes.
  • Fournisseurs de modèles configurés et points de terminaison personnalisés compatibles avec OpenAI depuis providers et custom_providers.
Serveurs MCP

Définitions des serveurs MCP depuis mcp_servers ou mcp.servers.

Fichiers de l’espace de travail
  • SOUL.md et AGENTS.md sont copiés dans l’espace de travail de l’agent OpenClaw.
  • memories/MEMORY.md et memories/USER.md sont ajoutés à la suite des fichiers de mémoire OpenClaw correspondants au lieu de les remplacer.
Configuration de la mémoire

Paramètres de mémoire par défaut pour la mémoire sur fichiers d’OpenClaw. Les fournisseurs de mémoire externes tels que Honcho sont enregistrés comme éléments à archiver ou à examiner manuellement afin que vous puissiez les déplacer de manière délibérée.

Skills

Les Skills disposant d’un fichier SKILL.md sous skills/<name>/ sont copiés avec leurs valeurs de configuration propres provenant de skills.config.

Identifiants d’authentification

La commande interactive openclaw migrate demande confirmation avant d’importer les identifiants d’authentification, avec oui sélectionné par défaut. En acceptant, les entrées OAuth OpenAI d’OpenCode et GitHub Copilot provenant du fichier auth.json d’OpenCode sont importées, ainsi que les clés .env Hermes prises en charge. Les entrées OAuth du propre fichier auth.json de Hermes constituent un état ancien : elles sont signalées comme nécessitant une réauthentification manuelle ou une intervention de Doctor au lieu d’être importées dans l’authentification active. Utilisez --include-secrets pour importer les identifiants lors d’une exécution non interactive, --no-auth-credentials pour ignorer entièrement leur importation, ou l’option --import-secrets de l’assistant d’intégration.

Éléments conservés uniquement dans l’archive

Le fournisseur copie les éléments suivants dans le répertoire du rapport de migration pour permettre leur examen manuel, mais ne les charge pas dans la configuration ou les identifiants OpenClaw actifs :

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db

OpenClaw refuse d’exécuter cet état ou de lui faire automatiquement confiance, car les formats et les hypothèses de confiance peuvent diverger entre les systèmes. Après avoir examiné l’archive, déplacez manuellement les éléments dont vous avez besoin.

Procédure recommandée

  • Prévisualiser le plan

    bash
    openclaw migrate hermes --dry-run

    Le plan répertorie tout ce qui sera modifié, notamment les conflits, les éléments ignorés et les éléments sensibles. Les clés imbriquées ressemblant à des secrets sont masquées dans la sortie.

  • Appliquer avec une sauvegarde

    bash
    openclaw migrate apply hermes --yes

    OpenClaw crée et vérifie une sauvegarde avant l’application. Cet exemple non interactif importe uniquement l’état non secret. Exécutez la commande sans --yes pour répondre de manière interactive à l’invite concernant les identifiants, ou ajoutez --include-secrets pour inclure les identifiants pris en charge lors d’une exécution sans surveillance.

  • Exécuter Doctor

    bash
    openclaw doctor

    Doctor réapplique toutes les migrations de configuration en attente et recherche les problèmes introduits lors de l’importation.

  • Redémarrer et vérifier

    bash
    openclaw gateway restartopenclaw status

    Vérifiez que le Gateway fonctionne correctement et que le modèle, la mémoire et les Skills importés sont chargés.

    • Gestion des conflits

    L’application refuse de continuer lorsque le plan signale des conflits, c’est-à-dire lorsqu’un fichier ou une valeur de configuration existe déjà à l’emplacement cible.

    Les conflits sont rares sur une nouvelle installation. Ils apparaissent généralement lorsque vous relancez l’importation sur une configuration contenant déjà des modifications apportées par l’utilisateur.

    Si un conflit survient pendant l’application, par exemple en raison d’un accès concurrent inattendu à un fichier de configuration, Hermes marque les éléments de configuration dépendants restants comme skipped avec le motif blocked by earlier apply conflict, au lieu de les écrire partiellement. Le rapport de migration consigne chaque élément bloqué afin que vous puissiez résoudre le conflit initial et relancer l’importation.

    Secrets

    La commande interactive openclaw migrate demande s’il faut importer les identifiants d’authentification détectés, avec oui sélectionné par défaut.

    • En acceptant, les entrées OAuth OpenAI d’OpenCode et GitHub Copilot provenant du fichier auth.json d’OpenCode sont importées, ainsi que les clés .env prises en charge. Les entrées OAuth du propre fichier auth.json de Hermes sont plutôt signalées comme nécessitant une réauthentification OpenAI manuelle ou une réparation par Doctor.
    • Utilisez --no-auth-credentials, ou répondez non à l’invite, pour importer uniquement l’état non secret.
    • Utilisez --include-secrets pour importer les identifiants lors d’une exécution --yes sans surveillance.
    • Utilisez l’option --import-secrets de l’assistant d’intégration pour importer les identifiants depuis celui-ci.

    Sortie JSON pour l’automatisation

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

    Avec --json et sans --yes, l’application affiche le plan et ne modifie pas l’état : il s’agit du mode le plus sûr pour l’intégration continue et les scripts partagés.

    Dépannage

    L’application refuse de continuer en raison de conflits

    Examinez la sortie du plan. Chaque conflit indique le chemin source et la cible existante. Pour chaque élément, décidez s’il faut l’ignorer, modifier la cible ou relancer la commande avec --overwrite.

    Hermes se trouve en dehors de ~/.hermes

    Transmettez --from /actual/path à la CLI ou --import-source /actual/path à l’intégration.

    L’intégration refuse l’importation dans une configuration existante

    Les importations effectuées pendant l’intégration nécessitent une nouvelle configuration. Réinitialisez l’état et recommencez l’intégration, ou utilisez directement openclaw migrate apply hermes, qui prend en charge --overwrite et le contrôle explicite des sauvegardes.

    Les clés d’API n’ont pas été importées

    La commande interactive openclaw migrate importe les clés d’API uniquement si vous acceptez l’invite concernant les identifiants. Les exécutions non interactives avec --yes nécessitent --include-secrets ; les importations pendant l’intégration nécessitent --import-secrets. Seules les clés .env prises en charge sont reconnues ; les autres variables .env sont ignorées.

    Pages connexes

    • openclaw migrate : référence complète de la CLI, contrat du Plugin et structures JSON.
    • Intégration : procédure de l’assistant et options non interactives.
    • Migration : déplacement d’une installation OpenClaw entre plusieurs machines.
    • Doctor : contrôle d’intégrité après la migration.
    • Espace de travail de l’agent : emplacement de SOUL.md, AGENTS.md et des fichiers de mémoire.
    Was this useful?
    On this page

    On this page