Backup Automático do Workspace

Introdução

Seu workspace do OpenClaw é único: contém a personalidade que você definiu para o assistente no soul.md, semanas ou meses de memórias acumuladas, configurações finely tuned de integrações, histórico de conversas e automações que você construiu ao longo do tempo. Perder tudo isso por falha de hardware, formatação acidental ou migração de computador seria como começar do zero.

Esta receita configura backups automáticos e confiáveis do seu workspace, sem que você precise pensar nisso. Toda semana — ou com frequência que escolher — o OpenClaw comprime tudo, salva localmente e envia para a nuvem, e te confirma quando concluído. Se algo der errado, restaurar é uma questão de minutos.

Um backup não é paranoia — é a diferença entre “oh não” e “tudo bem, só preciso restaurar”. Veja as práticas de segurança recomendadas e explore o guia de configuração avançada para entender todos os arquivos do seu workspace.

Como Funciona

Agendamento automático: O OpenClaw executa o script de backup no horário configurado
Compressão: Todos os arquivos relevantes são comprimidos em um único arquivo tar.gz
Limpeza local: Backups antigos além do número configurado são removidos automaticamente
Upload para nuvem (opcional): O arquivo é enviado para Google Drive, Dropbox ou S3
Verificação de integridade: O sistema confirma que o backup está válido e não corrompido
Notificação: Você recebe confirmação (ou alerta de falha) no canal configurado

O Que é Feito Backup

Todos os arquivos críticos do workspace OpenClaw:

SOUL.md — a personalidade e instruções do assistente
MEMORY.md — memória de longo prazo e contextos importantes
memory/ — logs diários de interações
~/.openclaw/config.yaml — configurações, integrações e API keys
~/.openclaw/sessions/ — histórico de conversas
skills/ — skills e automações personalizados que você criou

O que não é incluído (por segurança e tamanho):

node_modules/ (pode ser reinstalado)
Cache e arquivos temporários
Logs de debug excessivos

Configuração Passo a Passo

Passo 1: Criar o Script de Backup

Salve o script abaixo em ~/scripts/backup-openclaw.sh:

#!/bin/bash
# backup-openclaw.sh — Backup automático do workspace OpenClaw

DATE=$(date +%Y-%m-%d)
TIME=$(date +%H%M)
BACKUP_DIR=~/backups/openclaw
WORKSPACE=~/clawd
CONFIG=~/.openclaw
KEEP_BACKUPS=8  # Manter últimos 8 backups

# Criar diretório se não existir
mkdir -p $BACKUP_DIR

echo "[$(date)] Iniciando backup OpenClaw..."

# Comprimir workspace + configurações
tar -czf $BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz \
    --exclude="$WORKSPACE/node_modules" \
    --exclude="$WORKSPACE/.cache" \
    --exclude="$CONFIG/logs/debug*" \
    $WORKSPACE \
    $CONFIG 2>/dev/null

if [ $? -eq 0 ]; then
    SIZE=$(du -sh $BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz | cut -f1)
    echo "[$(date)] Backup concluído: openclaw-$DATE-$TIME.tar.gz ($SIZE)"

    # Remover backups antigos
    ls -t $BACKUP_DIR/openclaw-*.tar.gz | tail -n +$((KEEP_BACKUPS + 1)) | xargs -r rm
    echo "[$(date)] Mantidos os $KEEP_BACKUPS backups mais recentes"

    exit 0
else
    echo "[$(date)] ERRO: Backup falhou!"
    exit 1
fi

Torne executável:

chmod +x ~/scripts/backup-openclaw.sh

Passo 2: Configurar Agendamento via OpenClaw

Envie para o OpenClaw:

Configure backup automático do meu workspace:

Todo domingo às 3h:
1. Execute: ~/scripts/backup-openclaw.sh
2. Se bem-sucedido: me avise no Telegram com o tamanho do arquivo
3. Se falhar: me avise URGENTE com o erro para eu corrigir

Também execute um backup antes de qualquer atualização do OpenClaw.

Passo 3: Configurar Backup para Nuvem (Recomendado)

Opção A: Google Drive

Após cada backup local bem-sucedido:
1. Faça upload do arquivo .tar.gz para Google Drive
2. Pasta: "Backups/OpenClaw"
3. Mantenha apenas os 4 backups mais recentes no Drive
4. Me confirme com o link do arquivo no Drive

Opção B: Amazon S3

# Adicione ao script de backup:
aws s3 cp $BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz \
    s3://seu-bucket/openclaw-backups/ \
    --storage-class STANDARD_IA  # Mais barato para arquivos raramente acessados

Opção C: Dropbox (via API)

curl -X POST "https://content.dropboxapi.com/2/files/upload" \
    -H "Authorization: Bearer $DROPBOX_TOKEN" \
    -H "Dropbox-API-Arg: {\"path\": \"/openclaw-backups/openclaw-$DATE.tar.gz\"}" \
    --data-binary @$BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz

Passo 4: Verificação de Integridade

Adicione ao script de backup para verificar que o arquivo não está corrompido:

# Verificar integridade
tar -tzf $BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz > /dev/null 2>&1
if [ $? -ne 0 ]; then
    echo "ERRO: Arquivo de backup corrompido!"
    exit 1
fi

# Verificar tamanho mínimo (backup válido deve ter mais de 50KB)
SIZE_BYTES=$(stat -f%z "$BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz" 2>/dev/null || stat -c%s "$BACKUP_DIR/openclaw-$DATE-$TIME.tar.gz")
if [ "$SIZE_BYTES" -lt 51200 ]; then
    echo "ERRO: Backup muito pequeno (${SIZE_BYTES} bytes) — possível problema"
    exit 1
fi

Personalização

Frequência por Criticidade

Configure frequência de backup:
- Backup completo: domingos às 3h (semanal)
- Backup incremental (só soul.md e config): todo dia às 2h
- Backup de emergência: automaticamente antes de mudanças importantes
  (atualização do OpenClaw, mudança de modelo de IA, edição do soul.md)

Retenção por Destino

Política de retenção:
- Local (~/backups): manter últimos 8 backups (2 meses)
- Google Drive: manter últimos 4 backups (1 mês)
- Se quiser economizar espaço, delete os locais após upload para o Drive

Exemplos de Uso

Notificação de Backup Bem-Sucedido

✅ BACKUP OPENCLAW CONCLUÍDO

 Arquivo: openclaw-2026-01-26-0300.tar.gz
 Tamanho: 4.2 MB
 Local: ~/backups/openclaw/
☁ Drive: Backup/OpenClaw/ ✓

Conteúdo incluído:
• soul.md (12 KB)
• MEMORY.md (45 KB)
• memory/ (156 arquivos, 2.8 MB)
• config.yaml (4 KB)
• skills/ (8 arquivos, 180 KB)

Próximo backup: domingo, 02/02 às 3h
Backups mantidos: 7/8

Notificação de Falha

 FALHA NO BACKUP OPENCLAW

❌ O backup agendado para domingo às 3h falhou.

Erro: "No space left on device"
Disco local: 99.8% ocupado (248 GB / 250 GB)

Ações necessárias:
1. Libere espaço em disco (deletar backups antigos ou outros arquivos)
2. Ou configure backup direto para Google Drive sem cópia local
3. Rode manualmente após corrigir: ~/scripts/backup-openclaw.sh

Me avise quando corrigir para confirmar que o próximo backup funcionará.

Restaurar a Partir de Backup

Se precisar restaurar após um problema:

# 1. Liste backups disponíveis
ls -la ~/backups/openclaw/

# 2. Extraia o backup (substitua a data)
tar -xzf ~/backups/openclaw/openclaw-2026-01-26-0300.tar.gz -C /

# 3. Reinicie o OpenClaw
openclaw gateway restart

Ou peça via chat:

“Restaure meu workspace do backup de 26 de janeiro”

O OpenClaw lista os backups disponíveis, pede confirmação e executa a restauração com segurança (fazendo backup do estado atual antes de restaurar).

Dicas Avançadas

Teste a restauração periodicamente: Um backup que não pode ser restaurado não é um backup. Todo mês, teste restaurar em um diretório temporário para confirmar que está funcionando: tar -tzf backup.tar.gz | head -20.
Criptografe backups sensíveis: Seu workspace pode conter API keys e informações pessoais. Criptografe com GPG antes do upload para nuvem: gpg --symmetric --cipher-algo AES256 backup.tar.gz.
Backup offsite é essencial: Disco local pode falhar. Se você faz backup local mas não para nuvem, está protegido apenas contra exclusão acidental — não contra falha de hardware.
Versionamento no Google Drive: Ative o histórico de versões no Google Drive para ter ainda mais proteção — mesmo que um arquivo corrompido seja enviado, você pode recuperar versões anteriores.
Alerta de backup antigo: Configure para que o OpenClaw avise se o último backup tiver mais de 14 dias: “Avise-me se não houver backup dos últimos 14 dias no Drive.”

FAQ

Com que frequência devo fazer backup? Depende de quanta atividade você tem. Para usuários ativos (uso diário), backups semanais com backup incremental diário do soul.md e config é o ideal. Para uso casual, backup mensal pode ser suficiente.

Posso fazer backup do OpenClaw enquanto ele está rodando? Sim. Os arquivos de configuração e memória podem ser copiados com o OpenClaw ativo. Para garantir consistência, o script pode pausar o gateway por alguns segundos durante a cópia, mas geralmente não é necessário.

Como migrar o workspace para um novo computador?

Faça backup no computador antigo
Instale o OpenClaw no novo
Copie o arquivo de backup
Extraia: tar -xzf backup.tar.gz -C /
Execute openclaw auth para reautenticar integrações As configurações e memórias serão restauradas; apenas tokens de acesso precisam ser renovados.

O backup inclui o histórico de conversas? Sim, se você configurou o OpenClaw para manter histórico de sessões em arquivo (configuração sessions.save_history: true). As conversas ficam em ~/.openclaw/sessions/.

Como reduzir o tamanho dos backups? Exclua o diretório memory/ se não precisar do histórico diário detalhado — esse costuma ser o maior arquivo. Apenas soul.md, config.yaml e MEMORY.md representam o essencial do seu workspace.

Receitas Relacionadas

Deploy Notify — faça backup automático antes de atualizações
Guia de segurança — práticas completas de proteção do workspace
Guia de configuração avançada — entenda todos os arquivos do workspace OpenClaw
Skills personalizados — automatize verificações de integridade customizadas
Integração com Google Drive — configuração detalhada para backup na nuvem

Primeiros Passos

Conectar

Aprender

Ajuda

Recursos

Buscar

Comunidade

Backup Automático do Workspace — Receita OpenClaw