CLI commands

Sessioni

`openclaw sessions`

Elenca le sessioni di conversazione archiviate.

Gli elenchi delle sessioni non sono controlli di disponibilità del canale/provider. Mostrano righe di conversazione persistite dagli archivi delle sessioni. Un Discord, Slack, Telegram o altro canale inattivo può riconnettersi correttamente senza creare una nuova riga di sessione finché non viene elaborato un messaggio. Usa openclaw channels status --probe, openclaw status --deep o openclaw health --verbose quando hai bisogno della connettività live del canale.

Le risposte di openclaw sessions e Gateway sessions.list sono limitate per impostazione predefinita, così archivi grandi e di lunga durata non possono monopolizzare il processo CLI o il ciclo degli eventi del Gateway. La CLI restituisce per impostazione predefinita le 100 sessioni più recenti; passa --limit <n> per una finestra più piccola/grande oppure --limit all quando hai intenzionalmente bisogno dell'intero archivio. Le risposte JSON includono totalCount, limitApplied e hasMore quando i chiamanti devono mostrare che esistono altre righe.

openclaw sessions
openclaw sessions --agent work
openclaw sessions --all-agents
openclaw sessions --active 120
openclaw sessions --limit 25
openclaw sessions --verbose
openclaw sessions --json

Selezione dell'ambito:

predefinito: archivio dell'agente predefinito configurato
--verbose: log dettagliati
--agent <id>: un archivio di agente configurato
--all-agents: aggrega tutti gli archivi degli agenti configurati
--store <path>: percorso esplicito dell'archivio (non può essere combinato con --agent o --all-agents)
--limit <n|all>: numero massimo di righe da produrre (predefinito 100; all ripristina l'output completo)

Esporta un pacchetto di traiettoria per una sessione archiviata:

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

Questo è il percorso di comando usato dal comando slash /export-trajectory dopo che il proprietario approva la richiesta di esecuzione. La directory di output viene sempre risolta dentro .openclaw/trajectory-exports/ nell'area di lavoro selezionata.

openclaw sessions --all-agents legge gli archivi degli agenti configurati. Il rilevamento delle sessioni Gateway e ACP è più ampio: include anche archivi presenti solo su disco trovati sotto la radice predefinita agents/ o una radice session.store basata su template. Questi archivi rilevati devono risolversi in file sessions.json regolari dentro la radice dell'agente; i symlink e i percorsi fuori dalla radice vengono ignorati.

Esempi JSON:

openclaw sessions --all-agents --json:

{
  "path": null,
  "stores": [
    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },
    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }
  ],
  "allAgents": true,
  "count": 2,
  "totalCount": 2,
  "limitApplied": 100,
  "hasMore": false,
  "activeMinutes": null,
  "sessions": [
    { "agentId": "main", "key": "agent:main:main", "model": "gpt-5" },
    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }
  ]
}

Manutenzione di pulizia

Esegui subito la manutenzione (invece di attendere il prossimo ciclo di scrittura):

openclaw sessions cleanup --dry-run
openclaw sessions cleanup --agent work --dry-run
openclaw sessions cleanup --all-agents --dry-run
openclaw sessions cleanup --enforce
openclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"
openclaw sessions cleanup --json

openclaw sessions cleanup usa le impostazioni session.maintenance dalla configurazione:

Nota sull'ambito: openclaw sessions cleanup mantiene archivi delle sessioni, trascrizioni e sidecar delle traiettorie. Non elimina i log delle esecuzioni cron (cron/runs/<jobId>.jsonl), che sono gestiti da cron.runLog.maxBytes e cron.runLog.keepLines in Configurazione Cron e spiegati in Manutenzione Cron.
La pulizia elimina anche trascrizioni primarie non referenziate, checkpoint di Compaction e sidecar delle traiettorie più vecchi di session.maintenance.pruneAfter; i file ancora referenziati da sessions.json vengono preservati.
--dry-run: mostra in anteprima quante voci verrebbero eliminate/limitate senza scrivere.
- In modalità testo, dry-run stampa una tabella di azioni per sessione (Action, Key, Age, Model, Flags) così puoi vedere cosa verrebbe mantenuto rispetto a cosa verrebbe rimosso.
--enforce: applica la manutenzione anche quando session.maintenance.mode è warn.
--fix-missing: rimuove le voci i cui file di trascrizione mancano, anche se normalmente non uscirebbero ancora per età/conteggio.
--active-key <key>: protegge una chiave attiva specifica dallo sfratto per budget del disco. Anche i puntatori di conversazione esterni durevoli, come le sessioni di gruppo e le sessioni chat con ambito thread, vengono mantenuti dalla manutenzione per età/conteggio/budget del disco.
--agent <id>: esegue la pulizia per un archivio di agente configurato.
--all-agents: esegue la pulizia per tutti gli archivi degli agenti configurati.
--store <path>: esegue l'operazione su un file sessions.json specifico.
--json: stampa un riepilogo JSON. Con --all-agents, l'output include un riepilogo per ogni archivio.

Quando un Gateway è raggiungibile, la pulizia non dry-run per gli archivi degli agenti configurati viene inviata tramite il Gateway, così condivide lo stesso writer dell'archivio delle sessioni del traffico runtime. Usa --store <path> per la riparazione offline esplicita di un file di archivio.

openclaw sessions cleanup --all-agents --dry-run --json:

{
  "allAgents": true,
  "mode": "warn",
  "dryRun": true,
  "stores": [
    {
      "agentId": "main",
      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",
      "beforeCount": 120,
      "afterCount": 80,
      "pruned": 40,
      "capped": 0
    },
    {
      "agentId": "work",
      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",
      "beforeCount": 18,
      "afterCount": 18,
      "pruned": 0,
      "capped": 0
    }
  ]
}

Correlati:

Configurazione della sessione: Riferimento configurazione

# openclaw sessions

# Manutenzione di pulizia

# Correlati

`openclaw sessions`

Manutenzione di pulizia

Correlati