JYP Garden

수업 #7 — 터미널에서도 되는 거 아냐?

Properties1
tagssource, agentic-architecture, harness-engineering, knowledge

8 min read

수업 #7 — 터미널에서도 되는 거 아냐?

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

Key Insight

“같은 엔진(Claude API), 다른 차체” — 터미널 Claude Code와 OpenClaw의 본질적 차이는 API 위에 얹힌 레이어다. 시스템 프롬프트 자동 조립 + 확장 도구 + 하트비트/크론잡 + 채널 라우팅이 “도구”와 “자율 에이전트”를 가르는 4가지 레이어다.

핵심 Takeaway

  • 같은 엔진, 다른 차체: 터미널 Claude Code와 OpenClaw 모두 Claude API를 사용하지만, OpenClaw는 그 위에 시스템 프롬프트 자동 조립·세션 관리·확장 도구·하트비트/크론잡·채널 라우팅 레이어를 추가. “F1 레이싱카 vs 자율주행 택시” (출처: “오픈클로는 클코를 감싸는 건가?” 섹션)
  • 시스템 프롬프트 자동 로딩 — 1개 vs 6개: 터미널은 CLAUDE.md 1개만 자동 로드, 나머지 수동 요청 필요. OpenClaw는 SOUL/AGENTS/TOOLS/USER/IDENTITY/HEARTBEAT 6개를 매 대화마다 자동 주입 → 규칙 영구 적용, 절대 안 까먹음 (출처: “시스템 프롬프트 1개 vs 6개” 섹션)
  • 확장 도구 = 로컬 vs 외부 연결: 터미널은 파일/터미널/브라우저(로컬). OpenClaw는 message(Slack/카톡/이메일), web_search, sessions_spawn, sessions_send, nodes 추가. “도구”(사람이 지시)와 “자동화 에이전트”(조건 만족 시 알아서)의 차이 (출처: “도구” 섹션)
  • “시키면 함” vs “알아서 함”: 터미널은 사람 명령 시에만 실행. OpenClaw는 하트비트(매시간 자동 체크) + 크론잡(정해진 시각 자동 실행)으로 집사가 자도 동작 (출처: “하트비트와 크론잡” 섹션)
  • 멀티유저 vs 1인 독점: 터미널은 한 명만 사용. OpenClaw는 팀 전원이 각자 채널/DM에서 동시 사용 가능 (채널별 세션 분리로 컨텍스트 충돌 없음) (출처: “멀티유저” 섹션)

상세 요약

OpenClaw 아키텍처 레이어

Claude API (Anthropic)
   ↓
OpenClaw 에이전트 런타임
   ├─ 시스템 프롬프트 자동 조립 (6개 파일)
   ├─ 세션 관리 및 컴팩션
   ├─ 확장 도구 연결
   ├─ 하트비트/크론잡 스케줄러
   └─ 채널 라우팅
   ↓
워크스페이스 파일들
   ↓
외부 연결 (Slack, 텔레그램, 카카오톡, ...)

6개 자동 로딩 파일 상세

파일역할
SOUL.md성격, 말투, 정체성
AGENTS.md업무 규칙, 20개+ 절대 규칙
TOOLS.md도구 사용법, 접근 권한
USER.md팀원 정보
IDENTITY.md고양이 정체성 메타데이터
HEARTBEAT.md자동 점검 루틴

※ MEMORY.md는 세션 시작 시 에이전트가 직접 읽음 (장기 기억, 항상 필요)

이 6개 파일이 자동 주입되므로 터미널처럼 “AGENTS.md 읽어줘” 등을 매번 수동 요청할 필요가 없다. 절대 규칙이 20개+가 되어도 모든 대화에 항상 적용된다.

같은 스크립트, 다른 의미

터미널: claude send_message.sh → 사람이 "지금 이 사람한테 이 내용 보내줘"
OpenClaw: conditions → agent_judgment → message tool → 자동 발송

스크립트(도구)는 같지만, 누가 언제 왜 실행하는지가 다르다. 전자는 “도구”, 후자는 “자동화 에이전트”.

상황별 선택 가이드

선택상황
터미널 Claude Code일회성·탐색·복잡한 코딩·개인 작업
OpenClaw반복 자동화·팀 운영·24시간 감시·외부 채널·장기 기억

연결되는 위키 페이지

그래프 뷰