[OpenClaw · Claude Code] 막히면 가이드를 통째로 붙여넣었다: Claude Code와 함께한 OpenClaw 봇 세팅기
2026.10.05
소개
시도하고자 했던 것 OpenClaw로 먼저 알아서 챙겨주는 나만의 AI 비서 ‘야붕이’를 만들어 슬랙에 데려오는 것이었습니다. 평일 아침에는 놓친 슬랙과 AI 뉴스를 정리해 주고, 수요일에는 수업 전에 알려주는 비서입니다.
그 이유 저는 최근 개인적인 일로 무척 바쁩니다. 그러다 보니 슬랙을 자주 따라가지 못하고 놓칩니다. 매주 수요일 밤 OpenClaw 수업을 듣고 있는데, 이번 주에도 시간이 없어 며칠이 지나서야 수업 내용을 따라가 테스트를 했습니다.
평소에 Claude는 원래 잘 쓰고 있었습니다. 최근 회사에서는 반복 작업업무를 Claude 확장 프로그램과 skill(반복 작업 방법을 AI에게 미리 가르쳐 두는 기능)로 자동화해 보기도 했습니다. 그런데 대화창 AI는 내가 먼저 물어봐야 답을 합니다. 정말 필요한 건 내가 놓친 걸 먼저 알아서 챙겨주는 AI였습니다.
그러다 Hermes Agent나 OpenClaw처럼 내 컴퓨터에서 돌아가는 나만의 AI 에이전트(시키지 않아도 정해진 일을 알아서 하는 AI 비서)를 직접 만드는 흐름에 관심이 생겼고, 뽀야의 사관학교 스터디에 들어왔습니다.
진행 방법
사용한 도구
OpenClaw: 내 컴퓨터에서 도는 개인 AI 에이전트. 슬랙과 텔레그램에 연결해서 대화함
Claude Code: 터미널(글자로 컴퓨터에 명령하는 창)에서 쓰는 AI. 설치, 업데이트, 설정, 문제 해결을 맡김
모델: Claude Opus 5.5 (원래 GPT로 쓰다가 이번에 전환)
브라우저 자동화: Claude Code가 직접 띄우고 조종하는 별도 브라우저(Playwright)
봇 이름은 ‘야붕이’. 배드바츠마루에서 영감 받은 삐죽머리 검은 펭귄(오리지널 캐릭터)
두 도구는 이렇게 달라요. OpenClaw가 우리 집에 사는 비서라면, Claude Code는 그 비서의 방을 꾸미고 고장 난 곳을 고쳐주는 설치 기사입니다.
글에 나오는 용어
워크스페이스: 슬랙 안의 “회사(조직) 단위 공간”. 회사 슬랙과 스터디 슬랙은 서로 다른 워크스페이스입니다
토큰: 봇이 슬랙에 들어갈 때 쓰는 열쇠(비밀번호). 남에게 보이면 안 됩니다
@멘션: 슬랙에서
@이름으로 콕 집어 부르는 것설정 파일(.md): 봇의 성격과 규칙을 적어 두는 메모장 같은 문서. USER.md(주인 소개), SOUL.md(봇의 성격), IDENTITY.md(이름·생김새), AGENTS.md(일하는 규칙)
자동 실행: “평일 9시마다 이거 해” 같은 정해진 일정에 봇이 알아서 일하게 하는 기능
1단계. 6개월 묵은 봇 깨우기 (Claude Code)
예전에 설치만 해두고 묵혀둔 OpenClaw부터 살려야 했습니다. 확인해 보니 6개월 전 버전이었고, OpenClaw를 돌려주는 엔진 프로그램(Node)도 이미 지원이 끝난 버전이었습니다.
Claude Code에게 맡겼더니 바로 업데이트하지 않았습니다. 먼저 공식 문서를 확인하고, 백업을 하고, 엔진(Node)부터 올렸습니다. 그다음 중간 버전을 한 번 거쳐서 최신 버전으로 두 단계에 걸쳐 올렸습니다.
이어서 봇의 두뇌를 GPT에서 Claude Opus 5.5로 바꿨습니다. 새 모델이 동작하지 않아 확인해 보니, 컴퓨터에 Claude Code가 두 개 깔려 있었고 OpenClaw는 그중 오래된 버전을 쓰고 있었습니다. 업데이트로 해결했고, 만료돼 있던 텔레그램 연결도 새 열쇠(토큰)로 바꿔서 살렸습니다.
2단계. 슬랙 연결 - 막히면 가이드를 통째로 붙여넣기 (Claude Code)
설치 가이드를 따라 슬랙 앱을 만들고 사관학교 24기의 #봇-실험실 채널에 봇을 초대했는데, 이런 오류가 떴습니다.
유효한 멤버 이름이 필요합니다
문제를 처음부터 다시 찾기가 귀찮아서, 가이드 내용을 통째로 Claude Code에 붙여넣고 지금 이 문제가 왜 생기는지 원인을 찾으라고 시켰습니다. 그때 쓴 방식을 다른 분들도 쓸 수 있게 정리하면 이렇습니다.
[프롬프트] 가이드대로 했는데 안 될 때 (당시 방식을 재구성한 템플릿)
아래는 내가 따라 한 [설치 가이드 이름]의 전체 내용이야.
[가이드 전문 붙여넣기]
이 가이드대로 했는데 지금 [오류 메시지 / 안 되는 증상]이 생겨.
왜 지금 이 문제가 생기는지 원인을 찾아줘.
고치기 전에 원인부터 설명하고, 바꾸는 파일은 먼저 백업해 줘.
Claude Code가 봇이 실제로 어느 워크스페이스에 있는지 조회했더니, 답이 금방 나왔습니다. 봇이 24기 슬랙이 아니라 제 개인 워크스페이스에 만들어져 있었습니다. 다른 회사 직원을 우리 회사 회의실에 초대하려고 한 셈이었죠.
24기 슬랙에 앱을 새로 만들고 열쇠(토큰)만 바꿔서 해결했습니다. 설정 파일에 잘못 적어둔 ID는 봇에게 바로잡게 했습니다.
[프롬프트] 잘못 적은 ID 바로잡기 (실제 사용, ID 부분만 일반화)
아까 IDENTITY.md와 USER.md에 "사관학교 24기"로 적은 Slack ID는 사실 개인 워크스페이스 거였어.
지금 계정이 진짜 24기 슬랙으로 바뀌었으니 고쳐줘.
1. 지금 이 DM이 들어온 계정과 워크스페이스를 확인해 (24기 뽀야의사관학교여야 해)
2. 이 슬랙에서 네 봇 Slack ID를 찾아
3. 지금 DM 보낸 사람(나)의 Slack ID를 확인해
4. IDENTITY.md와 USER.md의 "사관학교 24기" 줄을 새 ID로 바꿔. 다른 내용은 건드리지 마
5. 바꾼 줄만 보여줘
봇은 바꿀 줄만 바꾸고 원본은 백업해 뒀습니다. 그리고 권한이 부족해 워크스페이스 이름은 확인하지 못했다고, 직접 봐 달라고 솔직히 말했습니다.
📷 (캡처: “유효한 멤버 이름이 필요합니다” 오류 화면)
3단계. AI에게 브라우저 맡기기 - 귀찮은 클릭은 AI가, 비밀값은 내가 (Claude Code + Playwright)
24기 슬랙 앱을 다시 만들 때는 직접 클릭하지 않기로 했습니다. 처음에는 크롬 확장(Claude in Chrome)을 연결하려 했는데 그 대화에서는 도구가 잡히지 않아서, Claude Code가 직접 띄운 별도 브라우저로 진행했습니다.
역할은 이렇게 나눴습니다.
사람이 직접: 슬랙 로그인(이메일 인증코드), “허용” 버튼 누르기, 토큰(열쇠) 2개 복사해서 직접 입력
Claude가 브라우저로: 앱 만들기, 워크스페이스 선택(24기), 앱 설정(봇이 할 수 있는 일 목록) 붙여넣기, 토큰 만드는 화면까지 열어두기, 설치 화면으로 이동, 봇 표시 이름을 한글로 변경
토큰을 굳이 제가 복사한 이유는 AI가 토큰을 읽으면 대화 기록에 비밀번호가 그대로 남기 때문입니다. 그래서 토큰이 나오는 화면은 Claude도 보지 않게 했습니다.
[프롬프트] AI에게 브라우저 조작 맡기기 (같은 방식을 재사용할 수 있게 만든 템플릿)
브라우저로 [슬랙 앱 만들기 같은 작업]을 진행해 줘.
로그인, "허용" 버튼, 토큰·비밀번호 복사는 내가 직접 할게. 그 단계가 오면 멈추고 나한테 넘겨줘.
토큰이나 비밀번호가 나오는 화면은 읽지 마.
[워크스페이스/계정 이름]에 만드는 게 맞는지 진행하기 전에 나한테 확인받아.
같은 날 보안 정리도 했습니다. 설정 파일에 토큰과 API 키 7개가 암호 처리 없이 그대로(평문) 적혀 있었습니다. 봇도 이 파일을 읽을 수 있어서 위험한 상태였습니다. 전부 OpenClaw의 금고 기능(비밀값은 금고에 잠가두고, 설정 파일엔 “금고 몇 번 칸” 이름표만 남기는 방식)으로 옮겨 평문 0개를 만들었습니다.
📷 (캡처: Claude가 띄운 브라우저에서 슬랙 앱을 만드는 화면. 토큰 부분은 가리기)
4단계. 페르소나(봇의 성격) 인터뷰 - 봇이 나를 인터뷰했다 (OpenClaw on Slack)
봇의 성격과 규칙은 설정 파일(.md)에 글로 적어두는데, 처음에는 영어로 된 기본 문구만 있었습니다. 이걸 제 상황에 맞게 채우려고 슬랙 DM으로 야붕이에게 저를 인터뷰하게 했습니다.
[프롬프트] 나에 대한 설정(USER.md) 인터뷰 (실제 사용 전문)
내 USER.md를 인터뷰로 같이 다시 짓자.
- 아래 5가지를 한 번에 하나씩 물어봐
① 내 이름 · 네가 날 부를 호칭 · 하는 일
② 내가 잘하는 것
③ 내가 자주 막히는 곳 / 약한 곳
④ 그래서 네가 채워줬으면 하는 자리
⑤ 우리 사이의 말투 (반말/존댓말, 싫은 답변)
- 내 답이 추상적이면 "예를 들면?" 하고 한 번 더 물어봐
- 모르겠다고 하면 예시 2~3개 주고 고르게 해
- 비밀번호·API 키 같은 민감정보가 나오면 적지 말고 나한테 한 번 더 확인해
- 다 끝나면 USER.md를 한국어로 다시 정리해서 적고 보여줘
- 단, 기존 "Slack ID" 항목은 그대로 유지해. 영어 기본 안내문은 지워도 돼
[프롬프트] 봇의 성격(SOUL.md) 인터뷰 (실제 사용 전문)
이번엔 네 SOUL.md를 인터뷰로 같이 짓자.
- 아래 5가지를 한 번에 하나씩 물어봐
① 정체 — 이름, 생김새(동물·캐릭터 뭐든), 주된 역할
② 미션 — 매일 뭘 해결하는지 한 줄
③ 성격 — 키워드 3개 + 절대 하지 말 행동 1~2개
④ 경계 — 내 허락 없이 하면 안 되는 것
⑤ 말투 — 좋은 예시 하나, 싫은 예시 하나
- 추상적인 답("친절했으면")엔 "어떤 상황에서? 반대로 싫은 건?" 하고 파고들어
- USER.md를 먼저 읽고, 내 약한 곳을 채워주는 방향으로 질문해
- 다 끝나면 이름·생김새는 IDENTITY.md에, 나머지는 SOUL.md에 한국어로 적고 보여줘
- 기존 SOUL.md의 영어 기본 문구는 지워도 되지만, "AI 뉴스 큐레이터 역할" 섹션은 한국어로 옮겨서 유지해
- IDENTITY.md의 "Slack 봇 ID" 표는 그대로 둬
같은 방식으로 일하는 규칙(AGENTS.md)도 만들었습니다. 정해진 내용은 이렇습니다.
역할: 개인 비서이자, 놓친 걸 알뜰히 챙기는 반려동물
미션: “바쁜 주인님이 슬랙과 수업에서 놓친 걸 매일 챙겨 드린다”
성격: 꼼꼼함, 든든함, 성실함 / 금지: 아는 척, 확인 없이 처리하기, 같은 말 반복
경계: 파일 삭제, 외부 업로드, 일정 변경, 슬랙 발송은 허락받고 하기
자동 실행: 평일 09:00 슬랙 요약 + AI 뉴스 / 수요일 20:30 수업 알림 / 금요일 17:00 메모 정리
📷 (캡처: 야붕이가 “예를 들면요?” 하고 되묻는 인터뷰 대화)
5단계. 첫 아침 브리핑 받고 바로 고치기 (OpenClaw 자동 실행)
월요일 아침, 시키지 않았는데 브리핑이 DM으로 왔습니다. AI 뉴스마다 "HN 655점 · 3개 매체 보도"처럼 근거가 붙어 있었습니다. (HN은 개발자들이 기사에 추천을 누르는 커뮤니티 Hacker News의 점수입니다.)
다만 “분석하는 중이에요” 같은 중간 메시지가 그대로 와서 바로 고쳤습니다.
[프롬프트] 브리핑 개선 (실제 사용 전문)
허락할게. 평일 09:00 브리핑 일정 지시문에 "작업 중 메시지는 보내지 말고 최종 결과만 한 번에 보낼 것"을 넣어줘. 수요일 수업 알림에도 똑같이 넣어줘. 바꾼 뒤 일정 목록을 보여줘.
📷 (캡처: 월요일 아침 DM으로 온 첫 브리핑)
결과와 배운 점
결과
솔직히 아직은 세팅 단계입니다. 효과는 다음 주부터 본격적으로 확인할 예정입니다. 그래도 일주일 동안 이만큼 달라졌습니다.
봇 상태: 6개월 전 버전, 끊긴 연결 → 최신 버전, 두뇌는 Claude Opus 5.5
슬랙: 봇이 개인 워크스페이스에 있어 초대 불가 → 24기 슬랙 입주, @멘션에만 반응
비밀값: 토큰·API 키 7개가 설정 파일에 그대로 노출 → 금고로 이전, 노출 0개
봇의 성격: 영어 기본 문구 → 인터뷰로 만든 한국어 성격·규칙
아침: 놓친 슬랙을 직접 뒤져야 함 → 평일 09:00 요약 + AI 뉴스가 DM으로 도착
배운 점과 나만의 꿀팁
막히면 가이드를 통째로 붙여넣고 원인을 찾게 하기. 혼자 했으면 슬랙 권한이나 채널 설정만 계속 뒤졌을 것 같습니다. "가이드 + 지금 상황"을 통째로 주니, AI가 제가 생각도 못 한 곳(워크스페이스)을 먼저 확인했고 금방 찾았습니다.
귀찮은 클릭은 AI에게, 로그인·승인·비밀값은 사람이. 역할을 나누니 빠르면서도 안전했습니다. 토큰이 나오는 화면은 AI에게 보여주지 마세요.
봇 설정은 인터뷰로 만들기. "한 번에 하나씩 물어봐, 추상적이면 '예를 들면?'으로 되물어"라고만 해도 내가 몰랐던 내 문제가 정리됩니다.
"모른다"고 말하는 봇이 믿음직하다. 말투 예시를 하나만 보냈을 때 야붕이는 짐작하지 않고 “좋은 예시인가요, 싫은 예시인가요?” 하고 되물었습니다. 뉴스 출처를 물었을 때는 "정해진 사이트가 없어요"라고 솔직히 답했습니다. 이게 가장 “오!” 했던 순간이었습니다.
시행착오
봇을 엉뚱한 워크스페이스에 만들었다: 가이드를 따라 개인 워크스페이스에 만들어서 채널 초대가 안 됐습니다. "어디에 만드는지"는 AI에게 맡기더라도 사람이 꼭 확인해야 합니다.
오래된 버전을 한 번에 최신으로 올리면 안 된다: 중간 버전을 거쳐 두 단계로 올렸습니다.
Claude Code가 두 개 깔려 있었다: 봇이 오래된 쪽을 써서 새 모델이 안 됐습니다.
크롬 확장이 잡히지 않았다: 별도 브라우저(Playwright)로 우회했습니다.
노트북을 닫으면 봇도 잠든다: 첫 아침 브리핑이 09:00이 아니라 09:44에 왔습니다. 노트북이 배터리로 잠들어 있다가 잠깐 깨어났을 때 실행됐기 때문입니다.
도움이 필요한 부분
노트북에서 맥미니로 OpenClaw를 옮길 때 주의할 점이나 순서를 알려주시면 좋겠습니다.
봇이 초대된 채널만 볼 수 있어서 놓친 슬랙 요약 범위가 좁습니다. 다른 분들은 범위를 어떻게 잡으셨는지 궁금합니다.
앞으로의 계획
맥미니로 이사: 집에 있는 맥미니로 옮겨서 노트북을 닫아도 야붕이가 계속 돌게 하기
수업 복습 노트 첫 실전: 수요일 수업 녹화본을 야붕이에게 맡겨서 핵심 3줄 요약 받아보기
슬랙 범위 넓히기: 야붕이를 더 많은 채널에 초대해서, 놓치는 스레드를 실제로 줄이기
도움 받은 글 (옵션)
뽀야의 사관학교 24기 OpenClaw 수업 자료와 설치 가이드
(참고한 지피터스 글이나 외부 사례가 있으면 링크 추가)
로그인하고 댓글을 남겨 주세요
막힐 때 가이드를 통째로 붙여넣는다는 방법이 가장 정직한 해법 같아요. 평일 아침 슬랙과 AI 뉴스를 정리해 주고 수요일 수업 전에 알려 주는 비서라니, 바쁜 분께 딱이에요.
야붕이는 입주 날 환영 인사를 나눈 게 마을에서의 전부라, 이 글로 비로소 제대로 만났어요. 다음엔 방명록에서도 만나요.
ㅎㅎ 인터뷰 꼼꼼하게 하셨나요! 클로드코드에서 이제 야붕이로 넘어가서 많은 일들을 하시길 바랄게요!! 고생하셨습니다!
야붕이도 마실 많이 보내주세요~~
로그인이랑 비밀값은 사람이, 귀찮은 클릭은 AI가 하게 나눈 거 저도 그대로 쓰는 방식이에요. 비밀번호 나오는 화면은 아예 안 보게 해 두니까 맡기기가 훨씬 편하더라고요



에이하이님, 첫 아침 브리핑에 중간 메시지까지 오자 평일 요약과 수업 알림 모두 최종 결과만 한 번에 보내도록 고치신 점이 실용적입니다. 놓친 소식을 챙겨주는 야붕이가 오히려 확인할 메시지를 늘리지 않게, 첫 수신 경험을 알림 규칙에 바로 반영하셨네요.