OmeniaClaw sessions

Elenca le sessioni di conversazione archiviate.

Gli elenchi delle sessioni non sono controlli di operatività di canali/provider. Mostrano le righe di conversazione persistenti dagli archivi delle sessioni. Un canale Discord, Slack, Telegram o altro canale inattivo può riconnettersi correttamente senza creare una nuova riga di sessione finché non viene elaborato un messaggio. Usa OmeniaClaw channels status --probe, OmeniaClaw status --deep o OmeniaClaw health --verbose quando ti serve la connettività live del canale.

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

I client RPC possono passare configuredAgentsOnly: true per mantenere l'ampia sorgente di discovery combinata ma restituire solo righe per gli agenti attualmente presenti nella configurazione. L'UI di controllo usa questa modalità per impostazione predefinita, così gli archivi di agenti eliminati o presenti solo su disco non ricompaiono nella vista Sessioni.

OmeniaClaw sessionsOmeniaClaw sessions --agent workOmeniaClaw sessions --all-agentsOmeniaClaw sessions --active 120OmeniaClaw sessions --limit 25OmeniaClaw sessions --verboseOmeniaClaw sessions --json

Selezione dell'ambito:

• predefinito: archivio dell'agente predefinito configurato
• --verbose: logging dettagliato
• --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 bundle di traiettoria per una sessione archiviata:

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

Questo è il percorso del comando usato dallo slash command /export-trajectory dopo che il proprietario approva la richiesta exec. La directory di output viene sempre risolta all'interno di .OmeniaClaw/trajectory-exports/ sotto il workspace selezionato.

OmeniaClaw sessions --all-agents legge gli archivi degli agenti configurati. La discovery delle sessioni di Gateway e ACP è più ampia: include anche gli archivi presenti solo su disco trovati sotto la radice predefinita agents/ o una radice session.store basata su template. Gli archivi scoperti devono risolversi in normali file sessions.json all'interno della radice dell'agente; i symlink e i percorsi esterni alla radice vengono ignorati.

Esempi JSON:

OmeniaClaw sessions --all-agents --json:

{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.OmeniaClaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.OmeniaClaw/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 della pulizia

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

OmeniaClaw sessions cleanup --dry-runOmeniaClaw sessions cleanup --agent work --dry-runOmeniaClaw sessions cleanup --all-agents --dry-runOmeniaClaw sessions cleanup --enforceOmeniaClaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"OmeniaClaw sessions cleanup --dry-run --fix-dm-scopeOmeniaClaw sessions cleanup --json

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

• Nota sull'ambito: OmeniaClaw sessions cleanup gestisce gli archivi delle sessioni, le trascrizioni e i sidecar delle traiettorie. Non elimina i log di esecuzione cron (cron/runs/<jobId>.jsonl), che sono gestiti da cron.runLog.maxBytes e cron.runLog.keepLines nella configurazione Cron e spiegati nella manutenzione Cron.

• La pulizia elimina anche trascrizioni primarie non referenziate, checkpoint di Compaction e sidecar di traiettoria più vecchi di session.maintenance.pruneAfter; i file ancora referenziati da sessions.json vengono conservati.

• --dry-run: anteprima di 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 sono mancanti, anche se normalmente non verrebbero ancora escluse per età/numero.

• --fix-dm-scope: quando session.dmScope è main, ritira le righe direct-DM obsolete con chiave peer lasciate da instradamenti precedenti per-peer, per-channel-peer o per-account-channel-peer. Usa prima --dry-run; l'applicazione della pulizia rimuove quelle righe da sessions.json e conserva le loro trascrizioni come archivi eliminati.

• --active-key <key>: protegge una chiave attiva specifica dall'espulsione per budget disco. Anche i puntatori durevoli a conversazioni esterne, come sessioni di gruppo e sessioni di chat con ambito thread, vengono mantenuti dalla manutenzione per età/numero/budget 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 ciascun 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 sessioni del traffico runtime. Usa --store <path> per la riparazione offline esplicita di un file di archivio.

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

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

Correlato:

• Configurazione delle sessioni: Riferimento della configurazione

Correlati

• Riferimento CLI
• Gestione delle sessioni