[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가 하게 나눈 거 저도 그대로 쓰는 방식이에요. 비밀번호 나오는 화면은 아예 안 보게 해 두니까 맡기기가 훨씬 편하더라고요