persistent-sshfs es una utilidad de Openclaw Skills basada en Bash que reintenta los montajes SSHFS hasta que se conectan, y luego depende de la reconexión de sshfs para la recuperación de caídas transitorias.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install persistent-sshfs
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar persistent-sshfs usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es persistent-sshfs?
persistent-sshfs es una utilidad de Bash para activar de manera confiable montajes SSHFS en entornos donde la red, la VPN o el host remoto pueden no estar listos al inicio. Reintenta continuamente la autenticación SSH basada en clave para cada montaje y, una vez que la conectividad está disponible, monta el directorio remoto con sshfs -o reconnect.
Esta entrada de Openclaw Skills está diseñada para desarrolladores y operadores que necesitan un montaje SSHFS repetible y programable con un archivo de montajes de texto plano simple. No es un monitor en tiempo real; en su lugar, finaliza después de que los montajes se realizan con éxito y está pensado para ejecutarse de forma periódica, lo que lo hace ideal para flujos de trabajo de recuperación basados en cron o temporizadores de systemd.
Casos de uso de persistent-sshfs
- Monte directorios remotos de desarrollo, compilación o respaldo localmente a través de SSHFS con reintento automático hasta que el host sea accesible.
- Active los montajes en el arranque o inicio de sesión cuando la disponibilidad de la red, la VPN o el SSH pueda retrasarse.
- Mantenga múltiples montajes SSHFS administrados desde un único archivo de configuración de texto plano.
- Recupere los montajes después de desconexiones transitorias usando
sshfs -o reconnect. - Vuelva a ejecutar según una programación para volver a montar cualquier elemento que haya caído por completo, sin verificar manualmente cada montaje.
- Estandarice el montaje basado en claves SSH en hosts y puertos sin solicitudes de contraseña.
Cómo funciona persistent-sshfs
- Define cada montaje en un archivo de texto plano utilizando el formato
local_dir:user@host:port:remote_dir. - El script lee el archivo e inicia un proceso de fondo (worker) por cada montaje.
- Cada worker verifica repetidamente la autenticación SSH basada en clave utilizando
ssh -o BatchMode=yes -o PasswordAuthentication=nohasta que tiene éxito. - Once la autenticación está disponible, el worker monta la ruta remota con
sshfs -o reconnect. - Después de confirmar que el montaje está activo, el worker finaliza y el proceso principal espera a que terminen todos los workers.
- Si un montaje se cae más tarde y
sshfsno puede recuperarlo, la solución prevista es ejecutar el script de nuevo, o programar ejecuciones recurrentes con cron o un temporizador de systemd.
Configuración de persistent-sshfs
- Asegúrese de que los binarios requeridos estén instalados:
bash
sshfs
ssh
fusermount
- Cree su archivo de montajes con una entrada por línea:
/home/bob/mnt/build-box:[email protected]:22:/srv/build
/home/bob/mnt/backup-nas:[email protected]:2222:/volume1/backups
Asegúrese de que sus claves SSH ya funcionen de forma no interactiva. Esta skill rechaza la autenticación por contraseña y solo espera autenticación basada en claves.
Ejecute el script contra su archivo de montajes:
persistent-sshfs mounts.txt
Para la persistencia tras los reinicios o fallas completas de montaje, programe ejecuciones periódicas con cron o un temporizador de systemd para que Openclaw Skills pueda volver a montar cualquier cosa que esté caída actualmente.
Si el proceso se interrumpe de forma limpia con
SIGINToSIGTERM, desmonta y detiene los workers. Si muere conSIGKILL, limpie manualmente los montajes residuales:
mount | grep fuse.sshfs
fusermount -u /path/to/mount
Esquema de datos y taxonomía de persistent-sshfs
La skill utiliza un esquema mínimo basado en archivos sin configuración en YAML o JSON.
| Campo | Formato | Propósito |
|---|---|---|
local_dir |
ruta del sistema de archivos local | Punto de montaje local; creado con mkdir -p si no existe |
user@host |
destino SSH | Extremo SSH remoto pasado a ssh y sshfs |
port |
entero/cadena | Puerto SSH utilizado para la conexión y el montaje |
remote_dir |
ruta del sistema de archivos remoto | Directorio en el host remoto que se expondrá localmente |
Reglas del archivo de montaje:
- Un montaje por línea.
- Estructura delimitada por dos puntos:
local_dir:user@host:port:remote_dir. - Las líneas en blanco o con formato incorrecto no se manejan de manera especial, por lo que el archivo debe mantenerse limpio.
Comportamiento en tiempo de ejecución:
- Un proceso worker por montaje.
- Los workers reintentan la autenticación cada 10 segundos hasta que el SSH basado en clave tiene éxito.
- Los montajes utilizan
sshfs -o reconnectpara la recuperación de red transitoria. - El proceso finaliza con éxito después de que todos los montajes estén activos; no actúa como un demonio permanente.
Metadados operativos:
- Nivel de registro predeterminado:
INFO - Sobrescritura de verbosidad soportada:
LOG_LEVEL=DEBUG|INFO|ERROR - Captura de limpieza: desmonta los montajes activos y finaliza los workers en un apagado controlado.
Funciones avanzadas de persistent-sshfs
- Los workers en segundo plano por montaje permiten levantar múltiples objetivos SSHFS en paralelo.
- Bucle de reintento infinito para la autenticación SSH inicial basada en clave, ideal para flujos de trabajo en el arranque y dependientes de VPN.
- Utiliza
sshfs -o reconnectpara sobrevivir a caídas transitorias de la red sin lógica de reconexión personalizada. - La captura de apagado limpio maneja
SIGINTySIGTERMdesmontando y deteniendo los workers. - Diseñado para ejecutarse periódicamente, permitiendo la recuperación basada en cron o temporizadores de systemd para montajes que fallaron por completo.
- El archivo de montajes de texto plano simple facilita generar, versionar o crear plantillas de definiciones de montaje en flujos de automatización.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Adaptador de Pensamiento Deep Learner
Openclaw Skills adapta las explicaciones de IA para aprendices de primeros principios, comenzando desde el paso cero con un razonamiento claro, analogías y validación de conjeturas.
Habilidad de Publicación Social Schedulala
Las Openclaw Skills para Schedulala automatizan la creación, validación, programación, publicación y monitoreo de publicaciones sociales en 12 plataformas.
Configuración y Verificación de SandBase MCP
SandBase Openclaw Skills le ayuda a conectar, configurar y verificar de forma segura el servidor SandBase MCP en clientes de IA compatibles sin exponer secretos.
SQLGuard — Autorizar antes de modificar
SQLGuard Autorizar antes de modificar es una puerta de seguridad de Openclaw Skills que requiere un recibo de permiso verificado antes de que se ejecute cualquier escritura de SQL de producción.
supervisor-config-gen
supervisor-config-gen es una utilidad de bash sin flags que genera una configuración de programa de Supervisor a partir del directorio de aplicación actual utilizando un punto de entrada run.sh obligatorio.
WorkBuddy Workspace Relay
Openclaw Skills para empaquetar de forma segura un espacio de trabajo de WorkBuddy en un archivo de handoff cifrado y restaurarlo en otra máquina para continuar con el desarrollo.
METADATA
Presentado*
