[Raspberry Pi OpenClaw 설치 가이드] Part 3 : OpenClaw 초기 설정

이전 글에서 라즈베리파이에서 OpenClaw 설치를 알아봤다.

이 글에서는 OpenClaw 설치 이후 5단계 초기 설정에 대해 알아본다.

보안 경고 수락

OpenClaw 설치 후 아래와 같이 보안 경고 화면이 표시된다.

내용을 읽고 “Yes”를 선택한다.

Onboarding mode에서 “QuickStart”를 선택하면 가장 쉽게 설정을 할 수 있다.

AI Model provider 선택

본인이 사용하려는 AI Model provider를 선택한다.

각자 사용하고자 하는 AI Model provider를 선택한다. 필자는 현 시점에 chatGPT를 유료로 사용하고 있어서 OpenAI를 선택한다.

인증 방식을 선택한다. OpenAI API key로 인증을 하려면, https://platform.openai.com/ 에 접속해서 “API keys” 에서 키를 생성하여 사용하면 된다.

여기서는 OpenAI Codex (ChatGPT OAuth)를 선택했다.

주소를 복사하여 브라우저로 접속 후 로그인을 하면 찾을 수 없는 사이트로 redirect된다.

그 주소를 복사하여 붙여넣기한다.

Default model을 선택한다.

Channel 선택

보통 게이트웨이라 불리는 OpenClaw와 통신할 창구인 Channel을 선택한다.

여기서는 추천하고 있는 Telegram을 선택한다.

Telegram bot token을 얻기 위해 출력된 가이드 대로 수행한다.

  1. 폰에서 Telegram 앱을 열고 @BotFather를 찾아 채팅을 한다.
  2. /newboot 이라고 입력한다.
  3. 사용할 bot 이름을 정하고, 출력된 token 값을 copy한다.

“Enter Telegram bot token”을 선택하고 copy해둔 token 값을 입력한다.

Web Search provider 선택

웹검색 provider를 선택한다.

나중에 변경 가능하니 여기서는 Gemini (Google Search)를 선택한다.

Gemini API key가 필요하다.

Gemini API key를 생성하기 위해 우선 https://aistudio.google.com/에 접속한 후 로그인한다.

왼쪽 하단에서 Get API key를 선택한다.

Create API key를 선택하여 키를 하나 생성한다.

Create key를 클릭하여 생성한 후 key값을 copy하여 OpenClaw 설정에 key값을 입력한다.

Skill 설정

skill 설정을 한다.

Yes를 선택한다.

이메일 전송, 파일 편집 등의 기능을 원하면 skill을 설치한다. 여기서는 Skip for now를 선택하여 넘어간다.

goplaces는 Google Places API를 사용하는 skill로 장소 검색, 지도, 위치 기반 기능을 OpenClaw에 추가한다.

여기서는 No를 선택하여 넘어간다.

여기서는 ChatGPT(OpenAI)를 model provider로 설정했으므로 No를 선택한다.

Notion을 사용하여 연동하려면 Yes를 선택한다. 여기서는 No를 선택한다.

openai-image-gen은 DALL-E를 이용하여 OpenClaw에서 AI 이미지를 생성할 수 있게 해주는 skill이다.

여기서는 No를 선택한다.

openai-whisper-api는 OpenAI의 Whisper 음성 인식 모델을 사용하는 skill이다. 여기서는 No를 선택한다.

지금까지 skill 설치 흐름이다.

스킬기능권장
goplaces장소 검색No
nano-banana-proGemini AINo
notionNotion 연동No
openai-image-gen이미지 생성No
openai-whisper-api음성인식No
sag음성 합성No

Hooks 설정

라즈베리파이 개인 사용 기준으로 session-memory 하나만 선택한다. 이유는 다음과 같다.

  • 새 세션을 시작해도 이전 대화 맥락을 기억
  • 가장 실용적인 Hook
  • 적은 리소스 부담

나머지 것들이 설정되고, TUI 관련 설정이 나온다.

Agent를 처음 시작하는 “부화(Hatch)” 단계이다. Agent의 성격, 역할, 행동 방식을 처음으로 설정하는 중요한 단계다.

3가지 옵션 설명

옵션설명추천
Hatch in TUI터미널에서 바로 설정✅ 라즈베리파이 최적
Open the Web UI브라우저 대시보드에서 설정마우스 편한 경우
Do this later나중에 설정일단 건너뛰기

라즈베리파이 SSH 환경이므로 TUI가 가장 적합하다. TUI를 선택한다.

Agent가 깨어났다.

이 화면은 Agent의 정체성과 나와의 관계를 처음 설정하는 순간이다.

입력하는 내용이 Agent의 기본 성격이 된다.

아래는 입력 예시이니 참고해서 입력하면 된다.

You're Kestrel, a machine familiar, sharp and calm, emoji 🛠️.

Call me Juno. Asia/Seoul timezone. ✅

What I want from you:
- Respond in Korean by default
- Keep answers concise and practical
- Help with coding (Python), automation, and stock data analysis
- Notify me via Telegram when tasks are done

What I don't want:
- Overly cheerful or verbose responses
- Asking unnecessary clarifying questions
- Don't be sycophantic

각 항목을 간단히 설명하면:

항목의미
이름 (Kestrel 등)Agent 호출 이름 — 나중에 /name 으로 변경 가능
내 이름Agent가 나를 부르는 방식
Timezone스케줄, 알림 시간 기준
Want/Don’t wantAgent 행동 방식의 핵심 가이드라인

아래와 같이 응답이 오면 이제 라즈베리파이 AI Agent가 완전히 준비된 상태이다.

이제 Telegram에서 생성한 채널로 채팅하면서 바로 일 시키면 된다.

참고 사이트

답글 남기기