OpenClaw의 4계층 설계 철학: 단일 프로세스 게이트웨이부터 Markdown 메모리 시스템까지
OpenClaw는 단일 프로세스 게이트웨이, ReAct 추론 루프, Markdown 기반 이중 계층 메모리의 4계층 구조로 설계된 개인용 AI 어시스턴트 런타임이다. 마이크로서비스의 불필요한 복잡성을 제거하고, 다단계 추론 자동화와 세션 간 컨텍스트 유지를 동시에 구현함으로써, 복잡한 인프라 없이도 사용자가 직접 설치하고 체험할 수 있는 에이전트 환경을 제공한다.
단일 프로세스 게이트웨이 아키텍처의 설계 의도
전통적인 마이크로서비스 아키텍처는 메시지 라우팅, 인증, 플러그인 관리를 별도의 서비스로 분할하는 경향이 있다. 그러나 개인용 AI 어시스턴트에서는 그러한 분해가 가져오는 복잡성이 그 이점을 크게 상쇄시킨다. OpenClaw의 Gateway는 모든 기능을 하나의 Node.js 프로세스로 통합한다. 메시지 수신 및 라우팅, WebSocket 연결 관리, 세션 상태 유지, 플러그인 생명주기 관리 등 모든 작업이 단일 프로세스 내에서 이루어짐으로써 내부 호출의 오버헤드가 제로에 가깝고, 배포가 단순해지며, 상태 일관성이 자연스럽게 유지된다.
ReAct 추론 루프의 다단계 자동화 메커니즘
ReAct는 Reasoning과 Acting을 결합한 핵심 실행 모드로, AI가 도구 호출이 필요할 때 사용자 메시지에서 LLM 사고, 도구 호출 결정, 실행, 결과 수신, 다시 LLM 사고의 반복 루프에 진입한다. 이 구조는 웹 검색, 파일 읽기, 명령어 실행, 종합 답변 생성을 순차적으로 연결하는 다단계 추론을 가능하게 한다. 각 단계의 출력이 다음 단계의 입력으로 직접 연결되므로 적응적 실행과 오류 복구가 실시간으로 이루어지며, 복잡한 작업도 사용자에게 단일 답변として 제공한다.
Markdown 기반 이중 계층 메모리 시스템의 동작 원리
OpenClaw는 데이터베이스나 키-값 저장소 대신 평문 Markdown 파일을 메모리 저장소로 선택했다. 장기 메모리인 MEMORY.md는 사용자 선호도, 핵심 결정 사항, 지속적 지식을 보관하며, 일일 메모리인 memory/YYYY-MM-DD.md는 각 날짜의 대화 요약과 이벤트 로그를 기록한다. Markdown을 선택한 이유는 명확하다. 인간이 직접 읽고 편집할 수 있는 형식이라는 점, Git으로 모든 변경 사항을 추적할 수 있다는 점, 외부 의존성 없이 평문만으로 작동한다는 점, 그리고 LLMs가 Markdown을 자연스럽게 처리할 수 있다는 점이다.
경험 우선 철학과 에이전트 런타임의 연결 고리
OpenClaw의 경험 우선 철학은 이론적 완벽함보다 실제 사용자의 경험과 행동을 최우선으로 삼는 디자인 접근법이다. 에이전트가 24시간 7일 작동하며 사용자의 일상 Naturally 통합되는 것을 목표로 하며, 사용자가 오픈소스 플랫폼을 직접 설치하고 체험해 보는 과정 자체가 기술 이해의 필수 단계임을 강조한다. 단일 프로세스 게이트웨이의 단순한 배포 구조와 Markdown 메모리의 버전 관리 가능성이 결합되어, 복잡한 인프라 환경 없이도 개인 사용자가 즉석에서 AI 어시스턴트를 체험하고 자신의 워크플로에 맞게 커스터마이즈할 수 있는 환경이 만들어진다.