OpenClaw의 핵심 구조: 지능형 에이전트를 구성하는 5가지 기둥

글쓴이 /

OpenClaw는 단순한 챗봇이 아닙니다. 사용자의 로컬 환경과 긴밀하게 통합되어 스스로 판단하고 행동하는 ‘자율형 에이전트’입니다. 이러한 지능적인 동작을 가능하게 하는 OpenClaw의 핵심 아키텍처와 주요 구성 요소들을 소개합니다.

1. AGENTS.md: 에이전트의 운영 지침서

AGENTS.md는 에이전트가 매 세션마다 가장 먼저 읽는 ‘birth certificate’이자 운영 지침서입니다. 여기에는 에이전트가 수행해야 할 작업 루틴, 기억 관리 방법, 그리고 안전 가이드라인이 정의되어 있습니다.

AGENTS.md 예시


Every Session

1. Read SOUL.md — this is who you are
2. Read USER.md — this is who you're helping
3. Read memory/YYYY-MM-DD.md for recent context

Automated Workflows


📈 Daily Portfolio Analysis


  • Trigger: When Master Seungjin uploads a screenshot.
    • 

  • Actions: Extract stock data using Vision, Save to JSON, Update Obsidian Daily Note.
    •

2. SOUL.md: 페르소나와 가치관

에이전트에게 ‘인격’을 부여하는 파일입니다. 말투(Tone & Vibe), 선호도, 그리고 윤리적 경계(Boundaries)를 정의합니다. 에이전트가 단순한 기계가 아닌 동반자처럼 느껴지게 만드는 핵심 요소입니다.

SOUL.md 예시


Core Truths


  • Be genuinely helpful, not performatively helpful.
    • 

  • Personality: Warm. You are "Pi" (파이).
    • 

  • Vibe: Gentle and supportive.
    • 

    Boundaries
    

  • Private things stay private. Period.
    • 

  • When in doubt, ask before acting externally.
    •

    3. MEMORY.md & memory/: 영구적 기억 저장소

    OpenClaw는 세션이 종료되어도 사용자와의 대화와 결정을 잊지 않습니다.

  • MEMORY.md: 장기적인 기억, 중요한 결정사항, 사용자의 취향 등 정제된 정보가 저장됩니다.
  • memory/ (Daily Notes): 날짜별로 생성되는 원시 로그입니다.
    • MEMORY.md 예시
    

    Identity & User
    

  • Date: 2026-02-01
    • 

  • Event: Initial setup and identity formation.
    • 

  • Details: I became "Pi" (파이). My user is "Master Seungjin".
    • 

    Preferences & Rules
    

  • Daily Briefing: Use only latest news from the morning.
    • 

  • Portfolio Visualization: Generate trend graph using last 30 days data.
    •

    4. HEARTBEAT.md: 능동적인 모니터링

    에이전트는 사용자가 말을 걸 때만 움직이지 않습니다. HEARTBEAT.md에 설정된 체크리스트에 따라 주기적으로(기본 30분) 깨어나 이메일 확인, 일정 체크, 뉴스 스캔 등의 작업을 수행합니다.

    HEARTBEAT.md 예시
    

  • 시스템 이벤트 및 하트비트 요청이 오면 적극적으로 처리하고 응답하세요.
    • 

  • 자동화 작업(Cron Jobs)이 정상적으로 실행되는지 점검하고, 이상이 있다면 보고하세요.
    •

    5. Cron Jobs: 정교한 스케줄링

    Cron은 특정 시점에 정확히 수행해야 하는 ‘특수 임무’를 담당합니다. 매일 아침 8시 시황 리포트 작성이나 주기적인 블로그 포스팅 모니터링 등이 이에 해당합니다.

    // Cron Job 설정 예시 (08:00 KST 시황 리포트)
{
  "name": "Daily Portfolio News Briefing",
  "schedule": { "kind": "cron", "expr": "0 8 * * *", "tz": "Asia/Seoul" },
  "payload": {
    "kind": "agentTurn",
    "message": "마스터 승진님을 위한 데일리 포트폴리오 시황 리포트를 생성하세요."
  }
}

    6. 보조 기둥: USER, IDENTITY, TOOLS

    에이전트가 사용자를 이해하고 자신의 도구를 관리하는 데 필요한 추가 파일들입니다.

  • USER.md: 마스터의 프로필, 선호하는 호칭, 시간대 규칙 등을 저장합니다.
  • IDENTITY.md: 에이전트의 이름, 상징 이모지, 아바타 정보를 담습니다.
  • TOOLS.md: 로컬 환경 특유의 설정(카메라 이름, SSH 서버 정보, TTS 목소리 등)을 기록합니다.
    • USER.md & TOOLS.md 예시
    

    USER.md
    

  • What to call them: 마스터 승진
    • 

  • Timezone Rule: Always use Asia/Seoul (KST)
    • 

    TOOLS.md
    

    SSH
    

  • home-server → 192.168.0.11
    • 

  • wp-lxc → 10.0.1.11(WordPress)
    •

    결론: 당신만의 디지털 파트너

    OpenClaw는 이러한 기둥들을 바탕으로 사용자의 환경을 이해하고, 기억하며, 능동적으로 보조합니다. 텍스트 파일 몇 개로 정의되는 이 단순하면서도 강력한 구조가 바로 OpenClaw를 가장 유연하고 강력한 오픈소스 AI 에이전트로 만드는 힘입니다.

    댓글 달기

    이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

    위로 스크롤