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 migrate

Importez l’état depuis un autre système d’agent via un fournisseur de migration propre à un Plugin. Les fournisseurs intégrés couvrent Claude et Hermes ; les Plugins tiers peuvent enregistrer des fournisseurs supplémentaires.
Pour des guides pas à pas destinés aux utilisateurs, consultez Migrer depuis Claude et Migrer depuis Hermes. Le hub de migration répertorie tous les chemins.

​
Commandes

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes
​
<provider>
string
Nom d’un fournisseur de migration enregistré, par exemple hermes. Exécutez openclaw migrate list pour voir les fournisseurs installés.
​
--dry-run
boolean
Construire le plan et quitter sans modifier l’état.
​
--from <path>
string
Remplacer le répertoire d’état source. Hermes utilise ~/.hermes par défaut.
​
--include-secrets
boolean
Importer les identifiants pris en charge. Désactivé par défaut.
​
--overwrite
boolean
Autoriser l’application à remplacer les cibles existantes lorsque le plan signale des conflits.
​
--yes
boolean
Ignorer l’invite de confirmation. Requis en mode non interactif.
​
--no-backup
boolean
Ignorer la sauvegarde avant application. Nécessite --force lorsqu’un état OpenClaw local existe.
​
--force
boolean
Requis avec --no-backup lorsque l’application refuserait sinon d’ignorer la sauvegarde.
​
--json
boolean
Afficher le plan ou le résultat d’application au format JSON. Avec --json et sans --yes, l’application affiche le plan et ne modifie pas l’état.

​
Modèle de sécurité

openclaw migrate privilégie l’aperçu.
Le fournisseur renvoie un plan détaillé avant tout changement, incluant les conflits, les éléments ignorés et les éléments sensibles. Les plans JSON, la sortie d’application et les rapports de migration masquent les clés imbriquées qui ressemblent à des secrets, comme les clés d’API, les jetons, les en-têtes d’autorisation, les cookies et les mots de passe.openclaw migrate apply <provider> affiche un aperçu du plan et demande confirmation avant de modifier l’état, sauf si --yes est défini. En mode non interactif, l’application nécessite --yes.
L’application crée et vérifie une sauvegarde OpenClaw avant d’appliquer la migration. Si aucun état OpenClaw local n’existe encore, l’étape de sauvegarde est ignorée et la migration peut continuer. Pour ignorer une sauvegarde lorsqu’un état existe, passez à la fois --no-backup et --force.
L’application refuse de continuer lorsque le plan comporte des conflits. Examinez le plan, puis réexécutez avec --overwrite si le remplacement des cibles existantes est intentionnel. Les fournisseurs peuvent tout de même écrire des sauvegardes au niveau des éléments pour les fichiers remplacés dans le répertoire du rapport de migration.
Les secrets ne sont jamais importés par défaut. Utilisez --include-secrets pour importer les identifiants pris en charge.

​
Fournisseur Claude

Le fournisseur Claude intégré détecte l’état de Claude Code dans ~/.claude par défaut. Utilisez --from <path> pour importer un répertoire personnel Claude Code ou une racine de projet spécifique.
Pour un guide pas à pas destiné aux utilisateurs, consultez Migrer depuis Claude.

​
Ce que Claude importe

  • CLAUDE.md du projet et .claude/CLAUDE.md dans l’espace de travail de l’agent OpenClaw.
  • ~/.claude/CLAUDE.md utilisateur ajouté à USER.md de l’espace de travail.
  • Définitions de serveurs MCP depuis .mcp.json du projet, ~/.claude.json de Claude Code et claude_desktop_config.json de Claude Desktop.
  • Répertoires de Skills Claude qui incluent SKILL.md.
  • Fichiers Markdown de commandes Claude convertis en Skills OpenClaw avec invocation manuelle uniquement.

​
État archivé et à examiner manuellement

Les hooks, permissions, valeurs par défaut d’environnement, mémoire locale, règles limitées à des chemins, sous-agents, caches, plans et historique de projet Claude sont conservés dans le rapport de migration ou signalés comme éléments à examiner manuellement. OpenClaw n’exécute pas les hooks, ne copie pas de larges listes d’autorisation et n’importe pas automatiquement l’état des identifiants OAuth/Desktop.

​
Fournisseur Hermes

Le fournisseur Hermes intégré détecte l’état dans ~/.hermes par défaut. Utilisez --from <path> lorsque Hermes se trouve ailleurs.

​
Ce que Hermes importe

  • Configuration de modèle par défaut depuis config.yaml.
  • 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 dans l’espace de travail de l’agent OpenClaw.
  • memories/MEMORY.md et memories/USER.md ajoutés aux fichiers de mémoire de l’espace de travail.
  • Valeurs par défaut de configuration mémoire pour la mémoire de fichiers OpenClaw, plus éléments archivés ou à examiner manuellement pour les fournisseurs de mémoire externes comme Honcho.
  • Skills qui incluent un fichier SKILL.md sous skills/<name>/.
  • Valeurs de configuration par Skill depuis skills.config.
  • Clés d’API prises en charge depuis .env, uniquement avec --include-secrets.

​
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.

​
État archivé uniquement

L’état Hermes qu’OpenClaw ne peut pas interpréter en toute sécurité est copié dans le rapport de migration pour examen manuel, mais il n’est pas chargé dans la configuration ou les identifiants OpenClaw actifs. Cela préserve l’état opaque ou dangereux sans prétendre qu’OpenClaw peut l’exécuter ou lui faire automatiquement confiance :
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db

​
Après application

openclaw doctor

​
Contrat de Plugin

Les sources de migration sont des Plugins. Un Plugin déclare ses identifiants de fournisseur dans openclaw.plugin.json : 
{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}
À l’exécution, le Plugin appelle api.registerMigrationProvider(...). Le fournisseur implémente detect, plan et apply. Le cœur possède l’orchestration CLI, la politique de sauvegarde, les invites, la sortie JSON et la vérification préalable des conflits. Le cœur transmet le plan examiné à apply(ctx, plan), et les fournisseurs peuvent reconstruire le plan uniquement lorsque cet argument est absent pour compatibilité. Les Plugins fournisseurs peuvent utiliser openclaw/plugin-sdk/migration pour la construction des éléments et les décomptes récapitulatifs, ainsi que openclaw/plugin-sdk/migration-runtime pour les copies de fichiers tenant compte des conflits, les copies de rapport archivées uniquement, les wrappers de configuration runtime mis en cache et les rapports de migration.

​
Intégration à l’onboarding

L’onboarding peut proposer une migration lorsqu’un fournisseur détecte une source connue. openclaw onboard --flow import et openclaw setup --wizard --import-from hermes utilisent tous deux le même fournisseur de migration de Plugin et affichent toujours un aperçu avant application.
Les imports d’onboarding nécessitent une nouvelle configuration OpenClaw. Réinitialisez d’abord la configuration, les identifiants, les sessions et l’espace de travail si vous avez déjà un état local. La sauvegarde avec remplacement ou les imports par fusion sont contrôlés par indicateur de fonctionnalité pour les configurations existantes.

​
Associés

  • Migrer depuis Hermes : guide pas à pas destiné aux utilisateurs.
  • Migrer depuis Claude : guide pas à pas destiné aux utilisateurs.
  • Migration : déplacer OpenClaw vers une nouvelle machine.
  • Doctor : vérification de santé après l’application d’une migration.
  • Plugins : installation et enregistrement de Plugins.