openclaw sessions

Liste as sessões de conversa armazenadas.

As listas de sessões não são verificações de atividade do canal/provedor. Elas mostram linhas de conversas persistidas nos armazenamentos de sessões. Um Discord, Slack, Telegram ou outro canal inativo pode se reconectar com sucesso sem criar uma nova linha de sessão até que uma mensagem seja processada. Use openclaw channels status --probe, openclaw status --deep ou openclaw health --verbose quando precisar de conectividade de canal em tempo real.

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --store ./tmp/sessions.jsonopenclaw sessions --json

Opções:

openclaw sessions e o RPC sessions.list do Gateway são limitados por padrão para que armazenamentos grandes e de longa duração não monopolizem o processo da CLI nem o loop de eventos do Gateway. Por padrão, a CLI retorna as 100 sessões mais recentes; passe --limit <n> para uma janela menor/maior ou --limit all quando precisar intencionalmente do armazenamento completo. As respostas JSON incluem totalCount, limitApplied e hasMore quando os chamadores precisam indicar que há mais linhas.

Os clientes RPC podem passar configuredAgentsOnly: true para manter a fonte ampla de descoberta combinada, mas retornar apenas as linhas de agentes atualmente presentes na configuração. A Control UI usa esse modo por padrão para que armazenamentos de agentes excluídos ou presentes apenas em disco não reapareçam na visualização de sessões.

--all-agents lê os armazenamentos de agentes configurados. A descoberta de sessões do Gateway e do ACP é mais ampla: ela também inclui armazenamentos SQLite resolvidos a partir das raízes de agentes configuradas ou de uma raiz session.store baseada em modelo. Caminhos de seletores legados devem ser resolvidos dentro da raiz do agente; links simbólicos e caminhos fora da raiz são ignorados.

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": "openai/gpt-5.6-sol" },    { "agentId": "work", "key": "agent:work:main", "model": "anthropic/claude-sonnet-4-6" }  ]}

Acompanhar o progresso da trajetória

openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

openclaw sessions tail renderiza eventos recentes da trajetória de execução como linhas compactas de progresso. Sem --session-key, ele acompanha primeiro as sessões em execução e depois a sessão armazenada mais recente. --tail <count> controla quantos eventos existentes são exibidos antes do modo de acompanhamento; o padrão é 80, e 0 começa no final atual. --follow continua observando a sessão selecionada baseada em SQLite ou um arquivo de trajetória legado explícito.

A visualização de progresso é intencionalmente conservadora: o texto do prompt, os argumentos das ferramentas e o conteúdo dos resultados das ferramentas não são exibidos. As chamadas de ferramentas mostram o nome da ferramenta com {...redacted...}; os resultados das ferramentas mostram estados como ok, error ou done; as linhas de conclusão do modelo mostram o provedor/modelo e o estado final.

Exportar um pacote de trajetória

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

Este é o caminho de comando usado pelo comando de barra /export-trajectory depois que o proprietário aprova a solicitação de execução. O diretório de saída sempre é resolvido dentro de .openclaw/trajectory-exports/ no espaço de trabalho selecionado.

Manutenção de limpeza

Execute a manutenção agora, em vez de aguardar o próximo ciclo de gravação:

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

openclaw sessions cleanup usa as configurações de session.maintenance da configuração (Referência de configuração):

• Observação sobre o escopo: openclaw sessions cleanup mantém armazenamentos de sessões, transcrições, linhas de trajetória e arquivos auxiliares de trajetória legados. Ele não elimina o histórico de execuções do cron, que mantém automaticamente as 2000 linhas mais recentes por tarefa (Configuração do Cron).
• A limpeza também elimina artefatos de transcrições legadas/arquivadas sem referência, pontos de verificação de Compaction e arquivos auxiliares de trajetória com mais de session.maintenance.pruneAfter; os artefatos ainda referenciados por linhas de sessão do SQLite são preservados.
• A limpeza relata separadamente a limpeza de sondagens de execução de modelo de curta duração do Gateway como modelRunPruned. Isso corresponde apenas a chaves explícitas estritas no formato agent:*:explicit:model-run-<uuid>. A retenção é fixa em 24h e condicionada à pressão: ela remove linhas de sondagem obsoletas somente quando a pressão da manutenção/limite de entradas de sessão é atingida. Quando executada, a limpeza das execuções de modelo ocorre antes da limpeza global de itens obsoletos e da aplicação de limites.

Opções:

Quando um Gateway está acessível, a limpeza sem simulação para armazenamentos de agentes configurados é enviada pelo Gateway, para que compartilhe o mesmo gravador do armazenamento de sessões usado pelo tráfego em tempo de execução. Use --store <path> para reparar explicitamente, no modo offline, um seletor de armazenamento legado.

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,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}

Compactar uma sessão

Recupere o orçamento de contexto de uma sessão travada ou grande demais. openclaw sessions compact <key> é o wrapper de primeira classe em torno do RPC sessions.compact do Gateway e requer um Gateway em execução.

openclaw sessions compact "agent:main:main"openclaw sessions compact "agent:main:main" --max-lines 200openclaw sessions compact "agent:work:main" --agent work --json

• Sem --max-lines, o Gateway usa um LLM para resumir a transcrição. A CLI não impõe um prazo limite ao cliente por padrão; o Gateway controla o ciclo de vida configurado da Compaction.
• Com --max-lines <n>, a transcrição é truncada para as últimas n linhas, e a transcrição anterior é arquivada como um arquivo auxiliar .bak.
• --agent <id>: agente proprietário da sessão; obrigatório para chaves global.
• --url / --token / --password: substituições da conexão do Gateway.
• --timeout <ms>: tempo limite RPC opcional do lado do cliente, em milissegundos.
• --json: exibe o payload RPC bruto.

O comando é encerrado com código diferente de zero quando o Gateway informa uma Compaction com falha ou está inacessível, para que crons e scripts nunca confundam uma operação silenciosa sem efeito com sucesso.

RPC sessions.compact

openclaw gateway call sessions.compact --params '<json>' aceita:

Exemplo de resposta de sumarização por LLM:

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }}

Exemplo de resposta de truncamento (--max-lines 200):

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",  "kept": 200}

Relacionado

• Configuração de sessão
• Gerenciamento de sessões
• Compaction
• Referência da CLI