CLI commands

Migrazione

`openclaw migrate`

Importa lo stato da un altro sistema agent tramite un provider di migrazione di proprietà di un plugin. I provider inclusi coprono lo stato della CLI Codex, Claude e Hermes; i plugin di terze parti possono registrare provider aggiuntivi.

Comandi

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Nome di un provider di migrazione registrato, ad esempio hermes. Esegui openclaw migrate list per vedere i provider installati.

--dry-runboolean

Crea il piano ed esci senza modificare lo stato.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Sostituisce la directory dello stato sorgente. Hermes usa ~/.hermes per impostazione predefinita.

--include-secretsboolean

Importa le credenziali supportate. Disattivato per impostazione predefinita.

--overwriteboolean

Consente ad apply di sostituire i target esistenti quando il piano segnala conflitti.

--yesboolean

Salta la richiesta di conferma. Obbligatorio in modalità non interattiva.

"--skill

--no-backupboolean

Salta il backup prima dell'applicazione. Richiede --force quando esiste uno stato OpenClaw locale.

--forceboolean

Obbligatorio insieme a --no-backup quando apply altrimenti rifiuterebbe di saltare il backup.

--jsonboolean

Stampa il piano o il risultato di apply come JSON. Con --json e senza --yes, apply stampa il piano e non modifica lo stato.

Modello di sicurezza

openclaw migrate dà priorità all'anteprima.

Anteprima prima dell'applicazione

Il provider restituisce un piano dettagliato per elementi prima che qualunque cosa cambi, inclusi conflitti, elementi saltati ed elementi sensibili. I piani JSON, l'output di apply e i report di migrazione oscurano chiavi annidate dall'aspetto segreto, come chiavi API, token, header di autorizzazione, cookie e password.

openclaw migrate apply <provider> mostra un'anteprima del piano e richiede conferma prima di modificare lo stato, a meno che --yes sia impostato. In modalità non interattiva, apply richiede --yes.

Backup

Apply crea e verifica un backup OpenClaw prima di applicare la migrazione. Se non esiste ancora uno stato OpenClaw locale, il passaggio di backup viene saltato e la migrazione può continuare. Per saltare un backup quando lo stato esiste, passa sia --no-backup sia --force.

Conflitti

Apply rifiuta di continuare quando il piano contiene conflitti. Rivedi il piano, poi riesegui con --overwrite se la sostituzione dei target esistenti è intenzionale. I provider possono comunque scrivere backup a livello di elemento per i file sovrascritti nella directory del report di migrazione.

Segreti

I segreti non vengono mai importati per impostazione predefinita. Usa --include-secrets per importare le credenziali supportate.

Provider Claude

Il provider Claude incluso rileva lo stato di Claude Code in ~/.claude per impostazione predefinita. Usa --from <path> per importare una home di Claude Code o una radice di progetto specifica.

Cosa importa Claude

CLAUDE.md del progetto e .claude/CLAUDE.md nello spazio di lavoro dell'agente OpenClaw.
~/.claude/CLAUDE.md dell'utente aggiunto a USER.md dello spazio di lavoro.
Definizioni dei server MCP da .mcp.json del progetto, ~/.claude.json di Claude Code e claude_desktop_config.json di Claude Desktop.
Directory delle skill Claude che includono SKILL.md.
File Markdown dei comandi Claude convertiti in skill OpenClaw con sola invocazione manuale.

Stato archiviato e da rivedere manualmente

Hook, permessi, impostazioni predefinite dell'ambiente, memoria locale, regole con ambito di percorso, subagent, cache, piani e cronologia del progetto di Claude vengono conservati nel report di migrazione o segnalati come elementi da rivedere manualmente. OpenClaw non esegue hook, non copia allowlist ampie e non importa automaticamente lo stato delle credenziali OAuth/Desktop.

Provider Codex

Il provider Codex incluso rileva lo stato della CLI Codex in ~/.codex per impostazione predefinita, oppure in CODEX_HOME quando quella variabile di ambiente è impostata. Usa --from <path> per inventariare una home Codex specifica.

Usa questo provider quando passi all'harness Codex di OpenClaw e vuoi promuovere deliberatamente risorse personali utili della CLI Codex. Gli avvii locali del server app Codex usano directory CODEX_HOME e HOME per agente, quindi non leggono lo stato personale della CLI Codex per impostazione predefinita.

L'esecuzione di openclaw migrate codex in un terminale interattivo mostra l'anteprima del piano completo, poi apre un selettore con caselle di controllo per gli elementi di copia delle skill prima della conferma finale di apply. Usa Toggle all on o Toggle all off per la selezione in blocco; le skill pianificate partono selezionate, le skill in conflitto partono deselezionate e Skip for now lascia le skill invariate senza applicare. Per esecuzioni tramite script o esatte, passa --skill <name> una volta per skill, ad esempio:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

Cosa importa Codex

Directory delle skill della CLI Codex sotto $CODEX_HOME/skills, esclusa la cache .system di Codex.
AgentSkills personali sotto $HOME/.agents/skills, copiate nello spazio di lavoro dell'agente OpenClaw corrente quando vuoi la proprietà per agente.

Stato Codex da rivedere manualmente

I plugin nativi Codex, config.toml e hooks/hooks.json nativo non vengono attivati automaticamente. I plugin possono esporre server MCP, app, hook o altri comportamenti eseguibili, quindi il provider li segnala per revisione invece di caricarli in OpenClaw. I file di configurazione e hook vengono copiati nel report di migrazione per la revisione manuale.

Provider Hermes

Il provider Hermes incluso rileva lo stato in ~/.hermes per impostazione predefinita. Usa --from <path> quando Hermes si trova altrove.

Cosa importa Hermes

Configurazione del modello predefinito da config.yaml.
Provider di modelli configurati ed endpoint personalizzati compatibili con OpenAI da providers e custom_providers.
Definizioni dei server MCP da mcp_servers o mcp.servers.
SOUL.md e AGENTS.md nello spazio di lavoro dell'agente OpenClaw.
memories/MEMORY.md e memories/USER.md aggiunti ai file di memoria dello spazio di lavoro.
Impostazioni predefinite della configurazione della memoria per la memoria su file OpenClaw, più elementi archiviati o da rivedere manualmente per provider di memoria esterni come Honcho.
Skill che includono un file SKILL.md sotto skills/<name>/.
Valori di configurazione per skill da skills.config.
Chiavi API supportate da .env, solo con --include-secrets.

Chiavi `.env` supportate

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.

Stato solo archiviato

Lo stato Hermes che OpenClaw non può interpretare in sicurezza viene copiato nel report di migrazione per la revisione manuale, ma non viene caricato nella configurazione o nelle credenziali OpenClaw attive. Questo conserva lo stato opaco o non sicuro senza fingere che OpenClaw possa eseguirlo o considerarlo attendibile automaticamente:

plugins/
sessions/
logs/
cron/
mcp-tokens/
auth.json
state.db

Dopo l'applicazione

openclaw doctor

Contratto Plugin

Le sorgenti di migrazione sono plugin. Un plugin dichiara i propri id provider in openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

A runtime il plugin chiama api.registerMigrationProvider(...). Il provider implementa detect, plan e apply. Core possiede l'orchestrazione della CLI, la policy di backup, i prompt, l'output JSON e il preflight dei conflitti. Core passa il piano revisionato a apply(ctx, plan) e i provider possono ricreare il piano solo quando quell'argomento è assente per compatibilità.

I plugin provider possono usare openclaw/plugin-sdk/migration per la costruzione degli elementi e i conteggi riepilogativi, più openclaw/plugin-sdk/migration-runtime per copie di file consapevoli dei conflitti, copie nel report solo archiviate, wrapper della configurazione runtime memorizzati nella cache e report di migrazione.

Integrazione con l'onboarding

L'onboarding può offrire la migrazione quando un provider rileva una sorgente nota. Sia openclaw onboard --flow import sia openclaw setup --wizard --import-from hermes usano lo stesso provider di migrazione plugin e mostrano comunque un'anteprima prima dell'applicazione.

Correlati

Migrazione da Hermes: guida dettagliata rivolta agli utenti.
Migrazione da Claude: guida dettagliata rivolta agli utenti.
Migrazione: sposta OpenClaw su una nuova macchina.
Doctor: controllo dello stato dopo l'applicazione di una migrazione.
Plugin: installazione e registrazione dei plugin.

# openclaw migrate

# Comandi

# Modello di sicurezza

# Provider Claude

# Cosa importa Claude

# Stato archiviato e da rivedere manualmente

# Provider Codex

# Cosa importa Codex

# Stato Codex da rivedere manualmente

# Provider Hermes

# Cosa importa Hermes

# Chiavi .env supportate

# Stato solo archiviato

# Dopo l'applicazione

# Contratto Plugin

# Integrazione con l'onboarding

# Correlati

`openclaw migrate`

Comandi

Modello di sicurezza

Provider Claude

Cosa importa Claude

Stato archiviato e da rivedere manualmente

Provider Codex

Cosa importa Codex

Stato Codex da rivedere manualmente

Provider Hermes

Cosa importa Hermes

Chiavi `.env` supportate

Stato solo archiviato

Dopo l'applicazione

Contratto Plugin

Integrazione con l'onboarding

Correlati