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 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:
Acompanhar o progresso da trajetória
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
/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 usa as configurações de session.maintenance da configuração (Referência de configuração):
- Observação sobre o escopo:
openclaw sessions cleanupmanté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 formatoagent:*:explicit:model-run-<uuid>. A retenção é fixa em24he 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.
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:
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.
- 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 últimasnlinhas, e a transcrição anterior é arquivada como um arquivo auxiliar.bak. --agent <id>: agente proprietário da sessão; obrigatório para chavesglobal.--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.
openclaw agent --message '/compact ...' não é um caminho de Compaction. Comandos de barra
da CLI são rejeitados pela verificação de remetente autorizado; essa
invocação é encerrada com código diferente de zero e fornece orientações que apontam para esta página, em vez de
não realizar nenhuma operação silenciosamente.RPC sessions.compact
openclaw gateway call sessions.compact --params '<json>' aceita:
Exemplo de resposta de sumarização por LLM:
--max-lines 200):