다중 에이전트 메모리: 오픈소스 공유 메모리 시스템 (4가지 유형)

Multi-Agent Memory는 머신, 도구, 프레임워크 간에 작동하는 공유 메모리 시스템을 AI 에이전트에게 제공하는 오픈소스 프로젝트입니다. 이 프로젝트는 OpenClaw 에이전트, Claude Code, n8n 워크플로우가 별도의 머신 간에 메모리를 공유해야 하는 프로덕션 환경에서 탄생했습니다.

해결하는 문제

개발을 위한 Claude Code, 자율 작업을 위한 OpenClaw, 자동화를 위한 n8n과 같은 여러 AI 에이전트를 실행할 때, 각 에이전트는 자체 컨텍스트를 유지하며 세션 간에 모든 것을 잊어버립니다. 기존 솔루션은 단일 머신에서만 작동하거나, 유료 클라우드 서비스가 필요하거나, 사실과 이벤트가 근본적으로 다르다는 점을 이해하지 못한 채 메모리를 단순한 키-값 저장소로 취급합니다.

변형 의미론을 가진 유형화된 메모리

이 시스템은 네 가지 고유한 메모리 유형을 이해하며, 각각 고유한 생명주기를 가집니다:

이벤트: 추가 전용, 불변의 역사적 기록. 사용 사례: "배포 완료", "워크플로우 실패"
사실: 키별로 업서트, 새로운 사실이 이전 사실을 대체합니다. 사용 사례: "API 상태: 정상", "클라이언트는 다크 모드를 선호함"
상태: 주제별로 제자리 업데이트, 최신 상태가 우선합니다. 사용 사례: "빌드-파이프라인: 통과", "마이그레이션: 진행 중"
결정: 추가 전용, 선택과 추론을 기록합니다. 사용 사례: "MySQL 대신 Postgres를 선택한 이유는..."

메모리 생명주기

시스템은 다음 프로세스를 따릅니다: 저장 → 중복 확인 → 대체 체인 → 신뢰도 감소 → LLM 통합

중복 제거: 저장 시 콘텐츠가 해시 처리되며, 정확한 중복은 기존 메모리를 반환합니다
대체: 기존 사실과 동일한 키를 가진 사실을 저장할 때, 이전 사실은 비활성으로 표시되고 새로운 사실은 이전 사실로 연결됩니다
신뢰도 감소: 사실과 상태는 접근되지 않으면 시간이 지남에 따라 신뢰도를 잃습니다(구성 가능, 기본값 2%/일). 이벤트와 결정은 감소하지 않습니다
LLM 통합: 주기적인 백그라운드 프로세스(구성 가능, 기본값 6시간마다)가 통합되지 않은 메모리를 LLM으로 전송하여 병합할 중복 항목을 찾고, 플래그할 모순, 메모리 간 연결, 교차 메모리 통찰력을 발견합니다

보안 기능

자격 증명 제거: 모든 콘텐츠는 저장 전에 제거됩니다. API 키, JWT, SSH 개인 키, 비밀번호, base64로 인코딩된 비밀은 자동으로 편집됩니다
에이전트 격리: API는 에이전트와 데이터 사이의 게이트키퍼 역할을 합니다. 에이전트는 메모리를 저장하고 검색하며, 브리핑과 통계를 읽을 수 있습니다. 메모리를 삭제하거나, 테이블을 삭제하거나, 자격 증명 제거를 우회하거나, 파일시스템/데이터베이스에 직접 접근하거나, 다른 에이전트의 메모리를 소급하여 수정할 수 없습니다
보안 구현: cr****.timingSafeEqual()을 사용한 타이밍 안전 인증, 환경 변수를 요구하는 시작 시 검증, 저장 전 자격 증명 제거