faq

OpenClaw 첫 사용자를 위한 7가지 필수 질문

핵심 요약

OpenClaw는 세션 기반 자동화 플랫폼으로, 메모리 관리와 heartbeat·cron을 통해 개발 작업을 효율적으로 수행하도록 설계되었습니다.

세션 기반 아키텍처와 핵심 개념

OpenClaw는 개별 스크립트가 아닌 세션 기반의 장시간 실행 가능한 워크플로우를 제공합니다. 이 아키텍처는 MEMORY.md와 heartbeat·cron을 통해 지속적인 메모리·상태 관리가 이루어지며, concept_ids와 claim_ids가 서로 연결된 관계망을 형성합니다. 모든 개념은 최소 한 개 이상의 다른 개념과 연결되어야 하며, 이는 데이터베이스 관계의 무결성을 보장합니다.

두 계층 메모리 구조

OpenClaw는 장기 기억을 MEMORY.md에 정리하고, 일일 로그를 memory/YYYY-MM-DD.md에 원문에 가깝게 기록합니다. 필요할 때는 memory_search로 조회하고, memory_get으로 필요한 조각만 정확히 읽어옵니다. 이 구조により, 중요한 결정과 설정은 curated된 파일에 저장되고, 일상적인 사건은 별도 로그에 보관됩니다.

자동화 체크리스트와 API 보안 전략

heartbeat는 메일·캘린더·날씨 등 정기적인 체크리스트를 30분 주기로 수행할 때 사용하고, cron은 특정 시간에 한 번 실행되는 리마인더나 보고서 생성 등에 활용됩니다. 외부 API 호출 시에는 과도한 반복을 방지하기 위해 배치 처리를 하고, 429 에러 발생 시 Retry-After를 준수하며, API 키는 .env 파일에 저장해 코드에 평문으로 넣지 않습니다.

자주 묻는 질문

OpenClaw에서 heartbeat와 cron의 차이는 무엇인가요?

heartbeat는 정기적인 체크리스트(메일·캘린더·날씨 등)를 30분 주기로 수행하고, cron은 특정 시간에 한 번 실행되는 리마인더나 보고서 생성 등에 사용됩니다.

BOOTSTRAP.md 파일을 삭제해야 하는 이유는 무엇인가요?

BOOTSTRAP.md는 초기 설정 단계용 파일이며, 설정이 완료되면 삭제하여 이후 SOUL.md·USER.md·MEMORY.md로 메모리를 관리합니다.

API 호출 시 429 오류가 발생하면 어떻게 처리하나요?

과도한 반복을 방지하기 위해 배치 처리를 하고, 429 에러 시 Retry-After를 준수하며, API 키는 .env 파일에 저장해 평문으로 코드에 넣지 않습니다.