OpenClaw

A quem se destina e interface concreta

Este guia conecta agentes OpenClaw à memória persistente XMemo. O OpenClaw opera por meio de uma arquitetura de duas camadas: o plugin de memória nativo do OpenClaw no ClawHub fornece vinculação de ferramentas em tempo de execução, enquanto a Skill complementar fornece orientação de recall proativo e pontos de verificação de sessão.

Pré-requisitos

Certifique-se de que as seguintes dependências de tempo de execução e ferramentas estejam presentes antes de conectar:

• Tempo de execução do agente OpenClaw instalado e operacional.
• Acesso a pacotes do ClawHub habilitado.
• Conta válida do XMemo em https://xmemo.dev.
• Versão de tempo de execução do Node.js 22.22.0 ou superior ao instalar a Skill complementar.

Caminho recomendado: Plugin nativo mais Skill complementar

O caminho recomendado instala o plugin de memória nativo do OpenClaw do ClawHub e a Skill complementar diretamente por meio do gerenciamento de pacotes do OpenClaw:

openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo

Opções de autorização e credenciais

Configure credenciais por meio de variáveis de ambiente ou login interativo no dispositivo. Nunca use login simples sem escolher seu caminho de armazenamento de credenciais primeiro:

• Credencial de ambiente (recomendado): Defina XMEMO_KEY no shell ou no ambiente de serviço que inicializa o OpenClaw.
• Login interativo: Se estiver usando a Skill complementar, execute login com --allow-plaintext apenas quando o secret-store XMEMO_KEY não estiver disponível (observe que --allow-plaintext armazena a credencial sem criptografia neste computador).
• Verificar credenciais: Execute openclaw plugins list para confirmar a ativação do plugin e verifique o status de autenticação com a Skill complementar.

Caminho alternativo: Executor de serviço headless

Para executores OpenClaw headless ou pipelines de CI automatizados, passe XMEMO_KEY diretamente por meio de variáveis de ambiente para o plugin sem prompts interativos.

export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory

Verificação de conexão (somente leitura)

Sempre verifique a conectividade com uma solicitação somente leitura antes de gravar dados. Esta verificação não modifica o estado da memória.

• Verificação: Inicie uma sessão de teste do OpenClaw e emita uma consulta de recall ativo para o contexto de projeto existente.
• Sinal de sucesso: O OpenClaw retorna resultados de memória estruturados com campos Reference e Location válidos do espaço de trabalho autorizado.

Primeira tarefa útil: Ciclo de vida de memória sintética

Verifique a persistência da memória, transição de sessão sem estado, recall atribuído à fonte e correção:

• 1. Salvar fato sintético: Armazene uma convenção de projeto ("Demo project timestamps use UTC.") em "projects/demo-onboarding/conventions".
• 2. Transição sem estado: Encerre a conversa atual do OpenClaw e inicie uma nova sessão.
• 3. Recall com atribuição de fonte: Consulte "demo project timestamp format". Confirme Reference e Location retornados.
• 4. Corrigir memória: Atualize a convenção lembrada com a formatação ISO 8601.
• 5. Limpeza opcional: Realize exclusão lógica da convenção de demonstração quando a verificação de integração for concluída.

Recursos e fluxos de trabalho de memória

Os fluxos de trabalho do OpenClaw agrupam ações por resultado nas sessões do agente:

• Recall ativo proativo: Injeta automaticamente memórias duráveis relevantes no contexto ativo antes do planejamento.
• Continuidade de sessão: Salva e restaura instantâneos de reinicialização, rastreia decisões e mantém TODOs em transferências.
• Camada de resiliência: Cache de recall de curta duração e caixa de saída de gravação transitória lidam com breves interrupções de rede.

Limitações e limites

Restrições operacionais para a integração do OpenClaw:

• Isolamento do espaço de trabalho: Cada operação é estritamente limitada ao espaço de trabalho do usuário autenticado.
• Disponibilidade do ClawHub: Registros de terceiros não testados ou bifurcações não oficiais do plugin são marcados como não testados.
• Escopo do livro-razão: Resumos mensais do livro-razão e ferramentas de auditoria financeira exigem escopos comerciais dedicados.

Recuperação, atualização e remoção

Procedimentos de solução de problemas e manutenção para o OpenClaw:

• Recuperação (plugin não carregado): Execute openclaw plugins list e verifique os logs do OpenClaw para erros de inicialização.
• Recuperação (autenticação expirada): Exporte novamente um XMEMO_KEY válido ou reautentique por meio da Skill complementar.
• Atualização: Para atualizar plugins e skills instalados, consulte a documentação de gerenciamento de plugins do OpenClaw.
• Remoção: Para remover ou desativar plugins e skills instalados, consulte a documentação de gerenciamento de plugins do OpenClaw.