Migración de un agente de IA autoalojado: Lo único que no se puede ejecutar en paralelo

Axel Grubba, 02 de octubre de 2026
Deja que la IA gestione tu pequeña empresa con Crevio
Crevio Logotipo de plataformas de comercio electrónico
Crevio
Patrocinado
5.0
(1)
Plan libre disponible
Crevio Es la IA que gestiona tu pequeña empresa: crea tu sitio web, encuentra a tus clientes, recibe pagos... Obtenga más información sobre Crevio
Obtén un resumen de IA de esta publicación en:

Todas las guías de migración siguen el mismo patrón: crear el nuevo servidor, ejecutar ambos en paralelo, reducir el TTL del DNS, invertir el registro y desactivar el antiguo. Es un buen consejo para un sitio web.

Para un agente de IA te hará perder el messagesy la razón es estructural más que una cuestión de cuidados.

Un agente no es algo que los usuarios conecten aEs algo que conecta out — a Telegram, a WhatsApp, a Slack — y mantiene esas conexiones abiertas. Esos canales permiten el acceso a un único consumidor a la vez. Dos instancias que poseen el mismo token de bot de Telegram o la misma sesión vinculada de WhatsApp no ​​comparten la carga; luchan y se mezclan.sages caen por el hueco.

Por lo tanto, el patrón correcto es más estrecho que el habitual: construcción en paralelo, corte exclusivo.

Línea de tiempo que muestra el servidor antiguo funcionando con canales conectados mientras el nuevo servidor se construye y valida con los canales desactivados, lo cual es seguro para ejecutar en paralelo porque el nuevo servidor no mantiene ninguna sesión de canal; luego una ventana de transferencia donde el servidor antiguo debe detenerse antes de que el nuevo comience, porque ambos conectados significan mensajes perdidossages; luego el nuevo servidor que presta servicio con canales conectados

Primero, averigüe si el DNS importa en absoluto.

Antes de reducir cualquier TTL, pregúntese qué apunta realmente a la dirección IP del servidor. En muchos casos, la respuesta es nada.

  • Telegram OpenClaw utiliza el sondeo prolongado por defecto, y la documentación especifica que «el sondeo prolongado es el transporte predeterminado; el modo webhook es opcional». El agente se conecta a Telegram. Tu dirección IP es irrelevante.
  • WhatsApp vía Baileys — una conexión saliente de WhatsApp Web. También realiza llamadas salientes.
  • Un panel de control al que puedes acceder a través de Tailscale. — No hay DNS público involucrado.

El DNS solo importa si algún tráfico entrante apunta al servidor : un panel de control público en un dominio, un webhook de Telegram si habilitaste ese modo deliberadamente, o servicios de terceros que te envían solicitudes POST. Si este es tu caso, reduce el TTL a 300 segundos con un día de antelación. Si no lo es, omite por completo la configuración del DNS; es un procedimiento propio de las migraciones web que no aplica aquí.

Construye el nuevo decodificador con los canales apagados.

Esta es la parte que puedes hacer sin problemas en paralelo, y es donde se consume el tiempo de todos modos.

Aprovisionar, reforzar e instalar: con todos los canales de mensajería deshabilitados en la configuración . Una nueva puerta de enlace con los canales desactivados puede funcionar durante días junto a la antigua sin conflictos, ya que no mantiene ninguna sesión de canal.

Valida lo que puedas sin canales:

openclaw doctor
openclaw gateway status
curl -fsS http://127.0.0.1:18789/healthz

Si accedes a un panel de control mediante el nombre de host, pruébalo antes de que cambie el DNS anulando la resolución localmente en lugar de modificar el registro:

# /etc/hosts on your laptop
203.0.113.10   agent.example.com

Eso te da el nombre de host real que apunta al nuevo servidor solo para tu máquina. Elimina la línea siguiente; una entrada de hosts obsoleta puede ser muy confusa de depurar dos semanas después.

Sincronizar el estado

Dos pasadas de rsync: una masiva mientras el servidor antiguo aún está activo y una incremental durante el período de transferencia.

# bulk pass, old server still serving
rsync -aHAX --numeric-ids --info=progress2 \
  ~/.openclaw/ user@new-server:~/.openclaw/

-a conserva los permisos y las marcas de tiempo, -H enlaces duros, -AX ACL y atributos extendidos, --numeric-ids Evita la reasignación de la propiedad a través de tablas de usuarios que no coinciden.

Sepa qué directorios está moviendo , porque los agentes guardan secretos en más de un lugar. Para OpenClaw específicamente:

  • el directorio de configuración — openclaw.json, perfiles de autenticación de proveedores almacenados y el .env teniendo su token de puerta de enlace
  • el directorio secreto del perfil de autenticación, que se almacena deliberadamente por separado. y contiene la clave de cifrado para el material del token respaldado por OAuth.
  • credenciales de WhatsApp en ~/.openclaw/credentials/whatsapp/<accountId>/creds.json

Si copias el directorio de configuración sin el directorio secreto, la autenticación del proveedor almacenada llegará como un archivo que ya no podrás descifrar. Esa es la migración que aparentemente se completa con éxito, pero luego deja de poder autenticarse sin previo aviso.

Si se ejecuta en Docker, el equivalente son las rutas de host montadas en lugar del contenedor; lo que persiste dónde cubre la asignación.

La ventana de entrega

Ahora viene la parte que debe ser secuencial. Que sea breve: un par de minutos es lo normal.

1. Detenga el agente anterior. Detenga toda la puerta de enlace, no solo el puerto web del contenedor. El objetivo es que ningún proceso mantenga una conexión de canal activa.

# old server
sudo systemctl stop openclaw     # or: docker compose down

Para WhatsApp existe una opción más limpia que una detención brusca, ya que el cierre de sesión de OpenClaw "detiene primero al oyente en vivo de esa cuenta, por lo que la sesión vinculada deja de recibir mensajes".sages antes del siguiente reinicio”. Úselo cuando desee una liberación definitiva en lugar de esperar que el proceso haya terminado correctamente.

2. Sincronización delta final. El mismo comando que antes; ahora solo mueve lo que cambió, que son los segundos.

3. Habilite los canales en el nuevo decodificador y enciéndalo.

# new server
sudo systemctl start openclaw
openclaw channels status --probe

4. Envía un mensaje realsage en cada canal y confirmar una respuesta. No status salida: un verdadero messagePorque el estado puede parecer saludable aunque la entrega no lo sea. En el caso específico de WhatsApp, una respuesta solo se considera entregada una vez que el transporte devuelve un mensaje saliente.sage ID.

5. Deja el servidor antiguo apagado, pero no destruido, durante una semana. Cuesta unos pocos euros y es la única forma de revertir los cambios.

Canal por canal

Telegrama (sondeo — opción predeterminada). No hay nada que volver a señalar. El token del bot está en tu configuración, se movió con la sincronización y la nueva instancia comienza a sondear. El único fallo a tener en cuenta: si la instancia antigua todavía está sondeando, la nueva obtiene un getUpdates el conflictoPorque Telegram permite un solo usuario de ese token. Si ves eso, significa que algo sigue funcionando en el servidor antiguo.

Telegram (modo webhook, solo si lo seleccionaste). Actualizar webhookUrl al nuevo host y reiniciar. Tenga en cuenta que el oyente reserva /healthz, asi que webhookPath Debe ser una ruta diferente. También vale la pena saber: un webhook que se dejó registrado desde el host antiguo entrará en conflicto con el sondeo en el nuevo, que aparece como el mismo. getUpdates Se trata de un conflicto en lugar de un error evidente del webhook.

WhatsApp. La sesión vinculada reside en ese directorio de credenciales y está asociada al dispositivo vinculado , no a una dirección IP; por lo tanto, si la sincronizaste, la sesión debería reanudarse sin necesidad de escanear un nuevo código QR. Si te pide un código QR, las credenciales no llegaron intactas; restáuralas en lugar de volver a vincularlas, ya que volver a vincularlas en el nuevo dispositivo invalida el enlace anterior y elimina la reversión. Nunca ejecutes ambas instancias con las mismas credenciales de WhatsApp; es lo más perjudicial que puedes hacer durante esta migración.

Integraciones con Slack, Discord y webhooks. Estas son las que realmente necesitan ser reconfiguradas, ya que contienen una URL de tu propiedad. Actualiza las URL de suscripción a eventos y webhooks en cada servicio de terceros después de que se haya cambiado el DNS y prueba cada una. Este es el paso que la gente suele olvidar, y el sistema falla silenciosamente: el agente parece funcionar correctamente, pero simplemente deja de recibir información del servicio.

Luego verifique correctamente

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Y antes de relajarte, comprueba la configuración del nuevo equipo, porque un servidor nuevo tiene una configuración predeterminada nueva: confirmar que no se está escuchando públicamente nada que no deba ser escuchadoSi migraste a una implementación basada en Docker, recuerda ufw No filtra los puertos publicados por Docker.

También es importante prestar atención a la memoria durante el primer día. Un nuevo host con una asignación de RAM diferente es donde se manifiestan los errores de memoria insuficiente (OOM kills ), que se presentan como la interrupción del agente a mitad de la tarea con un registro vacío, lo que durante una migración podría llevar a la tentación de atribuirlo a la migración.

¿Adónde mudarse?

Si está migrando porque el servidor actual es demasiado pequeño, elija el tamaño adecuado para la carga de trabajo en lugar de basarse en el consumo actual: 4 GB es el mínimo para un agente de solo texto y 8 GB en el momento en que interviene la automatización del navegador , ya que un único Chromium sin interfaz gráfica requiere entre 1 y 2 GB por sí solo.

Hostinger es el lugar de aterrizaje más fácil: RAM generosa por nivel y una ruta OpenClaw de un solo clic si prefieres no reconstruir manualmente. Hetzner Es la opción más económica por gigabyte cuando su nivel CX está disponible; conviene comprobarlo antes de contratarlo, ya que ese nivel aparecía como no disponible la última vez que lo revisamos, y la línea CPX a la que se recurriría es varias veces más cara. Si está disponible, es la mejor opción si te sientes cómodo administrando un servidor básico, lo cual es evidente si estás leyendo un manual de migración.

Nuestra guía sobre los mejores VPS para OpenClaw compara precios y ofrece información sobre cómo alojar OpenClaw en un VPS, incluyendo la creación del nuevo servidor con el endurecimiento de seguridad realizado previamente.

Cómo lo comprobamos

Los comportamientos del canal aquí provienen de la propia documentación de OpenClaw, leída en agosto de 2026: que el sondeo largo es el transporte predeterminado de Telegram y el modo webhook es opcional, que un consumidor competidor aparece como un getUpdates conflicto, que la autenticación de WhatsApp vive en ~/.openclaw/credentials/whatsapp/<accountId>/creds.jsonque al cerrar sesión se detiene el oyente activo antes del siguiente reinicio, y que el directorio secreto del perfil de autenticación se almacena por separado del directorio de configuración. La restricción de un solo consumidor es la razón por la que este manual de procedimientos se aparta de las recomendaciones habituales de ejecución en paralelo.

Lo que no hicimos: no realizamos esta migración de principio a fin para este artículo. La secuencia se basa en el comportamiento documentado y la práctica estándar, en lugar de una ejecución cronometrada, y el paso que más recomendamos considerar como obligatorio es el que no cuesta nada: mantener el servidor antiguo apagado durante una semana en lugar de destruirlo, para que el problema de funcionamiento tenga solución.

Además, hemos omitido deliberadamente una cifra de tiempo total de inactividad. Depende de la cantidad de información que se esté sincronizando y de cuántas integraciones de terceros necesiten reconfigurarse, y cualquier cifra en este caso sería una estimación disfrazada de referencia.

Los dos enlaces de alojamiento web mencionados anteriormente son enlaces de afiliados y solo son relevantes si te mudas porque necesitas un equipo diferente. Nada en el manual de procedimientos requiere cambiar de proveedor.

Preguntas Frecuentes

¿Puedo ejecutar el agente antiguo y el nuevo al mismo tiempo durante la migración?

Solo con los canales de mensajería de la nueva instancia deshabilitados. Dos instancias que poseen el mismo token de bot de Telegram o sesión de WhatsApp entran en conflicto en lugar de compartirse: Telegram permite un solo consumidor de un token, y una sesión vinculada de WhatsApp pertenece a un solo cliente. Compile en paralelo, transfiera exclusivamente.

¿Necesito cambiar el DNS para migrar un agente de IA?

A menudo no. Los agentes se conectan a plataformas de mensajería, por lo que ningún registro de entrada apunta a ellos. El DNS solo importa si tienes un panel de control público, usas el modo webhook de Telegram o recibes webhooks de servicios de terceros.

¿Tendré que escanear el código QR de WhatsApp de nuevo?

No, si el directorio de credenciales se sincroniza correctamente: la sesión está vinculada al dispositivo conectado, no a la IP del servidor. Si solicita un código QR, restaure las credenciales en lugar de volver a vincularlas, ya que volver a vincularlas invalida la sesión anterior y anula la reversión.

¿Por qué mi nuevo agente está recibiendo un... getUpdates ¿conflicto?

Otro proceso sigue consumiendo ese token de Telegram; normalmente, la instancia anterior que aún se ejecuta, o en ocasiones, un webhook registrado desde el host anterior. Detén completamente la puerta de enlace anterior y borra cualquier webhook si habías habilitado el modo webhook.

¿Qué es exactamente lo que necesito copiar?

El directorio de configuración (que incluye los perfiles de autenticación del proveedor y los secretos del entorno), el directorio secreto del perfil de autenticación (que se almacena por separado) que contiene la clave de cifrado para el token OAuth y las credenciales del canal, como el directorio de autenticación de WhatsApp. Copiar la configuración sin el directorio secreto genera una autenticación almacenada que no se puede descifrar.

¿Cuánto tiempo debo conservar el servidor antiguo?

Una semana, apagado en lugar de eliminado. Es la reversión más económica disponible, y los fallos de integración (una suscripción a Slack que nunca se reconfiguró) suelen aparecer días después, en lugar de en el momento de la migración.

¿En qué orden debo hacerlo?

Construir y validar el nuevo decodificador con los canales desactivados, rsync masivo, detener la puerta de enlace antigua, rsync delta, iniciar la nueva con los canales activados, enviar un mensaje realsage En cada canal, luego redirigir los webhooks de terceros. Secuencial solo donde sea necesario.

Fundador y editor de reseñas de software
Axel Grubba es el fundador de Findstack, una plataforma de comparación de software B2B, con experiencia en consultoría de gestión y capital de riesgo donde invirtió en software. Recientemente, Axel ha desarrollado una pasión por la codificación y disfruta viajar cuando no está construyendo y mejorando Findstack.
Reseñas de software empresarial Evaluación de productos SaaS Software CRM
Suscríbase y reciba ofertas de software directamente en su bandeja de entrada.
Recibir el boletín Más de 9,300 empresarios más mantenerse actualizado sobre las últimas ofertas.
Cero spam. Darse de baja en cualquier momento.