rdp-cli
Cómo usar una Raspberry Pi como cliente RDP de un agente de IA para Windows
Una Raspberry Pi es pequeña, económica y adecuada para ejecutar automatización por línea de comandos. Puede funcionar como cliente RDP dedicado para un agente de IA que necesita controlar Windows remoto.
La arquitectura es:
Agente de IA → Raspberry Pi → rdp-cli → sesión RDP de Windows
La Pi no sustituye a Windows. Ejecuta rdp-cli y proporciona al agente acceso a la pantalla y a la entrada remotas.
Requisitos
Usa una Raspberry Pi 4, un sistema Raspberry Pi OS o Debian de 64 bits, una ruta de red hacia Windows, RDP habilitado y una cuenta autorizada.
La guía oficial de plataformas lista Raspberry Pi 4 con Debian 13.7 de 64 bits como configuración física probada. Raspberry Pi OS de 32 bits no está admitido; otros modelos deben probarse por separado.
Instalación y conexión
Descarga el archivo Linux ARM64 y ejecútalo:
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
Conecta con Windows mediante una entrada de contraseña protegida:
printf '%s' "$RDP_PASSWORD" |
./rdp-cli-linux-arm64 connect --host WINDOWS_IP --user WINDOWS_USER --password-stdin
Guarda el ID de sesión y no escribas contraseñas directamente en scripts o registros.
Observar, actuar y verificar
Antes de cada acción importante, el agente debe capturar una pantalla nueva:
./rdp-cli-linux-arm64 screenshot --session SESSION --out before.png
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out after.png
Así puede abrir una aplicación de inventario, iniciar sesión, seleccionar un almacén, introducir un SKU, confirmar un diálogo, guardar y verificar el estado. La guía rápida explica este flujo.
Archivos, control humano y límites
Si el servidor RDP permite la redirección de unidades, rdp-cli puede subir archivos o carpetas completas y descargar resultados. Las funciones de archivos incluyen progreso, cancelación, confirmación de sobrescritura y verificación del contenido.
Una persona puede abrir la misma sesión en un visor nativo o navegador autorizado, pausar al agente, corregir algo y devolverle el control. VNC permite ver y controlar, pero no ofrece la misma transferencia nativa de carpetas.
rdp-cli no convierte automáticamente una aplicación Windows en una aplicación con API ni sustituye las pruebas unitarias, de backend o de rendimiento.
FAQ
¿Necesito un escritorio gráfico en la Pi? No. rdp-cli es un cliente de línea de comandos.
¿rdp-cli ejecuta el agente de IA? No. El agente o el framework de automatización llama a sus comandos.
Conclusión
Una Raspberry Pi 4 de 64 bits puede ser un host ligero para automatizar aplicaciones Windows antiguas:
Capturar pantalla → realizar una acción → capturar de nuevo → verificar el resultado.