Eu perdi uma semana de configuração do OpenClaw uma vez. Não por causa de um hack ou uma falha de hardware. Porque fiz uma atualização de sistema que corrompeu meu cartão SD. Tudo — minha configuração, minhas habilidades personalizadas, meus arquivos de memória, minhas definições de tarefas agendadas — foi embora.
Recriar tudo levou um fim de semana inteiro. E a pior parte: eu sabia que deveria ter backups. Eu só continuei adiando porque “vou configurar amanhã.”
Aqui está a estratégia de backup que uso agora. Leva 20 minutos para configurar e roda automaticamente. Sem desculpas.
O que precisa ser salvo
Nem tudo. O OpenClaw em si pode ser reinstalado. O sistema operacional pode ser reinstalado. O que **não** pode ser facilmente recriado:
Arquivos de configuração. Sua configuração principal (YAML), chaves de API, configurações de modelo, configurações de integração. Isso são horas de ajuste cuidadoso que você não quer refazer.
Arquivos de memória e espaço de trabalho. Memória de longo prazo, notas diárias, documentação de projetos, instruções personalizadas. Este é o conhecimento acumulado do seu agente.
Habilidades personalizadas. Quaisquer habilidades que você escreveu ou modificou. Habilidades da comunidade podem ser reinstaladas, mas suas personalizadas existem apenas na sua máquina.
Histórico de sessões. Opcional — depende de você se importar com as conversas passadas. Eu mantenho 30 dias de histórico para referência, mas eu não choraria se desaparecesse.
Definições de tarefas agendadas. Suas tarefas programadas e suas configurações. Recriar isso de memória é propenso a erros.
A Estratégia de Backup
Três camadas, cada uma servindo a um propósito diferente:
Camada 1: Backup local diário. Uma tarefa agendada que roda às 2 AM, copia os diretórios críticos para uma pasta datada na mesma máquina. Isso protege contra exclusão acidental e erros de configuração. Se eu bagunçar um arquivo de configuração às 3 PM, posso restaurar a versão da noite anterior em segundos.
Retenção: 7 dias de backups diários. Os mais antigos são automaticamente excluídos.
Camada 2: Backup remoto diário. Após a conclusão do backup local, o rsync copia o backup para uma segunda máquina (eu uso um NAS na minha rede doméstica, mas um VPS barato também funciona). Isso protege contra falhas de hardware. Se o cartão SD do Pi pifar, o backup existe em outro lugar.
O comando rsync é simples: rsync -az --delete /backup/openclaw/ nas:/backups/openclaw/. A flag --delete mantém a cópia remota em sincronia sem crescer indefinidamente.
Camada 3: Backup semanal na nuvem. Todo domingo, os arquivos de configuração críticos (apenas as coisas pequenas — configuração, habilidades, arquivos de memória — cerca de 5MB no total) são criptografados e enviados para o armazenamento na nuvem. Esta é a camada de recuperação de desastres. Se minha casa pegar fogo e levar o Pi e o NAS, ainda terei minhas configurações.
Eu uso o rclone para sincronizar com o Backblaze B2 (centavos por mês por essa quantidade de dados). Os arquivos são criptografados localmente antes do upload usando GPG.
O Script de Backup
Todo o backup é um único script bash, com cerca de 30 linhas:
1. Defina os diretórios para fazer backup (configuração, espaço de trabalho, habilidades, sessões)
2. Crie um tarball datado desses diretórios
3. Mantenha os últimos 7 tarballs locais, exclua os mais antigos
4. Rsync o último tarball para o servidor remoto
5. Aos domingos: criptografe e faça upload para armazenamento na nuvem
6. Registre o resultado (sucesso/falha, tamanhos, duração)
O script roda via cron às 2 AM diariamente. Tempo total de execução: cerca de 30 segundos para uma instalação típica.
Testando Restaurações
Um backup que você nunca testou não é um backup — é uma esperança.
Todo mês, faço um teste de restauração. Não no meu Pi de produção — em um cartão SD reserva. Reinstalo um SO fresco, instalo o OpenClaw, restauro do backup e verifico se tudo funciona. Todo o teste leva cerca de 30 minutos.
Coisas que já peguei em testes de restauração:
– Um caminho de backup que mudou após uma atualização do OpenClaw (a estrutura do diretório mudou)
– Uma definição de tarefa agendada que referenciou um caminho local não incluído no backup
– Uma chave de API que foi armazenada em uma variável de ambiente em vez do arquivo de configuração (e, portanto, não foi salva)
Cada uma dessas situações teria sido uma surpresa desagradável durante uma recuperação real. Melhor encontrá-las durante um teste tranquilo no sábado do que durante uma emergência às 3 AM.
O Procedimento de Recuperação
Quando as coisas dão errado, você quer uma lista de verificação, não uma árvore de decisões. Aqui está a minha:
1. Reinstale um SO fresco em um novo cartão SD / SSD
2. Instale o Node.js e o OpenClaw
3. Copie o tarball de backup para o novo sistema
4. Extraia para os diretórios corretos
5. Verifique as chaves de API e conexões
6. Inicie o OpenClaw e verifique a funcionalidade básica
7. Verifique as tarefas agendadas e as programações
8. Verifique se os arquivos de memória e espaço de trabalho estão intactos
Tempo total de recuperação: cerca de 45 minutos de um cartão SD em branco até um sistema totalmente operacional. Compare isso com o fim de semana que passei reconstruindo sem backups.
O Que a Maioria das Pessoas Erra
Fazendo backups demais. Você não precisa fazer backup de todo o sistema. O sistema operacional e o OpenClaw em si são facilmente reinstaláveis. Faça backup apenas do que é único para a sua instalação.
Não fazendo backup de chaves de API. Se suas chaves de API estão em variáveis de ambiente em vez de arquivos de configuração, elas não estarão no seu backup. Mova-as para o arquivo de configuração ou mantenha um documento seguro separado com todas as chaves.
Sem cópia remota. Um backup na mesma máquina que falha não é backup algum. No mínimo, copie para uma segunda máquina. A versão mais simples: envie-se por email o arquivo de configuração uma vez por semana.
Nunca testando restaurações. Teste seu processo de restauração antes de precisar dele. O momento de descobrir que seu backup está incompleto não é durante uma emergência.
🕒 Published: