Skill Backup para OpenClaw

Visão Geral do Skill Backup do OpenClaw

O skill Backup dá ao seu agente OpenClaw a capacidade de criar snapshots e restaurar toda a sua configuração — skills, comandos, configurações, integrações MCP, contextos e templates — com uma simples solicitação em linguagem natural. Se você já perdeu um setup funcional após uma atualização ruim ou um skill mal configurado, esta é a rede de segurança que você precisa.

As configurações do OpenClaw estão distribuídas em múltiplos diretórios e arquivos sob ~/.claude/. Rastrear manualmente o que mudou e quando é tedioso e propenso a erros. O skill OpenClaw Backup automatiza todo o processo: cria arquivos tar.gz com timestamp, suporta modos de backup seletivos e pode sincronizar seu setup entre máquinas usando Git, rsync ou armazenamento em nuvem como Dropbox e Google Drive.

Fluxo de trabalho típico:

1. Peça ao OpenClaw para fazer backup do seu setup atual antes de instalar um novo skill.
2. O agente empacota sua configuração em um arquivo com timestamp em ~/openclaw-backups/.
3. Se algo quebrar, peça ao OpenClaw para restaurar do último backup — seu setup funcional volta em segundos.

Este skill combina naturalmente com o skill Config Guardian, que valida mudanças de configuração em tempo real, e com o skill 1Password para gerenciar com segurança os tokens API incluídos nos seus backups.

Pré-requisitos para o Skill Backup

Antes de instalar o skill Backup, certifique-se de ter:

• OpenClaw instalado e rodando (v1.0+)
• Espaço em disco suficiente para arquivos de backup (tipicamente 5–50 MB por snapshot dependendo da quantidade de skills)
• clawhub CLI instalado para gerenciamento de skills
• Git (opcional) — necessário apenas se você quiser histórico de backup com controle de versão

Verifique seu ambiente:

# Verificar versão do OpenClaw
openclaw --version

# Verificar espaço em disco disponível
df -h ~/openclaw-backups

# Verificar clawhub CLI
clawhub --version

Como Instalar o Skill Backup

Instale o skill Backup com um único comando:

npx clawhub@latest install backup

Para verificar a instalação:

clawhub list

Você deve ver backup na lista de skills instalados. Instale com clawhub CLI para a experiência mais rápida.

Configuração do Skill Backup

O skill Backup funciona imediatamente com padrões sensatos. Você pode personalizar o comportamento através de variáveis de ambiente.

Configuração do Ambiente

# Diretório de backup personalizado (padrão: ~/openclaw-backups)
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# Número máximo de backups a reter (padrão: 7)
export OPENCLAW_BACKUP_RETENTION=7

# Habilitar backups automáticos antes de atualizações (padrão: true)
export OPENCLAW_BACKUP_AUTO=true

O que é Feito Backup

O skill arquiva os seguintes diretórios e arquivos por padrão:

| Caminho | Conteúdo | |---------|----------| | ~/.claude/skills/ | Definições de skills instalados | | ~/.claude/commands/ | Comandos personalizados | | ~/.claude/settings.json | Configurações e preferências do agente | | ~/.claude/mcp/ | Configurações de servidores MCP | | ~/.claude/contexts/ | Contextos de sessão | | ~/.claude/templates/ | Templates personalizados |

Arquivos de cache e log são automaticamente excluídos — eles se regeneram na inicialização e só aumentariam o tamanho do arquivo.

Importante: Arquivos de backup podem conter tokens API, segredos e credenciais armazenados nas suas configurações ou configs MCP. Armazene backups em um local seguro e nunca os commite em repositórios públicos.

Exemplos de Uso do Skill Backup

1. Criar um Backup Completo

Você: "Faça backup de todo o meu setup OpenClaw antes de eu instalar o novo skill de Kubernetes."

O agente cria um arquivo com timestamp (ex. openclaw-2026-03-13_1045.tar.gz) contendo todos os arquivos de configuração. Ao completar, reporta o caminho do arquivo, tamanho e quantidade de itens.

2. Backup Seletivo Apenas de Skills

Você: "Faça backup apenas dos meus skills instalados, quero testar remover alguns."

O agente executa um backup apenas de skills, arquivando somente o diretório ~/.claude/skills/. É mais rápido e produz um arquivo menor quando você só precisa proteger definições de skills.

3. Restaurar de um Backup

Você: "Algo quebrou depois daquela atualização. Restaure do meu último backup."

O agente lista os backups disponíveis, mostra o mais recente com timestamp e conteúdo, e pede confirmação antes de restaurar. Primeiro valida a integridade do arquivo, depois para o agente, substitui a configuração atual e reinicia — seu setup funcional está de volta.

4. Listar e Gerenciar Backups

Você: "Mostre todos os meus backups e quanto espaço ocupam."

O agente lista todos os arquivos no seu diretório de backup, ordenados por data, com tamanhos. Sinaliza backups que ultrapassam o período de retenção e oferece limpá-los.

5. Sincronizar Backups para um Remoto

Você: "Faça push do meu último backup para o repo Git de backups."

O agente commita o último arquivo no seu repositório Git configurado e faz push para o remoto. Isso habilita histórico de versões e acesso multidispositivo — clone o repo em outra máquina e restaure de qualquer snapshot.

Segurança e Boas Práticas de Backup

Arquivos de backup contêm sua configuração OpenClaw completa, que pode incluir dados sensíveis. Siga estas diretrizes para se manter seguro:

• Criptografe backups sensíveis. Se sua configuração inclui chaves API ou tokens, criptografe os arquivos antes de armazenar na nuvem. Use gpg ou seu gerenciador de segredos.
• Restrinja permissões de arquivos. Mantenha arquivos de backup legíveis apenas pelo seu usuário: chmod 700 ~/openclaw-backups.
• Nunca commite backups em repos públicos. Adicione ~/openclaw-backups/ ao seu .gitignore global para prevenir exposição acidental.
• Rotacione backups antigos. Configure OPENCLAW_BACKUP_RETENTION para limpar automaticamente arquivos antigos. Sete backups é um padrão razoável.
• Verifique restaurações periodicamente. Teste o processo de restauração antes de realmente precisar. Restaure em um diretório temporário para confirmar a integridade do arquivo.
• Use Config Guardian junto com Backup. Config Guardian valida mudanças em tempo real, enquanto Backup fornece recuperação point-in-time. Juntos formam uma rede de segurança completa. Consulte a Lista de Segurança para diretrizes gerais de segurança do OpenClaw.

Resolução de Erros Comuns de Backup

"No backups found in ~/openclaw-backups"

O diretório de backup está vazio ou não existe.

1. Confirme que o diretório existe:

ls -la ~/openclaw-backups

2. Se você personalizou o caminho, verifique se OPENCLAW_BACKUP_DIR está configurado corretamente:

echo $OPENCLAW_BACKUP_DIR

3. Peça ao OpenClaw para criar o primeiro backup: "Faça backup da minha configuração agora."

"Permission denied when creating backup archive"

O diretório de backup não tem permissão de escrita.

# Corrigir permissões
chmod 700 ~/openclaw-backups

# Ou criar o diretório se não existir
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

O arquivo foi danificado durante o armazenamento ou transferência.

1. Teste a integridade do arquivo:

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. Se corrompido, tente o backup anterior na lista de retenção.
3. Para backups sincronizados com Git, verifique se um commit anterior tem um arquivo saudável: git log --oneline no repo de backup.