AstronRPA로 Agent가 조작하는 오픈소스 Windows RPA 구축하기

사내 업무 자동화는 보통 두 갈래로 나뉩니다. 화면을 눌러야 하는 RPA와 판단을 맡기는 에이전트입니다. AstronRPA는 이 둘을 한 흐름에 묶으려는 오픈소스 데스크톱 RPA 도구입니다. 공식 README와 릴리스 문서를 확인했습니다.

개요

AstronRPA는 Windows 데스크톱 앱과 웹 페이지 자동화를 Visual Designer에서 짜는 구조입니다. README 기준으로 Windows 10/11을 주 지원 대상으로 두고, 서버 쪽은 Docker Compose 배포를 제공합니다. 최신 릴리스는 v1.1.6이고 Windows x64 설치 파일이 올라와 있습니다.

1. 왜 쓸 만한가

저라면 AstronRPA를 단순 매크로 도구보다 “에이전트가 호출할 수 있는 업무 자동화 런타임” 쪽으로 보겠습니다. README에서 강조하는 지점도 Visual Designer, 300개 이상 원자 기능, 스케줄 실행, API 호출, MCP 서비스, Astron Agent 양방향 호출입니다.

• 화면 자동화: Windows 앱, 웹 페이지, Office/WPS, ERP 같은 업무 프로그램 조작.
• 구성 방식: low-code/no-code 디자이너와 커스텀 컴포넌트 확장.
• 운영 기능: 터미널 모니터링, 스케줄링, 로봇 팀 공유, 권한 관리.
• 에이전트 연결: RPA 노드를 Astron Agent에서 부르고, Agent workflow를 AstronRPA에서 호출.

운영 PC에서 화면 조작 권한을 어디까지 줄지 먼저 정해야 합니다. RPA는 사람 계정으로 업무 화면을 누르는 도구라서 권한 설계가 느슨하면 사고 범위도 커집니다.

1. 적용 대상

반복 입력, 사내 웹 시스템 처리, Excel·브라우저·업무 프로그램을 오가는 작업에 맞습니다. 기존에 n8n 같은 서버 자동화만 쓰다가 화면 조작 단계에서 막힌 경우도 검토 대상입니다. 서버 자동화 흐름은 Docker Compose로 n8n 설치하기처럼 먼저 정리해두면 RPA와 역할을 나누기 쉽습니다.
반대로 API가 잘 열려 있고 백엔드 배치로 끝나는 작업이면 RPA까지 붙일 이유는 적습니다. Windows 데스크톱 앱을 운영할 수 없는 환경도 맞지 않습니다.

사전 준비 사항

• Windows 10/11 클라이언트.
• 메모리 8GiB 이상 권장.
• 서버 배포용 Docker 환경.
• 클라이언트 빌드 시 Node.js 22 이상, Python 3.13.x, JDK 8 이상, pnpm 9 이상, UV 0.8 이상.
• 최신 Windows 설치 파일은 AstronRPA Releases에서 확인하시면 됩니다.

1. 서버 설치

README의 빠른 배포 경로는 docker 폴더에서 .env를 복사하고 Compose를 올리는 방식입니다. 실제 IP는 공개 글에 남기지 않고 placeholder로 둡니다.

git clone https://github.com/iflytek/astron-rpa.git
cd astron-rpa/docker
cp .env.example .env

.env에서 Casdoor 외부 주소를 서버 주소로 맞춥니다.

CASDOOR_EXTERNAL_ENDPOINT="http://<서버_IP>:8000"
docker compose up -d
docker compose ps

README 기준으로 http://<서버_IP>:32742/api/rpa-auth/user/login-check에서 {"code":"900001","data":null,"message":"unauthorized"}가 나오면 인증 서비스 연결은 열린 상태입니다. http://<서버_IP>:8000에서 Casdoor 로그인 화면도 확인해주시면 됩니다.

1. 클라이언트 설정

바이너리를 쓰면 릴리스 페이지의 AstronRPA-1.1.6-x64.exe를 받는 흐름입니다. 직접 빌드한다면 프로젝트 루트에서 build.bat를 실행합니다.

build.bat --python-exe "C:\Program Files\Python313\python.exe"

설치 뒤에는 설치 폴더의 resources/conf.yaml에서 서버 주소를 맞춥니다.

remote_addr: http://<서버_IP>:32742/
skip_engine_start: false

여기서 remote_addr는 서버의 RPA 인증·관리 서비스 포트와 맞아야 합니다. 포트를 바꿨다면 클라이언트 설정도 같이 바꾸시면 됩니다.

확인

서버는 아래 순서로 확인합니다.

docker compose ps
curl http://<서버_IP>:32742/api/rpa-auth/user/login-check

Compose 서비스가 떠 있고 unauthorized 응답이 돌아오면 서버 연결 확인은 끝난 상태입니다. Windows 클라이언트에서는 resources/conf.yaml 저장 후 AstronRPA를 실행해 로그인 화면과 디자이너 진입 여부를 확인합니다.