라즈베리파이4에 오픈클로(OpenClaw) 이미지를 설치하려면 운영체제 이미지를 microSD 카드에 정확히 기록한 뒤, 전원·저장장치·네트워크 상태를 순서대로 확인해야 합니다. 설치 자체는 어렵지 않지만 이미지 파일 형식, 라즈베리파이4 지원 여부, 전원 부족, 잘못된 microSD 카드 선택 때문에 첫 부팅에서 멈추는 경우가 많습니다.
이 가이드는 라즈베리파이4 오픈클로 이미지를 microSD 카드에 설치하고, 화면 또는 네트워크 접속으로 정상 부팅 여부를 확인하는 과정에 초점을 맞춥니다. 오픈클로 배포처마다 초기 계정, 네트워크 설정 방식, 관리 화면 주소가 다를 수 있으므로 계정 정보와 설치 후 설정 항목은 반드시 해당 이미지의 공식 안내를 함께 확인해야 합니다.
핵심 요약
✔ 라즈베리파이4용인지, 64비트 환경을 요구하는지 먼저 확인합니다.
✔ 이미지 파일은 신뢰할 수 있는 공식 배포처에서 내려받고 가능하면 체크섬을 검증합니다.
✔ Raspberry Pi Imager 또는 Balena Etcher로 microSD 카드에 이미지를 기록합니다.
✔ 첫 부팅은 HDMI 화면 연결이 가장 확인하기 쉽고, 화면이 없다면 공유기 관리 페이지나 SSH 접속을 이용합니다.
✔ 부팅 실패 시 전원 어댑터, microSD 카드, 이미지 호환성 순서로 점검합니다.
━━━━━━━━━━━━━━━━
설치 전 확인할 준비물
라즈베리파이4 오픈클로 설치에는 다음 장비와 프로그램이 필요합니다.
라즈베리파이4 보드
라즈베리파이4는 모델별 메모리 용량이 다르므로, 오픈클로 이미지 배포 문서에서 최소 메모리 요구 사항을 확인하는 것이 좋습니다. 일반적으로 컨테이너, 웹 관리 화면, 추가 서비스 등을 함께 사용한다면 여유 있는 메모리 구성이 관리에 편합니다.
microSD 카드
용량은 이미지 파일 크기와 설치 후 사용할 데이터 용량을 고려해 준비합니다. 저장장치 품질이 낮거나 오래된 카드에서는 부팅 오류, 파일 시스템 손상, 속도 저하가 발생할 수 있습니다. 중요한 데이터를 운영할 계획이라면 microSD 카드보다 USB SSD 같은 외부 저장장치 구성을 검토할 수 있습니다.
정격 전원 어댑터
라즈베리파이4는 USB-C 전원을 사용합니다. 전원 공급이 불안정하면 화면이 켜지지 않거나, 부팅 중 재시작되거나, USB 장치가 인식되지 않을 수 있습니다. 안정적인 전원 어댑터와 상태가 좋은 케이블을 사용합니다.
네트워크 환경
유선 LAN 연결이 가장 단순합니다. 무선 연결을 사용할 수 있는지는 오픈클로 이미지의 초기 설정 방식에 따라 달라집니다. 처음 설치할 때는 가능하면 유선 LAN을 연결해 두는 편이 문제 확인에 유리합니다.
작업용 PC 또는 노트북
Windows, macOS, Linux 중 하나가 설치된 컴퓨터가 필요합니다. 이 컴퓨터에서 오픈클로 이미지 파일을 내려받고 microSD 카드에 기록합니다.
이미지 기록 프로그램
Raspberry Pi Imager 또는 Balena Etcher 같은 이미지 기록 도구를 사용할 수 있습니다. Raspberry Pi Imager는 라즈베리파이 환경에서 널리 쓰이며, Balena Etcher는 이미지 파일을 선택해 기록하는 방식이 단순합니다.
━━━━━━━━━━━━━━━━
오픈클로 이미지 파일을 내려받는 방법
먼저 오픈클로 공식 문서, 공식 저장소, 공식 배포 페이지에서 라즈베리파이4 지원 이미지를 확인합니다. 같은 오픈클로 이미지라도 라즈베리파이 전용인지, 일반 PC용인지, 32비트인지 64비트인지에 따라 부팅 가능 여부가 달라질 수 있습니다.
다운로드할 때는 파일 이름에 포함된 정보를 확인합니다. 예를 들어 arm64, aarch64, Raspberry Pi 4, rpi4 같은 표기가 있으면 라즈베리파이4용 이미지인지 판단하는 데 도움이 됩니다. 반대로 amd64, x86_64, desktop PC 같은 표기가 있는 이미지는 일반적으로 라즈베리파이4에서 사용할 수 없습니다.
이미지 파일은 다음과 같은 형식으로 제공될 수 있습니다.
.img
압축되지 않은 디스크 이미지입니다. 이미지 기록 프로그램에서 바로 선택할 수 있습니다.
.img.xz 또는 .img.gz
압축된 이미지입니다. Raspberry Pi Imager나 Balena Etcher는 많은 압축 이미지 형식을 바로 기록할 수 있습니다. 프로그램이 해당 형식을 인식하지 못하면 압축을 해제한 뒤 .img 파일을 선택합니다.
.zip
압축 파일입니다. 내부에 .img 파일이 포함되어 있는지 확인합니다. 압축을 해제한 뒤 이미지 파일을 기록하는 방식이 안전합니다.
배포처에서 SHA256 같은 체크섬 값을 제공한다면 다운로드 파일이 손상되지 않았는지 확인할 수 있습니다. 특히 파일 용량이 크거나 인터넷 연결이 불안정했다면 체크섬 검증이 도움이 됩니다.
Windows PowerShell에서는 다음 명령으로 SHA256 값을 확인할 수 있습니다.
Get-FileHash "C:\다운로드\openclaw-image.img.xz" -Algorithm SHA256
macOS 또는 Linux 터미널에서는 다음과 같이 확인할 수 있습니다.
shasum -a 256 ~/Downloads/openclaw-image.img.xz
명령 결과가 공식 배포처의 SHA256 값과 다르면 파일을 다시 내려받는 것이 좋습니다.
━━━━━━━━━━━━━━━━
1단계: microSD 카드 연결과 데이터 백업
목표는 설치 대상 microSD 카드를 정확히 선택하는 것입니다.
microSD 카드를 카드 리더기에 넣고 작업용 PC에 연결합니다. 이 과정에서 가장 중요한 점은 카드 안의 기존 데이터가 모두 삭제된다는 사실입니다. 사진, 문서, 기존 라즈베리파이 설정 파일이 있다면 먼저 다른 저장장치에 백업합니다.
여러 개의 USB 저장장치가 연결되어 있다면 불필요한 장치를 잠시 분리하는 것이 좋습니다. 이미지 기록 프로그램에서 드라이브를 잘못 선택하면 다른 디스크의 데이터가 지워질 수 있습니다.
✅ 완료 확인
파일 탐색기 또는 디스크 관리 도구에서 microSD 카드가 정상적으로 인식되는지 확인합니다. 카드 용량이 예상과 다르거나 인식이 반복적으로 끊긴다면 카드 리더기 또는 microSD 카드 상태를 먼저 점검합니다.
━━━━━━━━━━━━━━━━
2단계: Raspberry Pi Imager로 오픈클로 이미지 기록하기
목표는 오픈클로 이미지를 microSD 카드에 기록하는 것입니다.
Raspberry Pi Imager를 실행한 뒤 운영체제 선택 메뉴를 엽니다. 목록에 오픈클로 이미지가 기본으로 표시되지 않는다면 “사용자 지정 이미지 선택” 또는 이와 유사한 항목을 선택합니다. 이어서 내려받은 오픈클로 이미지 파일을 지정합니다.
다음으로 저장장치 선택 메뉴에서 microSD 카드를 선택합니다. 카드 이름과 용량을 다시 한 번 확인한 뒤 기록을 시작합니다.
일부 버전의 Raspberry Pi Imager는 설정 메뉴에서 호스트 이름, SSH 활성화, 사용자 계정, Wi-Fi 정보 등을 미리 지정할 수 있습니다. 다만 오픈클로 전용 이미지가 이 설정을 모두 반영하는지는 이미지 제작 방식에 따라 다릅니다. 배포 문서에서 지원 여부가 확인되지 않았다면, 설정을 적용했다고 가정하지 말고 첫 부팅 후 화면 또는 네트워크에서 실제 상태를 확인해야 합니다.
기록이 완료된 뒤 검증 기능이 실행되면 끝날 때까지 기다립니다. 검증은 기록된 데이터가 원본 이미지와 일치하는지 점검하는 과정이므로 가능하면 건너뛰지 않는 편이 좋습니다.
✅ 완료 확인
프로그램에 기록 완료 또는 검증 완료 메시지가 표시되면 microSD 카드를 안전하게 제거합니다. 기록 중 오류가 났거나 검증에 실패했다면 같은 카드에 반복 설치하기보다 이미지 파일, 카드 리더기, microSD 카드 상태를 각각 확인합니다.
━━━━━━━━━━━━━━━━
3단계: Balena Etcher로 이미지 기록하기
목표는 다른 이미지 기록 도구를 사용해 동일하게 microSD 카드에 이미지를 설치하는 것입니다.
Balena Etcher를 실행한 뒤 “Flash from file” 메뉴에서 오픈클로 이미지 파일을 선택합니다. 이어서 “Select target”에서 microSD 카드를 고르고, 선택한 대상이 맞는지 다시 확인합니다.
마지막으로 “Flash”를 실행하면 이미지 기록과 검증 과정이 진행됩니다. 관리자 권한 요청 창이 나타날 수 있으며, 운영체제의 안내에 따라 권한을 허용해야 기록이 시작됩니다.
압축된 이미지 파일을 선택할 수 있는 환경도 있지만, 파일 인식 오류가 발생한다면 압축을 해제한 .img 파일을 사용합니다. 이미지 기록이 끝난 뒤에는 운영체제가 새로 생성된 리눅스 파티션을 읽지 못한다는 메시지를 표시할 수 있습니다. 이는 Windows나 macOS에서 리눅스 파일 시스템을 바로 읽지 못해서 나타나는 경우가 있으므로, 곧바로 카드가 손상됐다고 판단할 필요는 없습니다.
✅ 완료 확인
Etcher에서 플래시 완료 메시지가 표시되고 검증 오류가 없다면 다음 단계로 진행할 수 있습니다.
━━━━━━━━━━━━━━━━
4단계: 라즈베리파이4에 연결하기
목표는 첫 부팅에 필요한 기본 장치를 연결하는 것입니다.
전원이 연결되지 않은 상태에서 microSD 카드를 라즈베리파이4의 카드 슬롯에 끝까지 삽입합니다. 처음 부팅할 때는 HDMI 모니터와 키보드를 연결해 두면 오류 원인을 확인하기 쉽습니다.
가능하다면 유선 LAN 케이블도 함께 연결합니다. Wi-Fi가 초기 설정되어 있지 않거나 접속 정보가 잘못된 경우에도 유선 네트워크가 있으면 IP 주소 확인과 원격 접속이 훨씬 간단해집니다.
연결 순서는 다음처럼 정리할 수 있습니다.
1. microSD 카드 삽입
2. HDMI 모니터 연결
3. 키보드 연결
4. 유선 LAN 연결
5. 마지막에 USB-C 전원 연결
전원을 연결하면 라즈베리파이4가 자동으로 켜집니다. 별도의 전원 버튼이 없는 구성에서는 전원 케이블 연결 자체가 부팅 시작 동작입니다.
━━━━━━━━━━━━━━━━
5단계: 첫 부팅 화면에서 확인할 내용
목표는 오픈클로 이미지가 실제로 부팅을 시작했는지 확인하는 것입니다.
정상적인 경우 HDMI 화면에 부팅 메시지, 로고, 콘솔 로그인 화면, 초기 설정 화면 또는 웹 서비스 안내 문구가 나타날 수 있습니다. 표시되는 화면은 오픈클로 이미지의 구성에 따라 다릅니다.
처음 부팅은 파일 시스템 확장, 초기 설정, 서비스 준비 등으로 평소보다 오래 걸릴 수 있습니다. 저장장치 성능과 이미지 구성에 따라 차이가 있으므로, 전원을 연결한 직후 화면이 바로 바뀌지 않는다고 곧바로 전원을 뽑지 않는 것이 좋습니다.
로그인 화면이 나타났다면 배포처에서 제공한 초기 계정 정보를 사용합니다. 임의의 기본 계정이나 비밀번호를 추측해 입력하는 방식은 피하는 것이 좋습니다. 오픈클로 이미지에 따라 초기 비밀번호 변경, 관리자 계정 생성, 라이선스 동의, 네트워크 설정 등의 절차가 나타날 수 있습니다.
✅ 완료 확인
다음 중 하나가 확인되면 기본 부팅은 정상으로 볼 수 있습니다.
- 오픈클로의 초기 설정 화면 또는 로그인 화면이 표시됨
- 콘솔에서 로그인 프롬프트가 표시됨
- 배포 문서에 안내된 서비스 시작 메시지가 표시됨
- 웹 관리 화면 접속에 필요한 주소 또는 IP 정보가 표시됨
━━━━━━━━━━━━━━━━
6단계: 네트워크에서 라즈베리파이 IP 주소 찾기
목표는 화면 없이도 라즈베리파이4 오픈클로에 접속할 수 있도록 IP 주소를 확인하는 것입니다.
유선 LAN이 연결된 상태라면 공유기 관리 페이지에서 접속 기기 목록을 확인하는 방법이 가장 확실합니다. 목록에서 Raspberry Pi, openclaw, linux, 알 수 없는 기기 이름 또는 새로 연결된 장치를 찾습니다. 기기 이름은 이미지 설정에 따라 다르게 표시될 수 있습니다.
공유기 관리 페이지에 접속하기 어렵다면 같은 네트워크에 연결된 PC에서 네트워크 검색 도구를 사용할 수 있습니다. 다만 네트워크 스캔 기능은 회사, 학교, 공용망처럼 관리 권한이 없는 환경에서 사용하면 안 됩니다. 본인이 관리하는 가정용 또는 테스트용 네트워크에서만 확인합니다.
HDMI 화면이 연결되어 있고 콘솔 로그인이 가능하다면 다음 명령으로 IP 주소를 확인할 수 있습니다.
hostname -I
여러 주소가 표시될 수 있는데, 일반적으로 가정용 공유기 환경에서는 192.168.x.x 또는 10.x.x.x 형태의 사설 IP 주소를 사용합니다.
보다 자세한 네트워크 상태는 다음 명령으로 확인할 수 있습니다.
ip addr
유선 연결 인터페이스는 환경에 따라 eth0, 무선 연결 인터페이스는 wlan0 등으로 표시될 수 있습니다.
✅ 완료 확인
라즈베리파이4에 할당된 IP 주소를 확인했고, 같은 네트워크의 PC나 스마트폰에서 해당 주소에 접근할 수 있다면 네트워크 연결까지 정상입니다.
━━━━━━━━━━━━━━━━
7단계: SSH 또는 웹 화면으로 부팅 상태 확인하기
목표는 오픈클로 서비스가 실행 중인지 확인하는 것입니다.
오픈클로 이미지가 SSH 접속을 지원하고, SSH가 활성화되어 있다면 PC 터미널에서 다음 형식으로 접속할 수 있습니다.
ssh 사용자이름@라즈베리파이_IP주소
예를 들어 IP 주소가 192.168.0.50이라면 명령 형식은 다음과 같습니다.
ssh 사용자이름@192.168.0.50
여기서 사용자이름은 오픈클로 배포 문서에 명시된 계정을 사용해야 합니다. 최초 접속 시 연결 대상의 지문을 확인하는 메시지가 나타날 수 있으며, 본인이 확인한 라즈베리파이 IP가 맞을 때만 진행합니다.
오픈클로가 웹 관리 화면을 제공하는 이미지라면 웹 브라우저 주소창에 다음 형식으로 접속합니다.
http://라즈베리파이_IP주소
이미지에 따라 포트 번호가 필요할 수 있습니다. 예를 들어 배포 문서가 특정 포트를 안내한다면 다음 형식으로 입력합니다.
http://라즈베리파이_IP주소:포트번호
임의의 포트 번호를 추측하기보다는 오픈클로 이미지의 공식 설치 문서, 첫 부팅 화면, 서비스 로그에 표시된 주소를 기준으로 접속합니다.
✅ 완료 확인
다음 중 하나가 가능하면 오픈클로 이미지의 부팅과 기본 서비스 실행을 확인할 수 있습니다.
- SSH 로그인 후 명령 입력이 가능함
- 웹 관리 화면 또는 초기 설정 페이지가 열림
- 오픈클로 서비스 상태 화면이 표시됨
- 초기 관리자 계정 생성 또는 비밀번호 변경 절차가 진행됨
━━━━━━━━━━━━━━━━
8단계: 서비스 상태와 저장공간 확인하기
목표는 단순 부팅을 넘어 운영 가능한 상태인지 점검하는 것입니다.
SSH 또는 콘솔에 접속했다면 시스템이 계속 실행 중인지 확인할 수 있습니다. 리눅스 기반 이미지에서 기본적인 시스템 정보를 보려면 다음 명령을 사용할 수 있습니다.
uname -a
저장공간 사용량은 다음 명령으로 확인합니다.
df -h
메모리 상태는 다음 명령으로 확인할 수 있습니다.
free -h
오픈클로가 systemd 서비스로 설치된 구성이라면 배포 문서에 제공된 서비스 이름으로 상태를 확인할 수 있습니다. 서비스 이름은 이미지마다 다르므로, 아래 명령의 openclaw 부분은 실제 서비스 이름으로 바꿔야 합니다.
sudo systemctl status openclaw
실행 중인 서비스 목록에서 관련 항목을 찾고 싶다면 다음 명령을 사용할 수 있습니다.
systemctl --type=service --state=running
웹 화면이 열리지 않는데 시스템 자체는 정상 부팅됐다면, 오픈클로 서비스가 아직 시작 중이거나 서비스 설정에 문제가 있을 수 있습니다. 이때는 이미지 배포 문서에 있는 로그 확인 방법과 서비스 이름을 기준으로 점검하는 것이 안전합니다.
━━━━━━━━━━━━━━━━
⚠ 자주 발생하는 오류와 해결 방법
전원을 연결해도 화면이 전혀 나오지 않는 경우
가장 먼저 전원 어댑터와 USB-C 케이블을 확인합니다. 라즈베리파이4는 전원 공급이 부족하면 정상 부팅하지 못할 수 있습니다. 다음으로 HDMI 케이블, 모니터 입력 채널, microSD 카드 삽입 상태를 점검합니다.
가능하면 다른 microSD 카드에 이미지를 다시 기록해 보는 방법도 좋습니다. 카드 손상이나 기록 불량은 첫 부팅 실패의 흔한 원인입니다.
무지개 화면, 경고 아이콘, 반복 재부팅이 나타나는 경우
전원 부족 가능성을 우선 확인합니다. 고성능 USB 장치, 외장 저장장치, 냉각 팬 등을 함께 연결했다면 전력 요구량이 늘어날 수 있습니다. 우선 불필요한 USB 장치를 분리하고 안정적인 전원 환경에서 다시 시도합니다.
오픈클로 이미지가 라즈베리파이4와 호환되는지, 특히 ARM 계열과 64비트 지원 여부도 다시 확인해야 합니다.
부팅 화면은 나오지만 로그인할 수 없는 경우
초기 계정과 비밀번호는 이미지 배포처마다 다릅니다. 일반적인 라즈베리파이 OS의 계정 정보를 오픈클로 이미지에 그대로 적용하면 로그인에 실패할 수 있습니다. 공식 설치 문서의 초기 계정, 최초 비밀번호 설정 방식, SSH 활성화 조건을 확인합니다.
여러 번 잘못된 비밀번호를 입력하기보다 이미지 문서를 다시 확인하고, 초기화 방법이 제공되어 있다면 그 절차를 따르는 편이 안전합니다.
공유기에서 IP 주소가 보이지 않는 경우
유선 LAN 케이블이 정상적으로 연결됐는지, 공유기 포트 LED가 켜지는지 확인합니다. Wi-Fi만 사용 중이라면 이미지에 무선 네트워크 정보가 사전 설정되어 있지 않을 수 있습니다.
처음 설치할 때는 HDMI 화면에서 네트워크 설정 상태를 직접 확인하거나 유선 연결로 전환하는 방법이 가장 빠릅니다.
웹 관리 화면이 열리지 않는 경우
라즈베리파이4가 부팅됐더라도 웹 서비스가 즉시 준비되지 않을 수 있습니다. 먼저 IP 주소가 맞는지 확인하고, 브라우저 주소에 http와 포트 번호를 정확히 입력했는지 점검합니다.
그다음 SSH나 콘솔에서 서비스 상태와 로그를 확인합니다. 오픈클로 이미지가 제공하는 공식 문서에 서비스 이름, 기본 포트, 최초 실행 시간, 설정 파일 위치가 안내되어 있다면 그 정보를 우선합니다.
이미지 기록 중 검증 오류가 발생하는 경우
다운로드 파일이 손상됐거나 microSD 카드 또는 카드 리더기에 문제가 있을 수 있습니다. 이미지 파일의 체크섬을 확인하고, 다른 카드 리더기나 다른 microSD 카드로 다시 기록해 봅니다.
같은 오류가 반복되면 저장장치 자체의 수명 문제일 수 있으므로, 중요한 운영 환경에서는 새 저장장치로 교체하는 것이 좋습니다.
━━━━━━━━━━━━━━━━
설치 후 바로 해야 할 보안과 관리 설정
오픈클로 이미지가 정상 부팅됐다면 초기 계정과 비밀번호를 그대로 유지하지 않는 것이 중요합니다. 배포 문서에 기본 계정이 안내되어 있다면 첫 로그인 후 강력한 비밀번호로 변경하고, 관리자 화면 접근 권한도 점검합니다.
인터넷에 직접 공개할 계획이라면 기본 포트 포워딩을 바로 설정하기보다 인증 방식, HTTPS 적용 가능 여부, 방화벽 규칙, 관리자 계정 보호 방법을 먼저 확인해야 합니다. 테스트 목적이라면 외부 공개 없이 내부 네트워크에서 기능을 검증하는 편이 안전합니다.
설정이 끝난 시점에는 microSD 카드 또는 외부 저장장치의 백업도 만들어 두는 것이 좋습니다. 이미지 전체 백업을 만들면 카드 장애나 잘못된 설정 변경이 발생했을 때 비교적 빠르게 복구할 수 있습니다. 다만 비밀번호, API 키, 개인 데이터가 포함될 수 있으므로 백업 파일은 암호화된 저장장치에 보관합니다.
라즈베리파이4 오픈클로 설치의 핵심은 이미지 기록보다 첫 부팅 확인 과정에 있습니다. 공식 배포처의 라즈베리파이4 지원 이미지인지 확인하고, 안정적인 전원과 정상적인 microSD 카드를 사용한 뒤, 화면·IP 주소·웹 또는 SSH 접속 순서로 점검하면 문제 위치를 비교적 쉽게 찾을 수 있습니다.
