rdp-cli
Raspberry Pi를 Windows용 AI 에이전트 RDP 클라이언트로 사용하는 방법
Raspberry Pi는 작고 저렴하며 명령줄 자동화를 계속 실행하기 좋습니다. 따라서 원격 Windows 데스크톱을 제어하는 AI 에이전트 전용 RDP 클라이언트로 사용할 수 있습니다.
구성은 다음과 같습니다.
AI 에이전트 → Raspberry Pi → rdp-cli → Windows RDP 세션
Pi가 Windows를 대신하는 것은 아닙니다. Pi에서 rdp-cli가 실행되며 원격 화면과 입력을 AI 에이전트에 제공합니다.
요구 사항
현재 ARM64 버전에는 Raspberry Pi 4, 64비트 Raspberry Pi OS 또는 Debian, Windows로 연결되는 네트워크, RDP가 활성화된 Windows, 권한이 있는 계정이 필요합니다.
공식 플랫폼 안내에는 Raspberry Pi 4와 64비트 Debian 13.7이 테스트 구성으로 나와 있습니다. 32비트 Raspberry Pi OS는 지원되지 않으며 다른 모델은 직접 검증해야 합니다.
설치와 연결
Linux ARM64 파일을 다운로드한 후 실행합니다.
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
Windows 연결 예시:
printf '%s' "$RDP_PASSWORD" |
./rdp-cli-linux-arm64 connect --host WINDOWS_IP --user WINDOWS_USER --password-stdin
반환된 세션 ID를 저장하고 비밀번호를 코드나 로그에 직접 기록하지 마세요.
관찰—작업—검증
AI 에이전트는 중요한 작업 전에 새 스크린샷을 캡처해야 합니다.
./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
재고 앱 열기, 로그인, 창고 선택, SKU 입력, 팝업 확인, 저장과 상태 검증 같은 GUI 흐름을 자동화할 수 있습니다. 빠른 시작 가이드는 최신 화면을 확인한 뒤 작업하는 방식을 설명합니다.
파일 전송과 사람의 제어
RDP 서버에서 드라이브 리디렉션을 허용하면 파일과 폴더를 세션 교환 드라이브로 업로드하고 결과를 다시 다운로드할 수 있습니다. 파일 기능은 진행률, 취소, 덮어쓰기 확인과 전송 내용 검증을 지원합니다.
사람은 네이티브 뷰어나 승인된 브라우저로 같은 세션을 열어 Agent를 일시 중지하고 수정한 뒤 제어를 돌려줄 수 있습니다. VNC는 보기와 제어를 지원하지만 동일한 RDP 폴더 전송은 제공하지 않습니다.
FAQ와 정리
Pi에 데스크톱 환경이 필요한가요? 아니요. rdp-cli는 명령줄 클라이언트입니다.
rdp-cli 자체가 AI 에이전트인가요? 아니요. AI 에이전트나 자동화 프레임워크가 명령을 호출합니다.
Raspberry Pi 4는 레거시 Windows GUI 자동화를 위한 가벼운 호스트가 될 수 있습니다.
화면 캡처 → 한 번의 작업 → 새 화면 캡처 → 결과 확인.