# OpenClaw

Conecte o OpenClaw por meio de seu plugin de memória nativo no ClawHub com orientação opcional de Skill complementar para recall proativo.

- Canonical: https://docs.xmemo.dev/pt-br/docs/connect/openclaw
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: c1ce97e0231b187bac1701fceb894f880bb49f8d6d6dc391398e5decdaf4ff3f
- Edition-Digest: d19892177d86788930590fb7de6d15cdfb851d40eed7ffb6e56c594351f13ef7
- Source-Revision: sha256:8f465eb1d6ca0b120934289273aff9d3c032c43de12f628d3bf82b19ef4657b5

## 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:

```bash
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.

```bash
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.

## OpenClaw

Direct client: configure in ~/.openclaw/openclaw.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add openclaw to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```