Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw importe l’état Hermes via un fournisseur de migration intégré. Le fournisseur prévisualise tout avant de modifier l’état, masque les secrets dans les plans et les rapports, et crée une sauvegarde vérifiée avant l’application.
Les imports nécessitent une nouvelle configuration OpenClaw propre. Si vous avez déjà un état OpenClaw local, réinitialisez d’abord la configuration, les identifiants, les sessions et l’espace de travail, ou utilisez directement openclaw migrate avec --overwrite après avoir examiné le plan.

​
Deux façons d’importer

Le chemin le plus rapide. L’assistant détecte Hermes dans ~/.hermes et affiche une prévisualisation avant l’application.
openclaw onboard --flow import
Ou indiquez une source spécifique :
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Ce qui est importé

  • Sélection du modèle par défaut depuis le config.yaml de Hermes.
  • Fournisseurs de modèles configurés et points de terminaison personnalisés compatibles OpenAI depuis providers et custom_providers.
Définitions de serveurs MCP depuis mcp_servers ou mcp.servers.
  • 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 aux fichiers de mémoire OpenClaw correspondants au lieu de les remplacer.
Valeurs par défaut de configuration de la mémoire pour la mémoire de fichiers OpenClaw. Les fournisseurs de mémoire externes comme Honcho sont enregistrés comme éléments d’archive ou de révision manuelle afin que vous puissiez les déplacer délibérément.
Les Skills comportant un fichier SKILL.md sous skills/<name>/ sont copiées, avec les valeurs de configuration propres à chaque Skill depuis skills.config.
Définissez --include-secrets pour importer les clés .env prises en charge : OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Sans cet indicateur, les secrets ne sont jamais copiés.

​
Ce qui reste uniquement archivé

Le fournisseur copie ces éléments dans le répertoire de rapport de migration pour révision manuelle, mais ne les charge pas dans la configuration ou les identifiants OpenClaw actifs :
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • 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. Déplacez manuellement ce dont vous avez besoin après avoir examiné l’archive.

​
Flux recommandé

1

Prévisualiser le plan

openclaw migrate hermes --dry-run
Le plan répertorie tout ce qui changera, y compris les conflits, les éléments ignorés et tout élément sensible. La sortie du plan masque les clés imbriquées qui ressemblent à des secrets.
2

Appliquer avec sauvegarde

openclaw migrate apply hermes --yes
OpenClaw crée et vérifie une sauvegarde avant d’appliquer. Si vous devez importer des clés d’API, ajoutez --include-secrets.
3

Exécuter doctor

openclaw doctor
Doctor réapplique toute migration de configuration en attente et recherche les problèmes introduits pendant l’import.
4

Redémarrer et vérifier

openclaw gateway restart
openclaw status
Confirmez que le Gateway est sain et que votre modèle, votre mémoire et vos Skills importés sont chargés.

​
Gestion des conflits

L’application refuse de continuer lorsque le plan signale des conflits (un fichier ou une valeur de configuration existe déjà à la cible).
Réexécutez avec --overwrite uniquement lorsque le remplacement de la cible existante est intentionnel. Les fournisseurs peuvent encore écrire des sauvegardes au niveau des éléments pour les fichiers remplacés dans le répertoire de rapport de migration.
Pour une installation OpenClaw propre, les conflits sont inhabituels. Ils apparaissent généralement lorsque vous relancez l’import sur une configuration qui comporte déjà des modifications utilisateur. Si un conflit survient en cours d’application (par exemple, une course inattendue sur un fichier de configuration), Hermes marque les éléments de configuration dépendants restants comme skipped avec la raison blocked by earlier apply conflict au lieu de les écrire partiellement. Le rapport de migration enregistre chaque élément bloqué afin que vous puissiez résoudre le conflit d’origine et relancer l’import.

​
Secrets

Les secrets ne sont jamais importés par défaut.
  • Exécutez d’abord openclaw migrate apply hermes --yes pour importer l’état non secret.
  • Si vous souhaitez aussi copier les clés .env prises en charge, relancez avec --include-secrets.
  • Pour les identifiants gérés par SecretRef, configurez la source SecretRef une fois l’import terminé.

​
Sortie JSON pour l’automatisation

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Avec --json et sans --yes, l’application affiche le plan et ne modifie pas l’état. C’est le mode le plus sûr pour la CI et les scripts partagés.

​
Dépannage

Inspectez la sortie du plan. Chaque conflit identifie le chemin source et la cible existante. Décidez pour chaque élément s’il faut l’ignorer, modifier la cible ou relancer avec --overwrite.
Passez --from /actual/path (CLI) ou --import-source /actual/path (intégration).
Les imports d’intégration nécessitent une configuration propre. Réinitialisez l’état et relancez l’intégration, ou utilisez directement openclaw migrate apply hermes, qui prend en charge --overwrite et le contrôle explicite de la sauvegarde.
--include-secrets est requis, et seules les clés listées ci-dessus sont reconnues. Les autres variables dans .env sont ignorées.

​
Associés