Configura openclaw node para ejecución remota

Seguro que te ha pasado: necesitas que un agente ejecute tareas en un servidor específico, pero no quieres instalar aplicaciones pesadas ni gestionar configuraciones complejas en cada máquina de tu red. Intentar coordinar ejecuciones en servidores de build o un NAS suele ser un proceso tedioso si no tienes una forma directa de conectar los equipos.

openclaw node resuelve esto permitiéndote ejecutar un host sin interfaz (headless) que se conecta al Gateway vía WebSocket. Esto expone system.run y system.which en esa máquina específica. Es la mejor opción para delegar tareas a otros equipos manteniendo el control total de la ejecución.

What You’ll Need

• Un Gateway activo para recibir la conexión del nodo.
• Acceso a la terminal en la máquina que actuará como host.

Quick Start

La forma más rápida de conectar una máquina es ejecutar el nodo en primer plano. Usa el siguiente comando especificando la dirección de tu Gateway:

openclaw node run --host \<gateway-host\> --port 18789

Si prefieres que el nodo funcione de forma permanente en segundo plano, instálalo como un servicio del sistema:

openclaw node install --host \<gateway-host\> --port 18789

Tras ejecutar el comando por primera vez, el nodo quedará en espera. Debes aprobar la solicitud de emparejamiento desde el Gateway:

openclaw nodes pending
openclaw nodes approve \<requestId\>

Gestión del servicio

Si instalaste el nodo como servicio, puedes controlarlo con estos comandos:

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

Configuración de seguridad

La ejecución de comandos está protegida por aprobaciones locales. El nodo utiliza estos mecanismos para validar el acceso:

• Configuración en ~/.openclaw/exec-approvals.json.
• Listas de permisos por agente configuradas en el host.
• Gestión remota mediante openclaw approvals --node <id|name|ip> desde el Gateway.

Browser proxy

Los hosts de tipo node anuncian automáticamente un proxy de navegador. Esto permite al agente realizar automatizaciones de navegador en ese nodo sin configuración adicional. Si necesitas desactivarlo, usa esta configuración en el archivo del nodo:

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

Troubleshooting

• Solicitud de emparejamiento no aparece: La primera conexión crea una solicitud pendiente en el Gateway. Asegúrate de ejecutar openclaw nodes pending para ver el ID necesario para la aprobación.
• Error de conexión TLS: Si tu Gateway usa TLS, debes incluir el flag --tls. Si el certificado es autofirmado, utiliza --tls-fingerprint <sha256> con el fingerprint correspondiente para validar la conexión.
• Reinstalación del servicio: Si necesitas cambiar parámetros de un servicio ya instalado (como el --runtime), utiliza el flag --force en el comando install.
• Ubicación de datos: Si el nodo pierde su identidad, verifica el archivo ~/.openclaw/node.json, donde se almacena el ID del nodo, el token y la información de conexión.

¿Necesitas ayuda con la configuración? Prueba el AI Setup Assistant.

What’s Next

• Exec approvals