Skill Backup para OpenClaw
Hacer backup y restaurar config/skills/commands de OpenClaw.
Última actualización: 2026-03-13
Instalación Rápida
$ npx clawhub@latest install backupFunciones Clave de Backup
Descripción General del Skill Backup de OpenClaw
El skill Backup le da a tu agente OpenClaw la capacidad de crear snapshots y restaurar toda tu configuración — skills, comandos, ajustes, integraciones MCP, contextos y plantillas — con una simple petición en lenguaje natural. Si alguna vez perdiste un setup funcional después de una mala actualización o un skill mal configurado, esta es la red de seguridad que necesitas.
Las configuraciones de OpenClaw están distribuidas en múltiples directorios y archivos bajo ~/.claude/. Rastrear manualmente qué cambió y cuándo es tedioso y propenso a errores. El skill OpenClaw Backup automatiza todo el proceso: crea archivos tar.gz con marca de tiempo, soporta modos de backup selectivos y puede sincronizar tu setup entre máquinas usando Git, rsync o almacenamiento en la nube como Dropbox y Google Drive.
Flujo de trabajo típico:
- Pide a OpenClaw que haga backup de tu setup actual antes de instalar un nuevo skill.
- El agente empaqueta tu configuración en un archivo con marca de tiempo en
~/openclaw-backups/. - Si algo se rompe, pide a OpenClaw que restaure desde el último backup — tu setup funcional vuelve en segundos.
Este skill se complementa naturalmente con el skill Config Guardian, que valida cambios de configuración en tiempo real, y con el skill 1Password para gestionar de forma segura los tokens API incluidos en tus backups.
Requisitos Previos para el Skill Backup
Antes de instalar el skill Backup, asegúrate de tener:
- OpenClaw instalado y funcionando (v1.0+)
- Espacio en disco suficiente para archivos de backup (típicamente 5–50 MB por snapshot según la cantidad de skills)
- clawhub CLI instalado para gestión de skills
- Git (opcional) — solo necesario si quieres historial de backup con control de versiones
Verifica tu entorno:
# Verificar versión de OpenClaw openclaw --version # Verificar espacio en disco disponible df -h ~/openclaw-backups # Verificar clawhub CLI clawhub --version
Cómo Instalar el Skill Backup
Instala el skill Backup con un solo comando:
npx clawhub@latest install backup
Para verificar la instalación:
clawhub list
Deberías ver backup en la lista de skills instalados. Instala con clawhub CLI para la experiencia más rápida.
Configuración del Skill Backup
El skill Backup funciona directamente con valores predeterminados sensatos. Puedes personalizar el comportamiento mediante variables de entorno.
Configuración del Entorno
# Directorio de backup personalizado (predeterminado: ~/openclaw-backups) export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups" # Número máximo de backups a retener (predeterminado: 7) export OPENCLAW_BACKUP_RETENTION=7 # Habilitar backups automáticos antes de actualizaciones (predeterminado: true) export OPENCLAW_BACKUP_AUTO=true
Qué se Respalda
El skill archiva los siguientes directorios y archivos por defecto:
| Ruta | Contenido |
|------|-----------|
| ~/.claude/skills/ | Definiciones de skills instalados |
| ~/.claude/commands/ | Comandos personalizados |
| ~/.claude/settings.json | Configuración y preferencias del agente |
| ~/.claude/mcp/ | Configuraciones de servidores MCP |
| ~/.claude/contexts/ | Contextos de sesión |
| ~/.claude/templates/ | Plantillas personalizadas |
Los archivos de caché y logs se excluyen automáticamente — se regeneran al iniciar y solo aumentarían el tamaño del archivo.
Importante: Los archivos de backup pueden contener tokens API, secretos y credenciales almacenados en tu configuración o configs MCP. Guarda los backups en una ubicación segura y nunca los subas a repositorios públicos.
Ejemplos de Uso del Skill Backup
1. Crear un Backup Completo
Tú: "Haz backup de toda mi configuración de OpenClaw antes de instalar el nuevo skill de Kubernetes."
El agente crea un archivo con marca de tiempo (ej. openclaw-2026-03-13_1045.tar.gz) que contiene todos los archivos de configuración. Al completar, reporta la ruta del archivo, tamaño y cantidad de elementos.
2. Backup Selectivo Solo de Skills
Tú: "Respalda solo mis skills instalados, quiero probar eliminar algunos."
El agente ejecuta un backup solo de skills, archivando únicamente el directorio ~/.claude/skills/. Es más rápido y produce un archivo más pequeño cuando solo necesitas proteger las definiciones de skills.
3. Restaurar desde un Backup
Tú: "Algo se rompió después de esa actualización. Restaura desde mi último backup."
El agente lista los backups disponibles, muestra el más reciente con su marca de tiempo y contenido, y pide confirmación antes de restaurar. Primero valida la integridad del archivo, luego detiene el agente, reemplaza la configuración actual y reinicia — tu setup funcional está de vuelta.
4. Listar y Gestionar Backups
Tú: "Muéstrame todos mis backups y cuánto espacio ocupan."
El agente lista todos los archivos en tu directorio de backup, ordenados por fecha, con tamaños. Señala los backups que superan el período de retención y ofrece limpiarlos.
5. Sincronizar Backups a un Remoto
Tú: "Sube mi último backup al repo Git de backups."
El agente hace commit del último archivo en tu repositorio Git configurado y lo pushea al remoto. Esto habilita historial de versiones y acceso multidispositivo — clona el repo en otra máquina y restaura desde cualquier snapshot.
Seguridad y Mejores Prácticas de Backup
Los archivos de backup contienen tu configuración completa de OpenClaw, que puede incluir datos sensibles. Sigue estas pautas para mantenerte seguro:
- Encripta backups sensibles. Si tu configuración incluye claves API o tokens, encripta los archivos antes de almacenarlos en la nube. Usa
gpgo tu gestor de secretos. - Restringe permisos de archivos. Mantén los archivos de backup legibles solo por tu usuario:
chmod 700 ~/openclaw-backups. - Nunca subas backups a repos públicos. Agrega
~/openclaw-backups/a tu.gitignoreglobal para prevenir exposición accidental. - Rota backups antiguos. Configura
OPENCLAW_BACKUP_RETENTIONpara limpiar automáticamente archivos antiguos. Siete backups es un valor predeterminado razonable. - Verifica restauraciones periódicamente. Prueba el proceso de restauración antes de necesitarlo realmente. Restaura a un directorio temporal para confirmar la integridad del archivo.
- Usa Config Guardian junto con Backup. Config Guardian valida cambios en tiempo real, mientras Backup proporciona recuperación a un punto en el tiempo. Juntos forman una red de seguridad completa. Revisa la Lista de Seguridad para guías generales de seguridad de OpenClaw.
Solución de Errores Comunes de Backup
"No backups found in ~/openclaw-backups"
El directorio de backup está vacío o no existe.
- Confirma que el directorio existe:
ls -la ~/openclaw-backups
- Si personalizaste la ruta, verifica que
OPENCLAW_BACKUP_DIResté configurado correctamente:
echo $OPENCLAW_BACKUP_DIR
- Pide a OpenClaw que cree el primer backup: "Haz backup de mi configuración ahora."
"Permission denied when creating backup archive"
El directorio de backup no tiene permisos de escritura.
# Corregir permisos chmod 700 ~/openclaw-backups # O crear el directorio si no existe mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups
"Backup archive is corrupted — restore failed"
El archivo se dañó durante el almacenamiento o transferencia.
- Prueba la integridad del archivo:
tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null
- Si está corrupto, intenta con el backup anterior en la lista de retención.
- Para backups sincronizados con Git, verifica si un commit anterior tiene un archivo sano:
git log --onelineen el repo de backup.
Preguntas Frecuentes
Sí, pero toma precauciones. Los archivos locales que crea el skill pueden contener tokens API, credenciales de base de datos y otros secretos de tu configuración de OpenClaw y configs MCP. Guarda los backups en un directorio con permisos restringidos (`chmod 700`), encripta los archivos antes de subirlos a la nube, y nunca subas backups sin encriptar a repositorios públicos. El skill en sí no transmite datos externamente — todas las operaciones son locales a menos que configures explícitamente Git o sincronización en la nube.
Sí, ese es uno de los casos de uso principales. Crea un backup completo en la máquina origen, transfiere el archivo a la máquina destino (vía `scp`, USB, almacenamiento en la nube o un repo Git compartido), y pide a OpenClaw que restaure desde el archivo transferido. El skill valida el archivo antes de restaurar y maneja las diferencias de rutas entre máquinas. Para sincronización continua multidispositivo, configura backup basado en Git con un repositorio remoto privado.
El skill Backup crea snapshots de un punto en el tiempo — archivos completos de tu configuración que puedes restaurar si algo sale mal. [Config Guardian](/skills/config-guardian) trabaja en tiempo real, validando cada cambio de configuración y bloqueando modificaciones inválidas. Son complementarios: Config Guardian previene que se apliquen cambios incorrectos, mientras Backup te permite volver a un estado conocido y funcional si algo se escapa. Para máxima protección, instala ambos.
Skills Relacionados
Validar y proteger actualizaciones de config de OpenClaw.
Gestionar contexto de sesión para reducir prompts descontrolados y ruido.