이 글에는 쿠팡 파트너스 링크가 있으며, 구매 시 일정액의 수수료를 받습니다.
OpenClaw 비용 줄이기, 제미나이 예산 알림과 포트 변경 첫 설정
OpenClaw 비용 줄이기와 기본 보안 설정을, 새 Mac mini에 처음 설치하는 과정 안에서 158단계로 정리했습니다. Google Cloud 월 예산 알림, 싼 Gemini 모델로 바꾸기, Brave 검색 월 한도, heartbeat 끄기로 새는 돈을 막고, 게이트웨이 포트 변경과 ClawHub 스킬 고르는 기준으로 위험을 줄이는 순서입니다. 영상이 화면으로만 보여 준 설치 명령과 Homebrew 명령은 일반적인 방법으로 채웠습니다.

OpenClaw 첫 설정에서 짚어야 할 보안 경고
Automate Your Life Tutorials 채널의 41분짜리 입문 영상이 바탕입니다. 화자는 자기가 저지른 실수와, 거기서 빠져나오는 법을 할 수 있는 만큼 보여 주겠다고 말합니다. 실제로 공식 설치 명령이 새 Mac에서 "homebrew not found"로 막히고, 비싼 모델을 골랐다가 바꾸고, 포트를 바꿨는데 옛 포트로 계속 접속되는 장면이 나옵니다. 그 실수 기록이 이 글의 뼈대입니다.
OpenClaw(오픈클로)는 내 컴퓨터에서 돌면서 파일과 계정에 손을 대는 AI 에이전트 프로그램입니다. 설치 중간중간 나오는 보안 이야기 중 주요한 것을 앞으로 모았습니다.
- 무료 등급 데이터 학습: Google AI Studio 무료 등급이면 "Google이 우리 데이터를 학습에 쓴다"고 화자는 말합니다. 화자는 이게 싫어서 결제를 설정했습니다.
- 가짜 userinfobot: Telegram에 이름이 비슷한 가짜 봇이 있고 "정보를 훔치려는 사람들"이 있다는 경고입니다.
@userinfobot을 정확히 입력해야 합니다. - "강력하고 본질적으로 위험하다"는 확인 문구: 온보딩(처음 실행할 때 설정을 묻는 대화형 과정) 첫 질문에서 OpenClaw 스스로 위험을 경고합니다.
- command logger 켜기: "뭔가 잘못되면 이 봇이 무엇을 했는지 보려고" 켰다고 합니다.
- 공개된 기본 포트 바꾸기: 기본 게이트웨이(OpenClaw가 메신저와 웹 화면을 연결하는 중계 프로그램) 포트는 "공개적으로 알려진 포트"라서 공격 경로가 될 수 있습니다. 화자는 모두가 같은 번호를 쓰지 않도록 자기 포트 번호를 일부러 알려 주지 않습니다.
- 게이트웨이 토큰 보관: 포트를 바꾸기 전에 토큰을 복사해 안전한 곳에 둡니다. 새 포트에 접속할 때 필요합니다.
- ClawHub 의심 스킬: 검색 결과를 바로 설치하면 "정말 위험해질 수 있다"고 합니다. "suspicious" 표시가 없는 것만 고르고 코드와 설명을 읽으라는 권고입니다.
API 키는 화면에 노출하지 않습니다. 화자도 API 키를 카메라에 보여 주지 않겠다고 말하고, 이 글에도 키·토큰 값은 적지 않았습니다.
스폰서나 제휴 링크 언급은 없습니다. 영상 끝에 채널의 후속 튜토리얼 재생목록 안내가 있습니다.
OpenClaw 비용이 새는 곳, 화자 경험 기준
이 과정은 무료가 아닙니다. 아래 숫자는 모두 화자가 말한 것이고, 요금은 바뀔 수 있으니 각 서비스의 공식 안내를 확인해야 합니다.
- Google Cloud 월 예산 알림: 화자는 한도 $200에 50%·90%·100% 알림을 걸었습니다. "비용이 폭주해 수천 달러를 내지 않도록"이라는 이유입니다.
- 첫날 Gemini 3 계열로 10~15번 대화했고, 반나절 Gemini 2.0 Flash를 쓴 비용은 "약 1달러"였다고 합니다. 첫날 금액 자체는 말하지 않았습니다.
- 화자는 Gemini 3 Pro Preview를 고른 게 "첫 번째 실수"였다고 합니다. "금방 매우 비싸진다"는 겁니다.
- Brave Search API: 화자가 읽은 조건은 매월 $5 무료 크레딧, 1,000회 요청당 $5입니다. 화자는 월 한도를 $5로 걸었고 "아마 돈이 들지 않을 것"이라고 말합니다.
- heartbeat(봇이 스스로 주기 점검을 도는 기능)는 약 30분마다 점검을 돌려 돈이 나간다며 껐습니다.
- Google Workspace 스킬을 쓰려면 유료 Workspace 계정이 필요하다고 합니다.
Mac mini 가격은 영상에 나오지 않습니다.
정리하면 돈이 새는 곳은 네 군데입니다. 비싼 모델, 한도 없는 결제 계정, 한도 없는 검색 API, 사람이 시키지 않아도 도는 주기 점검. 아래 단계 중 2번(예산 알림), 10번(모델 교체), 11번(Brave 월 한도), 14번(heartbeat) 구획이 각각을 막는 설정입니다.
따라 하기 전에 알아 둘 것
아래 158단계는 화자가 말로 설명한 순서 그대로 옮겼습니다. 화자가 한 선택(모델, 금액, 설정)은 화자의 선택일 뿐 정답이 아닙니다.
화면에만 있고 소리 내어 읽지 않은 명령이 여럿입니다. 그 자리에는 일반적으로 쓰는 명령을 편집자 보충으로 넣었습니다. 버전에 따라 이름이 바뀔 수 있으니, 막히면 openclaw --help로 현재 명령 목록을 확인합니다.
- openclaw.ai 설치 명령(60·
75단계) - Homebrew 설치 명령과 "Next steps" 명령 3개(67~74단계)
- 모델 목록 확인, 모델 추가·변경, 온보딩 재실행 명령(100~103단계)
- 게이트웨이 재시작·정지 명령(138~139단계).
openclaw gateway install만 발화됐습니다. - ClawHub 버전 확인 명령과 스킬 검색 명령
- 완전 삭제(uninstall) 방법. 영상에서는 "명령 몇 개가 필요하다"고만 했습니다.
키·토큰·ID를 적어 둔 텍스트 파일을 Mac mini로 옮기는 방법, 새 포트 번호와 웹 인터페이스 주소 형식도 영상에 나오지 않습니다. 해당 단계에서 채웠습니다.
준비물
- Mac mini(화자는 새로 산 기기), 모니터, 키보드, 마우스
- (구형 키보드·마우스라면) USB-C → USB-A 어댑터. 화자는 필요했다고 합니다.
- Google 계정
- 신용카드 같은 결제 수단: 화자는 Google AI Studio와 Brave Search API 결제에 썼습니다.
- 휴대폰의 Telegram 앱
- (선택) iPhone: Mac 초기 설정 때 데이터 이전용
- GitHub 계정: ClawHub 로그인용
- 메모장(텍스트 파일): API 키, 봇 토큰, 내 Telegram ID를 모아 둘 곳
1. Google AI Studio에서 Gemini API 키 만들기
화자는 가장 중요한 첫 결정이 "어떤 모델을 쓸지"라고 합니다. Gemini를 고른 이유는 세 가지입니다. Google 도구에 익숙하다는 점, 좋으면서 싼 모델이 있다는 점, "지금 Claude를 OpenClaw에 쓰면 차단될 수 있다는 우려"가 없다는 점(화자 주장). 이미 익숙한 모델을 쓰라는 게 화자 권고입니다.
API 키는 프로그램이 내 계정으로 모델을 부를 때 쓰는 비밀번호 같은 문자열입니다. 쓸 때마다 요금이 붙으니 키가 새면 남이 내 돈으로 모델을 쓸 수 있습니다.
-
브라우저에서 aistudio.google.com 에 접속합니다.
위치: 자막 표기는 "a studio.google.com"이고, 문맥상 Google AI Studio 주소로 고쳤습니다.
확인: Google AI Studio 화면이 뜬다.
-
Google 계정으로 로그인합니다.
확인: AI Studio 작업 화면(interface)에 들어가 있다.
-
"Get API key"를 누릅니다.
위치: 화면 아래쪽
확인: API 키 관리 화면이 뜬다.
-
새 프로젝트를 만듭니다.
대안: 이름은 간단해도 됩니다. 프로젝트를 따로 두는 이유는 비용 추적입니다. OpenClaw 전용 프로젝트를 두면 청구서에서 이 봇이 쓴 돈만 따로 보입니다.
확인: 새 프로젝트가 목록에 생기고 "free tier(무료 등급)" 표시가 보인다.
-
키 이름을 정해 API 키를 만듭니다.
주의: 이 상태는 무료 등급입니다. 화자는 무료 등급이면 "Google이 우리 데이터를 학습에 쓴다"며 원치 않았다고 말합니다.
확인: 새 API 키가 생긴다.
-
(화자의 선택) "Set up billing"을 누릅니다.
대안: 무료 등급 그대로도 키는 만들어집니다. 화자는 개인정보 때문에 결제를 설정했습니다. 결제 여부는 각자 판단할 부분입니다. 결제를 켜면 2번 구획의 예산 알림은 꼭 겁니다.
확인: 현재 계정이 표시된 결제 설정 화면이 뜬다.
-
국가를 선택합니다.
확인: 국가 칸이 채워진다.
-
약관에 동의합니다.
확인: 결제·사용 약관 동의 표시가 된다.
-
결제 계정 정보(신용카드 등, 연락처)를 입력합니다.
확인: 카드·연락처 칸이 모두 채워진다.
-
"Finish"를 누릅니다.
확인: 결제 설정이 끝난다.
-
유료 등급으로 무엇이 바뀌었는지 읽어 봅니다.
확인: 화자가 읽은 항목이 보인다. 더 높은 사용 한도, Batch API 50% 비용 절감, 더 좋은 모델 접근, "콘텐츠가 제품 개선에 쓰이지 않음"입니다. Enterprise 등급은 Google 담당자와 상의해야 한다고 말합니다.
2. OpenClaw 비용 폭주를 막는 월 예산 알림 (Google Cloud Console)
목적은 "비용이 폭주해 수천 달러를 내지 않도록" 하는 것입니다. 예산 알림은 돈을 막아 주는 차단기가 아니라, 기준을 넘으면 메일로 알려 주는 경보입니다. 알림을 받으면 직접 봇을 멈추거나 키를 끄는 식으로 대응해야 합니다(편집자 보충).
-
Google Cloud Console로 들어갑니다.
위치: 화자는 AI Studio에 뜬 작은 전구(경고) 표시를 눌러 들어갔습니다. 표시가 안 보이면 console.cloud.google.com에 접속해 왼쪽 메뉴의 결제(Billing)에서 "예산 및 알림(Budgets & alerts)"으로 갑니다(편집자 보충).
확인: 예산(budget) 만들기 화면이 뜬다.
-
예산 이름을 적습니다.
대안: 화자는 "monthly … Cloud Google budget" 같은 이름을 썼습니다(자막 일부 불명).
확인: 이름 칸이 채워진다.
-
기간(Time range)을 "Monthly(월별)"로 둡니다.
확인: 기간이 월별로 표시된다.
-
절감 항목(saving programs, other savings)을 포함으로 둡니다.
확인: 화자가 말한 두 항목이 선택돼 있다.
-
"Next"를 누릅니다.
확인: 금액 입력 화면으로 넘어간다.
-
금액에 200을 입력합니다.
대안: 금액은 각자 정합니다. 화자는 $200입니다. 처음 써 본다면 훨씬 낮게 잡고, 사용량을 보면서 올리는 편이 안전합니다(편집자 의견).
확인: 목표 금액이 $200으로 표시된다.
-
"Next"를 누릅니다.
확인: 알림 기준(threshold) 설정 화면이 뜬다.
-
알림 기준 50%를 넣습니다.
확인: 50%(=$100)가 목록에 있다.
-
알림 기준 90%와 100%를 추가합니다.
확인: 50%·90%·100% 세 줄이 보인다.
-
적용할 프로젝트로 4단계에서 만든 프로젝트를 고릅니다.
확인: 프로젝트가 선택돼 있다.
-
알림(notification) 받을 방법을 선택합니다.
확인: 알림 항목이 선택돼 있다. 영상에서는 알림 방식의 세부가 판독되지 않았습니다. 기본값은 결제 계정 관리자 이메일로 알림을 보내는 방식입니다(편집자 보충).
-
"Finish"를 누릅니다.
확인: 예산이 설정된다.
3. API 키 복사해 두기
-
AI Studio에서 API 키를 복사합니다.
확인: 클립보드에 키가 들어 있다.
-
메모장(텍스트 파일)에 붙여 넣습니다.
주의: 키 뒤에 여분의 글자나 공백이 없게 합니다. 키는 화면이나 영상에 공개하지 않습니다.
확인: 텍스트 파일에 키 한 줄이 끝에 공백 없이 들어 있다.
4. Telegram 봇 만들기
-
휴대폰에 Telegram 앱을 설치합니다.
확인: 휴대폰에서 Telegram이 열린다.
-
(선택) 컴퓨터 웹 브라우저에서 Telegram 웹 화면을 엽니다.
대안: 휴대폰에서 바로 진행해도 됩니다. 화자는 큰 화면을 쓰려고 웹을 연결했습니다. 웹 주소는 영상에서 판독되지 않았고, 보통 web.telegram.org입니다(편집자 보충).
확인: 브라우저에 QR 코드가 뜬다.
-
(선택) 휴대폰 Telegram 앱으로 그 QR 코드를 스캔합니다.
위치: 휴대폰 Telegram의 설정 → 기기(Devices) → 데스크톱 기기 연결(Link Desktop Device)에서 스캔 화면이 열립니다(편집자 보충).
확인: 브라우저에 Telegram 대화 목록이 뜬다.
-
Telegram에서 "BotFather"를 찾아 대화를 엽니다.
확인: BotFather 대화창이 열린다.
-
"Start"를 누릅니다.
확인: BotFather가 대화를 시작한다.
-
아래 명령을 보냅니다.
/newbot
확인: 새 봇 이름을 물어 온다.
-
봇 이름을 보냅니다.
확인: 사용자명(username)을 물어 온다.
-
봇 사용자명을 보냅니다.
주의: 고유해야 합니다. 화자는 "혼자만 간직하라"고 말합니다. 영상에 형식 규칙은 나오지 않지만, Telegram 봇 사용자명은 끝이 bot으로 끝나야 합니다(편집자 보충).
확인: BotFather가 토큰(token)을 돌려준다.
-
토큰을 복사합니다.
확인: 클립보드에 토큰이 있다.
-
토큰을 메모장에 붙여 넣습니다.
주의: 뒤에 공백이 없게 합니다.
확인: 텍스트 파일에 토큰이 저장돼 있다. 여기까지가 Telegram 준비 1부입니다.
-
Telegram 검색창에 정확히 아래처럼 입력합니다.
@userinfobot
주의: 이름이 비슷한 가짜가 있습니다. 화자 경고로는 "정보를 훔치려는 사람들"이 있습니다.
확인: 검색 결과에 userinfobot이 뜬다.
-
이름이 정확히 일치하는 userinfobot을 엽니다.
확인: userinfobot 대화창이 열린다.
-
"Start"를 누릅니다.
확인: 내 정보와 ID가 표시된다.
-
ID를 메모장에 복사해 둡니다.
대안: 화자는 "나중에 필요할 수 있다"고만 말하고, 이 영상의 이후 단계에서 ID를 쓰는 장면은 없습니다. 보통은 봇에게 말을 걸 수 있는 사람을 나로만 제한하는 허용 목록(allowlist)을 만들 때 씁니다(편집자 보충).
확인: 텍스트 파일에 API 키, 봇 토큰, ID가 모두 있다.
5. Mac mini 처음 켜고 기본 설정
키·토큰·ID를 적은 텍스트 파일은 Mac mini로 옮겨야 합니다. 영상은 옮기는 방법을 말하지 않습니다. iPhone이나 다른 Mac에서 AirDrop으로 보내거나, USB 메모리에 담아 옮기면 됩니다. 이메일이나 메신저로 자기에게 보내는 방법은 기록이 서버에 남으니 피하는 편이 낫습니다. 설치가 끝나면 이 파일은 지웁니다(편집자 보충).
-
Mac mini에 키보드, 마우스, 모니터를 연결합니다.
대안: 단자가 안 맞으면 USB-C → USB-A 어댑터를 씁니다.
확인: 키보드와 마우스가 꽂혀 있다.
-
Mac mini 전원을 켭니다.
확인: 모니터에 "hello" 인사 화면이 뜬다.
-
언어를 선택합니다.
확인: 국가/지역 선택 화면으로 넘어간다.
-
국가 또는 지역을 선택합니다.
확인: "Mac으로 데이터 이전" 질문이 뜬다.
-
데이터 이전 여부를 고릅니다.
대안: iPhone이 있으면 이전하면 편하다고 합니다. 화자는 이전했고, 스캔하고 가까이 두면 된다고 말합니다. 이전하지 않으면 "아주 깨끗한 설치"가 됩니다. OpenClaw 전용기로 쓸 생각이라면 개인 데이터를 덜 옮기는 쪽이 안전합니다(편집자 의견).
확인: 다음 설정 화면으로 넘어간다.
-
Mac 계정의 폴더 이름을 정합니다.
주의: 화자는 이 폴더 이름이 "나중에 중요해진다"고 말합니다. 왜 중요한지는 말하지 않았습니다. 이 이름이 홈 폴더 경로(/Users/폴더이름)가 되고, OpenClaw 설정 폴더도 그 아래에 생깁니다. 영문 소문자로 짧게 정하면 터미널에서 다루기 편합니다(편집자 보충).
확인: 폴더 이름 칸이 채워진다.
-
계정 암호를 정합니다.
주의: 나중에 터미널에서 이 암호를 묻습니다. 잊지 않도록 합니다. 터미널에서 암호를 칠 때는 화면에 아무것도 표시되지 않는 것이 정상입니다.
확인: 암호 칸이 채워진다.
-
(선택) "Apple 계정으로 이 컴퓨터 계정 암호 재설정 허용"에 체크합니다.
위치: 계정 만들기 화면 아래쪽
확인: 체크 표시가 된다. 암호를 잊어도 Apple 계정으로 재설정할 수 있다.
-
위치 서비스 사용 여부를 고릅니다.
대안: 휴대폰 설정을 많이 가져오지만, 원치 않으면 주지 않아도 된다고 합니다.
확인: 다음 화면으로 넘어간다.
-
시간대를 선택합니다.
확인: 시간대가 표시된다.
-
분석(Analytics) 공유를 끕니다.
대안: 화자는 "아주 좋은 생각"이라며 권합니다.
확인: 분석 공유가 꺼져 있다.
-
스크린 타임 사용 여부를 고릅니다.
대안: 화자는 "아마 필요 없을 것"이라고 말합니다.
확인: 다음 화면으로 넘어간다.
-
Apple Intelligence 사용 여부를 고릅니다.
확인: 다음 화면으로 넘어간다. 화자의 선택은 나오지 않습니다.
-
FileVault 디스크 암호화를 켭니다.
대안: 화자는 "누가 Mac mini를 훔쳐 가면"에 대비해 켜는 게 좋다고 말합니다. 디스크에 API 키와 봇 토큰이 저장되니 이 설정의 의미가 큽니다.
확인: FileVault가 켜져 있다.
-
화면 모양(look and feel)을 고릅니다.
확인: 업데이트 설정 화면으로 넘어간다.
-
업데이트를 "자동 다운로드만" 하도록 고릅니다.
대안: 다운로드만 자동으로 하고 설치는 직접 하는 게 합리적이라는 게 화자 의견입니다. 자동 설치가 켜져 있으면 밤사이 재시동되며 봇이 멈출 수 있습니다.
확인: 초기 설정이 끝나고 Mac 바탕화면이 뜬다.
6. OpenClaw 공식 설치 명령 실행 (새 Mac에서는 실패함)
-
브라우저에서 openclaw.ai 에 접속합니다.
확인: 바로 설치 안내("you're good to go")가 보인다.
-
Finder 새 창을 엽니다.
위치: 화자는 "Mac 화면 왼쪽 위에서 New Finder"라고 말합니다.
확인: Finder 창이 열린다.
-
"terminal"을 검색합니다.
대안: Cmd+Space로 Spotlight 검색을 열고 terminal을 쳐도 됩니다. 터미널은 응용 프로그램 → 유틸리티 폴더에도 있습니다(편집자 보충).
확인: 검색 결과에 터미널(Terminal)이 뜬다.
-
터미널을 엽니다.
확인: 터미널 창이 열린다.
-
openclaw.ai 페이지의 설치 명령을 복사합니다(Cmd+C).
위치: openclaw.ai 첫 화면. 화자는 명령을 소리 내어 읽지 않았습니다. Mac·
Linux용 설치 명령은 보통 아래 형태이고, 페이지에 적힌 것과 다르면 페이지를 따릅니다(편집자 보충).
curl -fsSL https://openclaw.ai/install.sh | bash
확인: 클립보드에 명령이 들어 있다.
-
터미널 창에 붙여 넣습니다(Cmd+V).
확인: 터미널에 명령이 한 줄 들어간다.
-
Return(엔터) 키를 눌러 실행합니다.
주의: 새 Mac에서는 여기서 "homebrew is not found"가 뜹니다. 화자 말로는 "이제부터 문제가 시작된다"는 지점입니다.
주의: 화자가 시도했다가 실패한 방법 2가지입니다. 따라 하지 않습니다. 첫째, 명령의 bash 앞에 sudo(자막 "pseudo")를 붙여 암호를 넣고 실행했더니 실패했습니다. 둘째, openclaw.ai에서 실행 파일을 받아 직접 설치했더니 "재앙"이었고 "절대 하지 말라"고 합니다. 전제 조건이 없어서 생긴 문제였고 지우기도 어려웠다고 합니다.
확인: "homebrew … not found" 메시지가 보이면 7번 구획으로 간다.
7. 전제 조건 설치: Xcode 명령줄 도구 → Homebrew
순서 고정입니다. Xcode → Homebrew → OpenClaw 설치 재실행. 화자는 이 전제 조건들을 "메인 페이지가 잘 알려 주지 않는다"고 말합니다. Xcode 명령줄 도구는 애플이 주는 개발용 기본 도구 묶음이고, Homebrew는 맥에서 프로그램을 명령 한 줄로 설치하게 해 주는 패키지 관리자입니다.
- 터미널에 아래 명령을 입력합니다.
xcode-select --install
위치: 자막 표기는 "Xcode- select uh space-install"이고, 발화를 명령 형태로 고쳤습니다.
확인: 터미널 창에 명령이 들어간다.
-
Return(엔터)을 누릅니다.
확인: "Install requested"가 뜬다.
-
다른 창 뒤에 숨은 설치 창을 찾습니다.
주의: 화자도 설치 창이 창 뒤에 숨어 있어서 한참 찾았습니다. Cmd+Tab으로 창을 넘기거나 Dock에서 설치 아이콘을 찾으면 빠릅니다.
확인: 설치 확인 창이 앞에 보인다.
-
"Install"을 누릅니다.
확인: 설치가 진행된다. 약 10~15분 걸린다고 화자는 말합니다.
-
Xcode 설치가 끝나면 Homebrew 설치 명령을 터미널에 입력합니다.
위치: 화자는 명령을 읽지 않았습니다. Homebrew 공식 사이트(brew.sh) 첫 화면에 있는 설치 명령은 아래와 같습니다(편집자 보충).
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
확인: 터미널에서 Homebrew 설치가 시작된다. 중간에 Mac 계정 암호를 묻는다.
-
처음 명령을 넣은 뒤 Return(엔터)을 한 번 더 누릅니다.
확인: 추가 작업 안내가 나온다.
-
터미널에 뜬 "Next steps"의 첫 번째 명령을 복사합니다(Cmd+C).
위치: 터미널 "Next steps" 아래. 영상에서는 명령 내용이 판독되지 않았습니다. Apple 칩 Mac에서는 보통 아래 세 줄이 나오고, 폴더 이름 자리에 내 계정 이름이 들어갑니다. 터미널에 뜬 것을 그대로 복사하는 것이 가장 정확합니다(편집자 보충).
echo >> /Users/{폴더이름}/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/{폴더이름}/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
확인: 클립보드에 명령이 있다.
-
터미널에 붙여 넣습니다(Cmd+V).
확인: 명령이 터미널에 들어간다.
-
"Next steps"의 두 번째 명령을 복사합니다.
확인: 클립보드에 두 번째 명령이 있다.
-
터미널에 붙여 넣습니다.
확인: 명령이 터미널에 들어간다.
-
"Next steps"의 세 번째 명령을 복사합니다.
확인: 클립보드에 세 번째 명령이 있다.
-
터미널에 붙여 넣습니다.
주의: 각 명령을 붙여 넣은 뒤 엔터를 눌렀는지는 영상에서 판독되지 않았습니다. 한 줄씩 붙여 넣고 그때마다 Return을 누르면 됩니다. 다 끝나고
brew --version을 쳐서 버전이 나오면 성공입니다(편집자 보충).확인: 세 명령이 모두 들어갔다.
-
기본 명령을 다시 실행합니다.
위치: 화자는 "basic command"라고만 말합니다. 문맥상 60단계의 openclaw.ai 설치 명령을 다시 실행한 것으로 보입니다.
확인: "homebrew already installed"가 뜨고 설치가 진행된다.
8. 온보딩(첫 설정 질문에 답하기)
온보딩 화면은 방향키로 항목을 옮기고 Enter로 고르는 방식입니다. 여러 개를 고르는 목록에서는 스페이스바로 체크합니다(편집자 보충).
-
"이것이 강력하고 본질적으로 위험하다는 것을 이해한다(I understand that this is powerful and inherently risky)"에 "Yes"로 답합니다.
주의: OpenClaw 스스로 위험을 경고하는 문구입니다.
확인: 온보딩 방식 선택 화면이 뜬다.
-
"QuickStart" 온보딩 모드를 고릅니다.
확인: 설정값 관련 질문이 뜬다.
-
기존 값(existing) 사용을 고릅니다.
대안: 화자 설명으로는 "직접 설정할지, 기본값을 쓸지"를 묻는 질문입니다.
확인: 모델 제공자 목록이 뜬다.
-
목록에서 "Google"을 고릅니다.
주의: 목록 위쪽 대부분은 클라우드라 사용료가 든다고 합니다.
대안: OpenAI, Anthropic(Claude), MiniMax(자막 "Miniax")도 있습니다. 화자는 MiniMax가 "비교적 저렴하다"고 말합니다. 각 항목에 필요한 것(API 키, 또는 API 키 + OAuth)이 표시됩니다.
확인: API 키 입력 칸이 뜬다.
-
메모장의 Google API 키를 붙여 넣습니다.
주의: 키를 화면이나 영상에 노출하지 않습니다.
확인: 모델 선택 화면이 뜬다.
-
모델을 고릅니다.
주의: 화자는 "Gemini 3 Pro Preview"를 골랐고, 나중에 이걸 "첫 번째 실수"라고 부릅니다. 금방 매우 비싸진다는 이유입니다. 처음부터 싼 Flash 계열을 고르면 10번 구획을 건너뛸 수 있습니다.
확인: 대화 채널 선택 화면이 뜬다.
-
채널 목록에서 "Telegram"을 고릅니다.
대안: WhatsApp, Discord, IRC, Google Chat, iMessage 등도 있습니다.
확인: 봇 토큰 입력 칸이 뜬다.
-
메모장의 Telegram 봇 토큰을 붙여 넣습니다.
확인: "스킬을 설정할까요(configure skills)?" 질문이 뜬다.
-
"Yes"로 답합니다.
확인: 스킬 목록이 뜬다. 화자는 Sonos CLI, OpenHue를 예로 들고, Home Assistant 옵션도 있다고 말합니다.
-
스킬은 지금 설치하지 않고 그대로 두고 넘어갑니다.
대안: 화자는 "지금은 그대로 두고, 나중에 어떻게 할 수 있는지 묻겠다"고 말합니다. 아무것도 체크하지 않고 Enter를 누르면 넘어갑니다.
확인: boot MD 등 다음 설정 항목이 뜬다.
-
"boot MD"는 선택하지 않습니다.
대안: 매번 실행되는 스크립트라서 화자는 원치 않았다고 합니다.
확인: boot MD가 선택 해제돼 있다.
-
"Bootstrap extra files"를 선택합니다.
대안: 봇이 매번 읽을 추가 파일을 넣을 계획이라 화자는 선택했습니다.
확인: Bootstrap extra files가 선택돼 있다.
-
"command logger"를 선택합니다.
대안: 화자는 "뭔가 잘못되면 이 봇이 무엇을 했는지 보려고" 선택했습니다.
확인: command logger가 선택돼 있다.
-
"게이트웨이 서비스 설치(install the gateway service)"에 "Yes"로 답합니다.
확인: 런타임 선택이 뜬다.
-
런타임으로 "node"를 고릅니다.
대안: 화자 화면에는 node만 선택지였고, Telegram을 쓰려면 필요했다고 말합니다.
확인: "node가 네트워크에 접근하도록 허용할까요?" 팝업이 뜬다.
-
팝업에서 허용을 누릅니다.
확인: 봇이 시작되고 게이트웨이가 재시작된다.
-
봇을 "부화(hatch)"시키는 방식으로 웹 인터페이스를 고릅니다.
대안: OpenClaw는 TUI(터미널 화면)를 권하지만, 화자는 봇과 직접 대화하고 설정도 볼 수 있는 웹 인터페이스를 선호합니다.
확인: 웹 인터페이스가 열린다.
9. Telegram 연결 승인(페어링)과 첫 대화
-
Telegram에서 BotFather로 만든 봇 이름을 정확히 검색합니다.
확인: 내 봇 대화창이 열린다.
-
"Start"를 누릅니다.
주의: 빨간색으로 "delivered"가 떠도 실제로는 오류가 돌아옵니다. 한 단계가 더 필요합니다.
확인: "OpenClaw access not configured" 메시지와 코드가 온다.
-
메시지 속 코드를 확인합니다.
확인: 코드를 알고 있다(복사해 둠).
-
터미널 창으로 갑니다.
대안: Telegram과 터미널을 "조금 왔다 갔다" 하게 된다고 화자는 말합니다.
확인: 터미널이 앞에 있다.
-
아래 명령을 입력해 실행합니다.
{코드}자리에 Telegram 메시지의 코드를 넣습니다.
openclaw pairing approve telegram {코드}
확인: 명령이 오류 없이 끝난다.
- Telegram에서 아래를 다시 보냅니다.
/start
대안: OpenClaw 웹 인터페이스의 채팅 창에서 대화를 시작해도 됩니다.
확인: 봇이 긴 응답을 보내며 설정 대화를 시작한다.
-
봇에게 성격과 해 줄 일을 알려 줍니다.
대안: 화자는 아주 간단히 세 줄 정도만 썼지만 "실제로는 훨씬 더 많이 써야 한다"고 말합니다. 나중에 더 넣어도 됩니다.
확인: 봇이 soul.md, identity, user 파일에 스스로 기록한다.
처음 쓸 문장이 막막하다면 이런 식으로 시작하면 됩니다(편집자 예시).
너는 내 개인 비서야. 이름은 {봇 이름}으로 할게.
나는 {하는 일}을 하고, 주로 {관심사}에 대해 물어볼 거야.
답은 한국어로 짧게, 모르는 건 모른다고 말해 줘.
돈이 드는 작업이나 파일을 지우는 작업은 하기 전에 꼭 나에게 먼저 물어봐.
10. 모델을 싼 것으로 바꾸기 (화자의 "첫 번째 실수" 수정)
화자 말로는 지금 상태의 봇은 할 수 있는 게 적고 웹에도 접근하지 못합니다. 그리고 Gemini 3 Pro는 "금방 매우 비싸진다"고 합니다. OpenClaw 비용 줄이기에서 가장 효과가 큰 설정이 이 모델 교체입니다.
-
현재 설정된 모델 목록을 확인합니다.
위치: 터미널. 영상에서 쓴 명령은 판독되지 않았습니다. 현재 OpenClaw에서는 보통
openclaw models list로 확인합니다. 명령 이름이 다르면openclaw models --help로 찾습니다(편집자 보충).확인: Gemini 3 Pro 하나만 있다.
-
모델 1.5 Flash를 추가·지정합니다.
위치: 터미널. 영상 명령은 판독되지 않았습니다. 기본 모델을 바꾸는 명령은 보통
openclaw models set {제공자/모델이름}형태입니다(편집자 보충).확인: 테스트해 보니 적용됐다.
-
모델을 Gemini 2.0 Flash로 바꿉니다.
대안: "2.0이 1.5와 같은 가격"이라서 바꿨다고 화자는 말합니다(화자 주장).
주의: 모델 두 개를 넣고 나니 특정 모델을 쓰게 하는 방법을 몰랐다고 화자는 말합니다.
확인: 모델 두 개가 설정돼 있다.
-
온보딩을 다시 실행합니다.
위치: 터미널. 화자는 "아주 간단한 명령"이라고만 말합니다. 온보딩을 다시 여는 명령은 아래입니다(편집자 보충).
openclaw onboard
대안: 온보딩을 다시 돌리면 처음에 한 선택을 모두 바꿀 수 있습니다. 모델 지정이 헷갈릴 때 가장 확실한 방법입니다.
확인: 온보딩 질문이 처음부터 다시 나온다.
-
Google 모델 목록에서 2.0 Flash를 고릅니다.
확인: 2.0 Flash가 선택된다.
-
Telegram 페어링을 다시 합니다(9번 구획의 93~98단계와 같은 방식).
확인: Flash 2.0으로 봇이 작동한다. 화자는 "돈을 많이 쓰지 않는다"고 말합니다.
11. 웹 검색 연결과 월 한도: Brave Search API
이 설정 전에는 봇에게 무엇을 물어도 웹 정보가 "통과하지 않는다"고 화자는 말합니다. 비용 면에서는 월 한도를 거는 119단계가 핵심입니다.
-
브라우저에서 brave.com 에 접속합니다.
확인: Brave 사이트가 뜬다.
-
위쪽의 "Search API"로 갑니다.
위치: 화면 위쪽
확인: Search API 페이지가 뜬다.
-
API 기능(API features)을 살펴봅니다.
확인: 요금제 옵션이 보인다.
-
"answers"가 아닌 "search" 옵션을 고릅니다.
대안: 화자 의견은 "search 옵션을 원할 것"입니다.
확인: search 옵션이 선택된다.
-
"Get started"를 누릅니다.
확인: 매월 $5 무료 크레딧, 1,000회 요청당 $5, 용량 제한 안내가 보인다. 화자는 "아마 돈이 들지 않을 것"이라고 말합니다.
-
"Sign up"을 누릅니다.
확인: 가입 양식이 뜬다.
-
이메일, 비밀번호, 간단한 개인 정보를 입력해 가입합니다.
확인: 인증 메일이 온다.
-
이메일 인증을 합니다.
확인: 계정이 활성화된다.
-
플랫폼에 로그인합니다.
확인: Brave API 대시보드가 뜬다.
-
아래쪽 "Billing"으로 갑니다.
확인: 결제 화면이 뜬다.
-
결제 수단을 추가합니다.
확인: 요금제를 고를 수 있게 된다.
-
요금제에서 "get started"를 누릅니다.
대안: 화면의 하루 요청 수는 자막상 "35"(단위 불명)입니다. 봇을 풀어 두면 다 쓸 수 있다고 화자는 말합니다.
확인: 요금제가 선택되고 사용 한도 설정과 API 키 만들기 안내가 보인다.
-
사용 한도(usage limit) 설정에서 search 요금제를 고릅니다.
확인: 월 한도 입력 칸이 뜬다.
-
월 한도에 5를 입력합니다.
주의: 한도를 넘으면 인터넷 검색이 막혀 봇이 사실상 멈춘다고 합니다. 한도는 필요에 따라 조정합니다.
확인: 월 한도가 $5로 제한됐다.
-
"API keys"로 갑니다.
확인: API 키 화면이 뜬다.
-
API 키를 추가(Add API key)합니다.
확인: 새 키가 화면에 보인다.
-
키를 복사합니다.
확인: 클립보드에 Brave 키가 있다.
-
터미널을 엽니다.
확인: 터미널 창이 열린다.
-
아래 명령을 입력해 실행합니다. OpenClaw 설정 중 웹(web) 부분만 다시 여는 명령입니다.
openclaw configure --section web
위치: 자막 표기는 "Open claw space configure dash d- section web"이고, 발화를 명령 형태로 고쳤습니다.
확인: "이 게이트웨이를 어디서 실행하나요?" 질문이 뜬다.
-
로컬(local)을 고릅니다.
확인: "웹 검색을 켤까요?" 질문이 뜬다.
-
"Yes"로 답합니다.
확인: API 키 입력 칸이 뜬다.
-
복사한 Brave API 키를 붙여 넣습니다.
확인: "web fetch를 켤까요?" 질문이 뜬다.
-
"Yes"로 답합니다.
대안: web fetch(검색 결과 페이지의 본문까지 읽어 오는 기능)는 정보를 훨씬 잘 가져오게 해 주므로 "대체로 켜는 게 좋다"고 화자는 설명합니다.
확인: Brave Search API 연결이 끝난다.
-
봇 대화창에 아래를 보내 새 세션을 엽니다.
/new
확인: 새 세션이 시작된다.
-
웹 검색이 필요한 질문을 보냅니다.
대안: 화자 질문은 "How many gold medals does Canada currently have at the 2026 Olympic Games?"(2026 올림픽에서 캐나다가 지금 금메달 몇 개를 땄나)였습니다.
확인: 출처가 붙은 답이 돌아온다. 웹 인터페이스에서는 답을 만든 과정이 더 자세히 보인다. 답의 내용은 영상에 나오지 않습니다.
-
(선택) 봇에게 필요한 스킬을 찾아보라고 묻습니다.
Which skills from Clawhub would help us the most in order to meet our home automation goals? Could you go out and have a look for us and find some of the ones that work with smart home systems today.
뜻: "홈 오토메이션 목표에 ClawHub의 어떤 스킬이 가장 도움이 될까? 지금 스마트홈 시스템과 연동되는 것들을 찾아봐 줘."
대안: 위 문장은 화자가 보낸 질문입니다. 조건(예: Home Assistant만)을 더 붙이면 원하는 답에 가까워진다고 말합니다.
확인: 봇이 스킬 후보를 찾아 답한다. 답의 내용은 영상에 나오지 않습니다.
12. 보안: OpenClaw 게이트웨이 포트 바꾸기
화자 설명으로는 지금 쓰는 포트가 "공개적으로 알려진 포트"라서 누군가 OpenClaw를 공격할 경로가 될 수 있습니다. 포트는 컴퓨터 안에서 프로그램마다 붙는 문 번호입니다. 모두가 같은 번호를 쓰면 공격자가 어디를 두드릴지 쉽게 짐작합니다.
-
웹 인터페이스의 Overview(개요) 페이지를 엽니다.
주의: 여기서 포트를 바로 바꿀 수 있을 것처럼 보이지만 안 된다고 합니다.
확인: gateway token(게이트웨이 토큰)이 보인다.
-
게이트웨이 토큰을 복사합니다.
확인: 클립보드에 토큰이 있다.
-
토큰을 안전한 곳에 저장합니다.
확인: 토큰이 따로 저장돼 있다(새 포트에 접속할 때 필요).
-
터미널로 갑니다.
확인: 터미널이 앞에 있다.
-
아래를 입력해 실행합니다.
bash
확인: 새 bash 셸로 들어간다.
- 아래 명령을 입력합니다.
{포트번호}자리에 직접 고른 번호를 넣습니다.
openclaw config set gateway.port {포트번호}
위치: 자막 표기는 "open claw config setgateway.port"이고, 발화를 명령 형태로 고쳤습니다.
주의: 화자는 모두가 같은 포트를 쓰지 않도록 일부러 번호를 알려 주지 않습니다. 쓸 수 있는 포트 범위도 말하지 않았습니다. 일반적으로는 1024보다 크고 다른 프로그램이 쓰지 않는 번호를 고릅니다. 10000~60000 사이에서 기억할 만한 숫자를 고르면 무난합니다(편집자 보충).
확인: 명령이 터미널에 들어간다.
-
Return(엔터)을 누릅니다.
주의: 터미널은 "게이트웨이를 재시작하라"고 안내합니다. 그런데 화자가 재시작해 보니 여전히 옛 포트로 접속되고 새 포트로는 안 됐습니다. 재시작 명령은 영상에서 판독되지 않았고, 보통
openclaw gateway restart입니다(편집자 보충).확인: 설정 명령이 끝난다.
-
게이트웨이를 멈춥니다.
위치: 터미널. 영상 속 정지 명령은 판독되지 않았습니다. 보통 아래 명령을 씁니다(편집자 보충).
openclaw gateway stop
확인: 게이트웨이가 멈춘다.
- 아래 명령을 실행합니다. 게이트웨이를 백그라운드 서비스로 다시 설치해, 바뀐 포트를 반영하게 합니다.
openclaw gateway install
확인: 명령이 실행된다.
-
몇 초 기다립니다.
확인: 게이트웨이가 다시 올라온다.
-
브라우저에서 새 포트 주소로 웹 인터페이스를 엽니다.
위치: 영상에서는 주소 형식이 판독되지 않았습니다. 같은 Mac mini에서 연다면 주소창에
http://127.0.0.1:{포트번호}/를 입력합니다(편집자 보충).확인: 옛 포트로는 안 열리고 새 포트로는 열린다.
-
저장해 둔 게이트웨이 토큰을 붙여 넣습니다.
확인: 토큰 칸이 채워진다.
-
"Connect"를 누릅니다.
확인: 봇과 다시 연결되고, 말을 걸면 답한다. 화자 봇은 LA 현재 시각을 알려 줬습니다.
13. 봇 맞춤 설정: 메모리 파일 채우기
- 봇에게 메모리 파일 목록과 역할을 묻습니다.
Can you give me the different files in your memory and just a basic of what they do for you?
뜻: "네 메모리에 있는 파일들과 각각 무슨 역할을 하는지 간단히 알려 줄래?"
대안: 위 문장은 화자가 보낸 질문입니다. 한국어로 물어도 됩니다.
확인: 파일 목록이 온다. 화자 봇(Dr. Zoidberg) 기준으로 memory(장기 기억)와 memory logs, identity(정체성), user(사용자 정보·선호·프로젝트), soul(성격·핵심 원칙·경계), tools(도구 메모), heartbeat(주기 점검)입니다.
- soul.md를 보여 달라고 합니다.
Show me soul.md
확인: soul.md 내용이 온다.
- (내용 대신 설명만 오면) 파일 원문을 출력해 달라고 다시 말합니다.
I want the soul.md file printed out.
확인: soul.md 원문이 출력된다. 화자가 soul.md에 넣은 예로는 "보여 주기식 말고 진짜로 도움 되게", 동의하지 않아도 됨, 스스로 해결책 찾기, "사적인 것은 사적으로"가 있습니다.
-
참고할 글(텍스트)이나 URL을 대화창에 붙여 넣습니다.
대안: 화자는 X 게시물(자막 "expost") 내용을 가져왔습니다. 알맞은 스킬이 있으면 봇에게 URL을 직접 보여 줄 수 있다고 말합니다.
확인: 대화창에 글이나 URL이 들어간다.
-
무엇을 반영할지 봇에게 묻습니다.
Hey, evaluate this for us and let's talk about what we should implement off of that.
뜻: "이걸 평가해 보고, 여기서 무엇을 우리 쪽에 적용할지 같이 얘기해 보자."
대안: 화자 조언은 "명령하지 말고 질문하라"입니다. 봇과 "이게 우리에게 맞는 시스템"이라고 합의하는 지점까지 대화합니다.
주의: 화자가 넣은 "답하기 전에 메모리 파일부터 찾아보라" 규칙은 토큰(모델이 읽고 쓰는 글자 단위, 곧 비용)을 더 씁니다. 대신 환각(hallucination, 없는 사실을 지어내는 것)을 줄이려는 목적이라고 합니다.
확인: 합의한 규칙이 메모리 파일에 들어간다. 반영(commit)하라고 말하면 되고 나중에도 고칠 수 있다고 화자는 말합니다.
14. OpenClaw heartbeat 끄기 (30분마다 도는 자동 점검)
- 봇에게 아래처럼 보냅니다.
Stop being proactive. I'll contact you with anything I want to do.
뜻: "먼저 나서지 마. 하고 싶은 일이 있으면 내가 연락할게."
대안: heartbeat가 필요하면 끄지 않습니다. 화자 봇은 heartbeat로 "급한 안 읽은 메일 확인" 같은 일을 하려 했습니다. 점검 간격만 늘려 달라고 요청하는 절충도 가능합니다.
확인: 약 30분마다 돌던 점검이 멈춘다. 화자는 "30분마다 돈이 나가지 않게 된다"고 말합니다.
15. Mac mini가 잠들지 않게 하기
-
Mac의 시스템 설정을 엽니다.
위치: 화면 왼쪽 위 사과 메뉴 → 시스템 설정
확인: 시스템 설정 창이 열린다.
-
"에너지(Energy)" 항목으로 갑니다.
주의: 여기에는 에너지 사용을 줄이려고 기기 전체를 멈추는 설정이 있습니다. 화자는 "OpenClaw용으로는 아니다"라며 쓰지 않았습니다.
확인: 에너지 설정 화면이 뜬다.
-
"디스플레이가 꺼져 있을 때 자동으로 잠자기 방지(Prevent automatic sleeping when the display is off)"를 켭니다.
확인: 이 항목이 켜져 있다. 화자는 이렇게 해서 밤이나 외출 중 화면이 꺼져도 Telegram 등으로 봇에 접근할 수 있었다고 말합니다.
16. ClawHub 설치와 안전한 스킬 고르기
ClawHub는 OpenClaw 스킬(봇에게 새 일을 가르치는 설명서와 코드 묶음)을 사람들이 올려 두는 공유 저장소입니다.
- 터미널에 아래를 입력해 실행합니다.
bash
확인: bash 셸로 들어간다.
- 아래 명령을 실행합니다.
npm install -g clawhub
위치: 자막 표기는 "MPM install-g clawhub"이고, 발화를 명령 형태로 고쳤습니다.
확인: 설치가 끝난다.
-
설치된 ClawHub을 확인합니다.
위치: 영상에서 쓴 명령은 판독되지 않았습니다. 명령 목록을 보려면
clawhub --help를 칩니다(편집자 보충).확인: "clawhub command line interface 0.7.0"과 명령 목록(login은 브라우저를 연다, logout 등)이 보인다.
-
아래 명령을 실행합니다.
clawhub login
확인: 브라우저에 로그인 페이지가 열린다.
-
GitHub 계정으로 로그인합니다.
확인: 로그인이 끝난다. 이 탭은 닫아도 된다.
ClawHub 스킬 고르는 기준
이후 화자는 스킬을 검색(예: "Google")해 보여 주지만 설치는 하지 않습니다. 검색 명령은 영상에서 판독되지 않았고, 보통 clawhub search {검색어} 형태입니다(편집자 보충). 화자가 강조한 기준은 이렇습니다.
- 검색 결과를 바로 설치하지 않습니다. "정말 위험해질 수 있다"고 합니다.
- "suspicious(의심)" 표시가 없는 것만 설치합니다.
- 제작자 이름을 누르면 그 사람이 올린 스킬과 다운로드·설치 수를 볼 수 있습니다. 화자는 OpenClaw 창시자 Peter의 스킬을 좋은 출발점으로 듭니다.
- 스킬의 코드와 설명("무엇을 하는가")을 읽습니다. "스킬은 늘 코드를 읽으라고들 한다"고 합니다(누가 그렇게 말하는지는 발화에 없음).
- 예로 든 GOG(Google Workspace) 스킬은 OAuth 인증(내 계정으로 로그인해 접근을 허락하는 방식)을 한 번 해야 하고 자격 증명 경로를 넘겨줍니다. Gmail 검색·발송, 캘린더, 시트 수정 등을 할 수 있지만 유료 Google Workspace 계정이 필요합니다. 화자 화면에서는 이 스킬에도 "suspicious" 표시가 있었고, 이유는 화자도 모른다고 합니다.
- 설치한 도구마다
--help를 붙이면 사용법이 나옵니다(자막 "the-help").
코드를 직접 읽기 어렵다면 봇에게 먼저 검토를 시키는 방법도 있습니다(편집자 예시).
이 ClawHub 스킬 페이지를 읽고, 설치하기 전에 위험한 부분이 있는지 알려 줘.
외부로 데이터를 보내는 코드, 비밀번호나 토큰을 요구하는 부분, 파일을 지우는 명령이 있는지 특히 봐 줘.
아직 설치하지는 마.
OpenClaw 비용·보안 최종 체크리스트
- Google Cloud Console 월 예산 알림(50/90/100%)이 설정돼 있다(결제 설정은 화자의 선택)
- API 키, 봇 토큰, Telegram ID가 공백 없이 텍스트 파일에 있고, 화면에 공개되지 않았다
- Mac mini에 FileVault가 켜져 있고 분석 공유가 꺼져 있다
- Xcode 명령줄 도구와 Homebrew가 설치돼 있다
- Telegram에서
/start에 봇이 답한다(페어링 승인 완료) - 모델이 Gemini 2.0 Flash로 바뀌어 있다(화자 기준)
- 웹 검색 질문에 출처가 붙은 답이 온다(Brave 월 한도 $5 설정)
- 게이트웨이가 새 포트에서만 열리고, 게이트웨이 토큰으로 연결된다
- heartbeat가 꺼져 있다(원하는 경우)
- 디스플레이가 꺼져도 Mac이 잠들지 않는다
clawhub login으로 GitHub 로그인이 돼 있다
막힐 때 확인할 곳
화자가 직접 겪은 건 homebrew 오류, sudo 실패, 실행 파일 설치, 숨은 Xcode 창, 페어링 전 무응답, 비싼 모델, 모델 지정, 포트 문제입니다. 나머지는 영상에서 설명한 설정을 바탕으로 짐작한 원인입니다(편집자 판단).
- 설치 명령을 붙여 넣으니 "homebrew is not found": 새 Mac에 전제 조건(Xcode, Homebrew)이 없어서입니다. 7번 구획대로
xcode-select --install→ Homebrew → 설치 명령 재실행. - bash 앞에 sudo를 붙여도 실패: 화자 경험으로는 권한 문제가 아니라 전제 조건 부족이었습니다. 위와 같이 전제 조건부터 설치합니다.
- 웹사이트 실행 파일로 직접 설치했더니 엉망: 전제 조건 없이 설치한 탓입니다. 화자는 "절대 하지 말라"고 하고, 지우기도 어려웠다고 합니다. 아래 "되돌리는 법"의 순서로 정리한 뒤 7번 구획부터 다시 합니다.
- Xcode 설치 창이 안 보임: 다른 창 뒤에 숨어 있습니다. 창을 치우고 설치 창에서 Install을 누릅니다.
brew명령이 없다고 나옴: Homebrew의 "Next steps" 세 줄을 실행하지 않았거나 터미널을 새로 열지 않은 것입니다. 69~74단계를 다시 하고 터미널을 껐다 켭니다.- Telegram에서 "delivered"가 떴는데 봇이 안 답함: 접근 승인(페어링) 전입니다. 97단계
openclaw pairing approve telegram {코드}후/start. - 비용이 금방 커짐: Gemini 3 Pro를 쓰고 있어서입니다. 10번 구획에서 2.0 Flash로 바꾸고, 2번 구획의 예산 알림을 둡니다. heartbeat가 켜져 있다면 14번 구획도 확인합니다.
- 모델을 2개 넣었는데 원하는 걸로 지정이 안 됨: 화자도 지정 방법을 몰랐습니다. 온보딩을 다시 돌려 모델을 고르고 Telegram을 다시 페어링했습니다.
- 봇이 웹 정보를 못 가져옴: 웹 검색이 설정되지 않았습니다. 11번 구획의 Brave Search API 연결.
- 어느 날 검색이 멈춤: Brave 월 한도($5)를 넘었을 수 있습니다. Brave에서 월 한도를 조정합니다.
- 포트를 바꾸고 재시작했는데 옛 포트로 계속 접속됨: 재시작만으로는 반영이 안 됐습니다(화자 경험). 게이트웨이 정지 →
openclaw gateway install→ 몇 초 대기. - 새 포트 화면에서 연결 안 됨: 게이트웨이 토큰을 넣지 않았을 수 있습니다. 저장한 토큰을 붙여 넣고 Connect.
- 밤이나 외출 중 Telegram에서 봇이 응답 없음: Mac이 잠자기에 들어갔을 수 있습니다. 15번 구획의 자동 잠자기 방지.
- userinfobot 결과가 이상함: 이름이 비슷한 가짜 봇일 수 있습니다.
@userinfobot을 정확히 입력하고 맞는 것만 엽니다.
되돌리는 법
- 온보딩에서 한 선택(모델, 채널, 스킬 등)은 온보딩을 다시 실행하면 바꿀 수 있다고 화자는 말합니다. 명령은
openclaw onboard입니다. - OpenClaw 완전 삭제도 가능하지만 영상에서는 "명령 몇 개가 필요하다"고만 했습니다. 일반적인 순서는 게이트웨이 정지(
openclaw gateway stop), 게이트웨이 서비스 제거(openclaw gateway uninstall), 프로그램 삭제(npm uninstall -g openclaw), 마지막으로 홈 폴더의 설정 폴더(보통 .openclaw) 정리입니다. 버전에 따라 한 번에 지우는 명령이 있을 수 있으니 공식 문서의 uninstall 안내를 먼저 확인합니다(편집자 보충). - 메모리 파일(soul.md 등) 내용은 언제든 대화로 고칠 수 있다고 합니다.
- 포트 원복은 137단계 명령에 원래 번호를 넣고 139~141단계를 반복하면 됩니다. heartbeat는 봇에게 다시 켜 달라고 말합니다. Brave·
Google 결제 해지 방법은 영상에 없으니 각 서비스의 결제 화면에서 결제 수단과 API 키를 삭제합니다(편집자 보충).
실패 기록으로 보는 OpenClaw 첫 설정
화자의 마무리 말은 대화하면서 한계를 시험해 보고, 봇에게 정보를 계속 주라는 것입니다. "몇 번 지우고 다시 설치해야 할 수도 있다"고도 합니다.
이 영상의 쓸모는 실패 기록에 있습니다. 공식 명령이 새 Mac에서 막히는 지점, 비싼 모델을 고른 실수, 재시작해도 안 바뀌는 포트까지 그대로 보여 줍니다. 비용 면에서 배울 점은 순서입니다. 결제를 켜기 전에 예산 알림을 걸고, 싼 모델로 시작하고, 검색 API에 월 한도를 걸고, 필요 없는 자동 점검은 끕니다.
아쉬운 건 핵심 설치 명령이 전부 화면에만 있다는 점입니다. 이 글은 설치, Homebrew, 모델 변경, 게이트웨이 정지 명령을 일반적인 형태로 채웠지만, OpenClaw는 업데이트가 잦아 명령 이름이 바뀔 수 있습니다. 실행 전에 공식 안내나 --help 출력과 한 번 맞춰 보세요.
자주 묻는 질문
OpenClaw 비용을 가장 크게 줄이는 설정은 무엇인가요?
모델 선택입니다. 화자는 Gemini 3 Pro Preview를 고른 것을 "첫 번째 실수"라 부르고 Gemini 2.0 Flash로 바꿨으며, 반나절 쓴 비용이 "약 1달러"였다고 합니다. 여기에 결제 계정 예산 알림, 검색 API 월 한도, heartbeat 끄기를 더하면 새는 곳을 대부분 막을 수 있습니다.
Google AI Studio 무료 등급으로 OpenClaw를 써도 되나요?
무료 등급으로도 API 키는 만들어지고 쓸 수 있습니다. 화자는 무료 등급이면 Google이 데이터를 학습에 쓴다며 결제를 설정했는데, 이는 개인정보를 어떻게 볼지에 따른 선택입니다. 결제를 켠다면 예산 알림을 먼저 거는 것이 안전합니다.
OpenClaw 게이트웨이 포트는 꼭 바꿔야 하나요?
필수는 아니지만 화자는 보안상 권합니다. 기본 포트는 공개적으로 알려져 있어 공격 경로가 될 수 있다는 이유입니다. 바꾼 뒤에는 재시작만으로 반영되지 않을 수 있으니 게이트웨이를 멈추고 openclaw gateway install로 다시 올린 뒤, 게이트웨이 토큰으로 연결합니다.
OpenClaw heartbeat는 무엇이고 꺼도 되나요?
봇이 약 30분마다 스스로 점검을 도는 기능입니다. 점검할 때마다 모델을 불러 비용이 나가므로, 급한 메일 확인처럼 자동으로 시킬 일이 없다면 꺼도 됩니다. 화자는 봇에게 "Stop being proactive"라고 말해 껐습니다.
ClawHub 스킬은 안전한가요?
모두 안전하다고 볼 수 없습니다. 화자는 검색 결과를 바로 설치하지 말고, "suspicious" 표시가 없는지, 제작자와 설치 수가 어떤지, 코드와 설명이 무엇을 하는지 읽은 뒤 설치하라고 권합니다. 코드를 읽기 어렵다면 봇에게 설치 전 검토부터 시키는 방법도 있습니다.
이 글은 Automate Your Life Tutorials 채널의 41분 27초 영상 영어 자동 자막을 기준으로 정리했고 화면은 대조하지 못했습니다. 비용과 모델 평가는 모두 화자 경험이며, 설치·Homebrew·모델 변경·게이트웨이 명령, 웹 주소, 포트 범위, 삭제 순서, 한국어 예시 프롬프트는 영상에 없거나 화면에만 있던 부분이라 편집자가 일반적인 방법으로 보충했습니다. 자막 표기는 "pseudo"(sudo), "MPM"(npm), "Miniax"(MiniMax), "expost"(X 게시물), "a studio.google.com"(aistudio.google.com)으로 잡혔습니다.
출처: youtu.be/…