비디오 튜토리얼 (선택 사항)

Raspberry Pi에 OpenClaw를 설치하고, SD 카드를 플래싱(flashing)하며, 게이트웨이를 실행하는 과정을 단계별로 보고 싶다면 먼저 시청하세요.

프로젝트 개요

Raspberry Pi + OpenClaw: 이 가이드에서는 셀프 호스팅(self-hosted) AI 어시스턴트 게이트웨이인 OpenClaw를 Raspberry Pi에 설치하여, WhatsApp 또는 Telegram을 통해 AI 에이전트와 메시지를 주고받을 수 있도록 설정합니다.

Raspberry Pi Imager를 사용하여 SD 카드를 플래싱하고, 첫 부팅 전 SSH 및 Wi-Fi를 구성한 다음, Node.js와 OpenClaw를 설치하고 게이트웨이를 systemd 서비스로 설정하여 자동으로 실행되도록 할 것입니다.

• 소요 시간: 30~45분
• 기술 수준: 초급에서 중급
• 구축 결과물: WhatsApp 또는 Telegram과 연결할 준비가 된, 24시간 상시 가동되는 OpenClaw 기반의 Raspberry Pi

준비물 목록

외부 장치

• Raspberry Pi 4 또는 5 (4GB RAM 권장; 더 무거운 작업을 위해 8GB 권장)
• MicroSD 카드 (32GB 이상, Class 10 이상)
• Pi용 전원 공급 장치
• 이더넷(Ethernet) 케이블 또는 Wi-Fi 연결
• SD 카드 리더기가 있는 컴퓨터 (플래싱 용도)
• Raspberry Pi Imager - 무료 공식 이미징 도구
• Node.js 24 (이 가이드에서는 nvm을 통해 설치)
• OpenAI, Anthropic 또는 기타 지원되는 제공업체의 API 키
• WhatsApp 또는 Telegram 계정 (연동용)

참고: OpenClaw는 오픈 소스이며 셀프 호스팅 방식입니다. 데이터는 귀하의 Pi에 머뭅니다. 귀하는 사용량에 따라 AI 모델 API(예: OpenAI) 비용만 지불하면 됩니다.

단계별 가이드

1단계 - Raspberry Pi Imager 다운로드 및 설치

목표: SD 카드에 Raspberry Pi OS를 플래싱하는 공식 도구를 확보합니다.

수행 작업: raspberrypi.com/software에 접속하여 사용 중인 컴퓨터(Windows, macOS 또는 Linux)용 Raspberry Pi Imager를 다운로드합니다. 설치 후 애플리케이션을 실행합니다.

예상 결과: Raspberry Pi Imager가 실행되어 SD 카드에 이미지를 쓸 준비가 되었습니다.

2단계 - OS 선택 및 플래싱 전 구성

목표: Raspberry Pi OS를 선택하고 SSH, Wi-Fi, 로케일 (locale)을 사전 설정하여, 첫 부팅 후 헤드리스 (headless)로 연결할 수 있도록 합니다.

수행 작업:

1. Choose OS를 클릭하고 권장 데스크톱 이미지인 **Raspberry Pi OS (64-bit)**를 선택하거나, 최소 설치(데스크톱 없음)를 선호하는 경우 Raspberry Pi OS Lite를 선택합니다.
2. Choose Storage를 클릭하고 microSD 카드를 선택합니다.
3. 톱니바퀴 아이콘을 클릭하거나 (또는 Ctrl+Shift+X를 누름) 하여 Advanced Options를 엽니다.
4. Set hostname을 활성화하고, 예를 들어 openclaw-pi라고 설정합니다.
5. Enable SSH를 활성화하고 Use password authentication을 선택합니다. 사용자 이름(예: pi)과 비밀번호를 설정합니다.
6. Wi-Fi를 사용하는 경우: Configure WiFi를 활성화하고, SSID와 비밀번호를 입력한 뒤 국가를 선택합니다.
7. 필요한 경우 Set locale settings (시간대, 키보드 레이아웃)를 활성화합니다.
8. Save를 클릭한 다음, Yes를 클릭하여 옵션을 적용합니다.

예상 결과: Next를 클릭하고 확인하면, Imager가 이미지를 쓰고 설정값을 적용합니다. 완료되면 SD 카드를 추출합니다.

3단계 - 첫 부팅 및 Pi로 SSH 접속

목표: 네트워크를 통해 Pi에 연결합니다.

수행 작업: SD 카드를 Pi에 삽입하고, 전원과 이더넷(Ethernet)을 연결합니다 (또는 설정된 경우 Wi-Fi를 사용합니다). 첫 부팅을 위해 1~2분 정도 기다린 후, 컴퓨터에서 SSH로 접속합니다:

ssh pi@openclaw-pi.local

만약 .local 주소가 해석되지 않는다면 Pi의 IP 주소를 사용하세요:

ssh pi@192.168.1.100

2단계에서 설정한 비밀번호를 입력합니다.

예상 결과: Pi의 터미널 프롬프트가 나타납니다.

4단계 - nvm 및 Node.js 설치

목표: nvm (Node Version Manager)을 통해 Node.js 24를 설치하여 OpenClaw가 올바른 런타임 (runtime)을 갖도록 합니다.

수행 작업: Pi에서 다음 명령어들을 실행합니다:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc   # 또는 터미널 재시작
nvm install 24
...

예상 결과: node -v 명령어가 Node 24를 보고합니다. 이제 OpenClaw를 설치할 준비가 되었습니다.

5단계 - OpenClaw 전역 설치

목표 (Goal): openclaw 명령어를 실행할 수 있도록 OpenClaw CLI를 설치합니다.

수행 작업 (What to do):

npm install -g openclaw@latest

설치 확인:

openclaw --version

예상 결과 (Expected result): OpenClaw가 설치되었습니다 (예: 버전 2026.3.x 또는 그 이상).

6단계 - 온보딩 마법사 실행 및 서비스 설치

목표 (Goal): OpenClaw를 구성하고, 게이트웨이를 설정하며, 자동으로 실행될 수 있도록 systemd 사용자 서비스 (user service)로 설치합니다.

수행 작업 (What to do): 대화형 온보딩을 실행합니다:

openclaw onboard --install-daemon

마법사가 다음을 수행합니다:

• AI 제공업체 (OpenAI, Anthropic, Ollama 등) 선택 요청
• API 키 입력 요청
• 채널 (WhatsApp, Telegram) 연결 옵션 제공
• 부팅 시 게이트웨이가 시작되도록 systemd 사용자 서비스 (user service) 설치

WhatsApp 또는 Telegram의 경우, QR 코드를 스캔해야 합니다. 휴대폰이나 브라우저를 사용하여 페어링을 완료하세요.

예상 결과 (Expected result): 게이트웨이 서비스가 실행 중입니다. 다음 명령어로 확인할 수 있습니다:

systemctl --user status openclaw-gateway

active (running) 상태가 표시되어야 합니다.

7단계 - 게이트웨이 및 채팅 확인

목표 (Goal): OpenClaw에 접속이 가능하고 응답하는지 확인합니다.

수행 작업 (What to do): (페어링한 것에 따라) WhatsApp 또는 Telegram을 열고 OpenClaw 봇에게 메시지를 보냅니다. AI로부터 응답을 받아야 합니다.

또한 Pi에서 로컬로 웹 대시보드 (web dashboard)를 열거나 (데스크톱이 있는 경우), SSH 포트 포워딩 (SSH port forwarding)을 통해 열 수 있습니다:

openclaw dashboard

또는 Mac에서 포트를 포워딩합니다:

ssh -L 18789:127.0.0.1:18789 pi@openclaw-pi.local

그 다음 브라우저에서 http://127.0.0.1:18789를 방문하세요.

예상 결과 (Expected result): 휴대폰이나 대시보드를 통해 AI 어시스턴트와 채팅할 수 있습니다.

8단계 - 선택 사항: 원격 접속 활성화

목표 (Goal): 홈 네트워크 외부에서 OpenClaw에 접속합니다 (예: Tailscale 또는 SSH 터널을 통해).

수행 작업 (What to do): 게이트웨이는 기본적으로 127.0.0.1에서 대기하므로 인터넷에 노출되지 않습니다. 원격 접속을 위해서는:

• Tailscale: Pi와 휴대폰에 Tailscale을 설치하세요. 그러면 Pi가 tailnet IP를 할당받습니다. openclaw configure를 사용하여 Tailscale 모드를 활성화할 수 있습니다.
• SSH 터널 (SSH tunnel): 노트북에서 ssh -L 18789:127.0.0.1:18789 pi@openclaw-pi.local을 실행하고 localhost:18789에서 대시보드를 사용하세요.

자세한 내용은 OpenClaw Tailscale 문서를 참조하세요.

예상 결과 (Expected result): tailnet의 어디에서나 또는 보안 터널을 통해 OpenClaw에 접속할 수 있습니다.

Step 9 - 유용한 관리 명령 (Useful management commands)

목표 (Goal): 설정 후 OpenClaw 게이트웨이를 시작, 중지 및 검증합니다.

작업 (What to do): 필요에 따라 Pi에서 다음 명령어를 실행하세요:

systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway
systemctl --user restart openclaw-gateway
...

예상 결과 (Expected result): 게이트웨이 서비스를 제어하고 기본적인 진단 (diagnostics)을 수행할 수 있습니다.

결론 (Conclusion)

이제 Raspberry Pi에서 OpenClaw를 실행하여 WhatsApp이나 Telegram에서 메시지를 보낼 수 있는 셀프 호스팅 AI 어시스턴트 게이트웨이를 갖추게 되었습니다. 게이트웨이는 24시간 내내 작동하며 귀하의 하드웨어에 상주합니다.

다음 Raspberry Pi 빌드에 사용된 정확한 부품을 원하시나요? ShillehTek.com에서 필요한 것을 가져가세요. 이 설정을 맞춤화하거나 제품을 위한 프로덕션급 자동화 구축에 도움이 필요하다면, 저희의 IoT 컨설팅 서비스를 확인해 보세요.