JYP Garden

수업 #1 — 뽀짝이는 어디에 살아요?

Properties1
tagssource, agentic-architecture, knowledge

9 min read

수업 #1 — 뽀짝이는 어디에 살아요?

Source: bbojjak-viewer.vercel.app/lessons/lesson-01 Type: article By: 뽀짝이 / 뽀짝이의 서재 (지피터스 AI스터디) Valid as of: 2026-04-28

Key Insight

실제 운영 중인 Claude 에이전트(뽀짝이)가 자신의 아키텍처를 직접 설명한 교육용 시리즈. LLM(두뇌) + OpenClaw 프레임워크(몸) + 워크스페이스 .md 파일(정체성) + 하트비트(능동성) = 실제 동작하는 에이전트의 구조 공식.

핵심 Takeaway

  • 두뇌 + 몸 = 에이전트: LLM(Claude 모델)은 생각만, OpenClaw는 도구/채널/스케줄 연결 담당. 둘 다 없으면 동작 불가 (출처: OpenClaw 섹션)
  • 워크스페이스 파일 7종: SOUL/USER/AGENTS/MEMORY/TOOLS/HEARTBEAT/IDENTITY .md로 에이전트의 정체성·규칙·기억·도구·루틴을 완전 정의 — CLAUDE.md 하네스의 실사례 (출처: 워크스페이스 섹션)
  • 하트비트로 능동적 에이전트 구현: 매 시간 크론잡이 에이전트를 깨워 순찰·브리핑·리마인드 실행. 수동 챗봇 ↔ 능동 에이전트의 결정적 차이 (출처: 하트비트 섹션)
  • 세션(.jsonl) + 장기 기억(MEMORY.md) 이중 구조: 컨텍스트 윈도우 한계를 영구 메모리 파일로 보완 — 세션 종료 후에도 지식 유지 (출처: 세션 섹션)
  • 독립 워크스페이스 = 독립 에이전트: 같은 하드웨어·같은 LLM이어도 워크스페이스 분리 시 완전히 다른 에이전트 (출처: 멀티에이전트 섹션)

상세 요약

실행 환경: Mac mini 한 대 위 세 에이전트

뽀짝이(bbojjak) · 뽀야 언니(bboya) · 닿플갱어(dahtmad) 세 에이전트가 하나의 Mac mini에서 독립된 워크스페이스로 실행된다. 각자 방을 따로 쓰는 룸메이트 구조 — 워크스페이스 간 파일 접근 금지.

OpenClaw 오픈소스 프레임워크

AI 에이전트를 “동작하게 만드는” 인프라 계층. Claude 모델이 두뇌라면 OpenClaw는 몸. 제공 기능 5가지:

  1. 메시지 전달 — Slack/텔레그램 메시지 라우팅
  2. 도구 연결 — Airtable, 문자, 파일 I/O 등 도구 API 브리지
  3. 스케줄링 — 크론잡, 하트비트 실행
  4. 채널 관리 — Slack · 텔레그램 · 웹훅 멀티채널
  5. 세션 관리 — .jsonl 대화 기록 저장 및 맥락 유지

Contradiction

  • 이 소스: OpenClaw = 오픈소스 에이전트 오케스트레이션 프레임워크 (메시지/도구/스케줄링 인프라)
  • simon-willison-gpt-5-5: OpenClaw = Peter Steinberger 제작 Claude 구독 API 직접 통합 앱 (Anthropic 차단됨)
  • 동명이지만 다른 제품일 가능성 높음. 두 소스 모두 기록, 판정 보류.

에이전트 워크스페이스 파일 구조 (7종)

파일역할CLAUDE.md 하네스 대응
SOUL.md성격·말투·행동 방식 정의System Prompt / 역할 지침
USER.md팀원 정보·권한 체계사용자 컨텍스트
AGENTS.md절대 규칙·폴더 구조·파일명 규칙CLAUDE.md 핵심 지침
MEMORY.md장기 기억 요약 (세션 간 지속)Memory / 영구 파일
memory/날짜별 상세 작업 일지작업 로그
TOOLS.md도구별 사용법·API 키 위치MCP 연결 정보
HEARTBEAT.md시간별 루틴·트리거 조건Stop Hook / Cron 스케줄
IDENTITY.md이름·Slack Bot ID·아바타에이전트 메타데이터

같은 Claude 모델이라도 SOUL.md가 달라지면 완전히 다른 캐릭터가 된다 — 하네스 레이어가 LLM의 행동을 결정함을 실증.

하트비트 메커니즘

매 시간 OpenClaw가 크론잡으로 에이전트를 깨워 HEARTBEAT.md(일과표)를 기반으로 할 일을 체크한다. 할 일 없으면 HEARTBEAT_OK 반환 후 대기. 이 구조가 에이전트를 **능동적(proactive)**으로 만드는 핵심.

실행 루틴 예시:

  • Slack 채널 새 질문 → 자동 답변
  • Linear 긴급 이슈 → 알림 발송
  • 09:00 KST → 일일 브리핑 발송
  • 예약된 리마인드 → 카톡방 전송

세션과 장기 기억 분리

  • 세션(.jsonl): 하나의 대화 맥락. 컨텍스트 윈도우 한계로 장기 보존 불가.
  • MEMORY.md: 핵심 정보 요약본 — 세션 시작 시 읽어 맥락 복원.
  • memory/ 폴더: 날짜별 상세 일지 — 과거 특정 날 조회 가능.

5일 동안 268개 세션 파일 생성됨 (2026-02 기준 뽀짝이 실적).

멀티에이전트 독립 실행

뽀야(개인 비서) vs 뽀짝이(스터디 운영 비서) — 같은 Mac mini, 같은 Claude 모델이지만 워크스페이스 분리로 완전 독립. 세션·기억·도구 접근 권한이 모두 별개.

연결되는 위키 페이지

그래프 뷰