OpenClaw-Mem0 플러그인, 컨텍스트 창 외부에 지속적 메모리 추가

openclaw-mem0 플러그인은 메모리를 컨텍스트 창 외부에 저장함으로써 OpenClaw의 기본 메모리 제한을 해결합니다. 이를 통해 컨텍스트 압축, 토큰 제한, 세션 재시작의 영향을 받지 않게 됩니다.

OpenClaw의 메모리 문제

OpenClaw 에이전트는 세션 간에 상태를 유지하지 않으며, 기본 메모리는 명시적으로 로드해야 하는 파일에 저장됩니다. 컨텍스트 압축은 토큰을 절약하기 위해 이전 컨텍스트를 요약하여, 주입된 메모리가 손실되게 만듭니다. 큰 메모리 파일과 학습된 사실들은 경고 없이 압축, 재작성 또는 삭제됩니다.

포괄적인 MEMORY.md 파일, 로컬 BM25 + 벡터 검색 엔진, SQLite 기반 세션 로그와 같은 커뮤니티 해결책들은 모두 동일한 한계를 공유합니다: 메모리를 컨텍스트 창 내부에 저장하여 압축이나 세션 재시작에 취약하게 만듭니다.

플러그인 작동 방식

이 플러그인은 모든 대화 턴에서 두 가지 프로세스를 실행합니다:

• 자동 회상: 에이전트가 응답하기 전에 Mem0에서 관련 메모리를 검색하여, 매 턴마다 일치하는 컨텍스트(선호도, 과거 결정, 프로젝트 세부사항)를 작업 컨텍스트에 주입합니다.
• 자동 캡처: 에이전트가 응답한 후 각 교환을 Mem0으로 전송하며, Mem0의 추출 계층이 지속할 가치가 있는 내용을 결정합니다. 새로운 사실은 저장되고, 오래된 것은 업데이트되며, 중복 항목은 병합됩니다.

두 프로세스 모두 설치 시 기본적으로 활성화됩니다.

메모리 구조

플러그인은 메모리를 두 가지 범위로 구분합니다:

• 장기 메모리: 사용자 범위, 모든 세션에 걸쳐 지속됨(이름, 기술 스택, 프로젝트 구조, 결정 사항)
• 단기 메모리: 세션 범위, 장기 저장소를 오염시키지 않으면서 활성 작업을 추적합니다.

두 범위 모두 매 회상 시 검색되며, 장기 메모리가 먼저 표면화됩니다.

에이전트는 명시적 메모리 관리를 위한 다섯 가지 도구를 얻습니다:

• memory_search - 모든 메모리에 대한 의미론적 쿼리
• memory_store - 특정 사실을 명시적으로 저장
• memory_list - 저장된 모든 메모리 보기
• memory_get - ID로 특정 메모리 검색
• memory_forget - 메모리 삭제(GDPR 준수)

설정 옵션

클라우드 설정 (가장 쉬움):

openclaw plugins install @mem0/openclaw-mem0

app.mem0.ai에서 API 키를 받은 후 openclaw.json에 추가하세요:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "apiKey": "${MEM0_API_KEY}",
      "userId": "your-user-id"
    }
  }
}

완전 로컬, 완전 비공개 (셀프 호스팅):

"mode": "open-source"를 설정하고 자신의 스택을 가져오세요:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "mode": "open-source",
      "userId": "your-user-id",
      "oss": {
        "embedder": {
          "provider": "ollama",
          "config": {
            "model": "nomic-embed-text"
          }
        },
        "vectorStore": {
          "provider": "qdrant",
          "config": {
            "host": "localhost",
            "port": 6333
          }
        }
      }
    }
  }
}