워크스페이스와 메모리 개요

OpenClaw의 데이터 저장 및 컨텍스트 관리 기능을 활용하세요.

핵심 개념

워크스페이스

데이터가 저장되는 물리적 위치:

메모리 시스템

대화 컨텍스트를 유지하는 방법:

• 세션 메모리: DM은 에이전트 메인 세션 공유, 그룹은 격리
• 장기 메모리: 세션 종료 후에도 보존되는 정보

워크스페이스 위치

# 기본 위치
~/.openclaw/workspace

# 파일 구조
workspace/
├── sessions/       # 세션 데이터
├── agents/         # 에이전트 설정
├── skills/         # 커스텀 스킬
└── memory/         # QMD 메모리

메모리 설정

{
  "memory": {
    "enabled": true,
    "maxMessages": 100,
    "maxSessions": 50
  }
}

세션 관리

{
  "sessions": {
    "dmScope": "main",
    "historyLimit": 50,
    "dmHistoryLimit": 100
  }
}

메모리 제한

{
  "memory": {
    "maxMessages": 200,
    "maxSessions": 100,
    "retentionDays": 30
  }
}

트러블슈팅

메모리가 누락됨

원인: 세션 제한 도달

{
  "memory": {
    "maxSessions": 200
  }
}

과거 대화를 기억하지 못함

원인: maxMessages 제한

• 제한 늘리기: maxMessages 값 증가
• 또는 중요한 정보를 QMD 메모리로 저장

자주 묻는 질문

Q: 워크스페이스를 다른 위치로 옮길 수 있나요?

네. OPENCLAW_WORKSPACE 환경 변수로 설정 가능합니다.

Q: 메모리는 얼마나 오래 유지되나요?

기본적으로 무제한이지만, retentionDays로 자동 삭제를 설정할 수 있습니다.

Q: 여러 기계에서 워크스페이스를 공유할 수 있나요?

네. 워크스페이스를 Git이나 동기화 도구로 공유하세요.

참고:

• 공식 문서: Workspace