워크스페이스 모범 사례

워크스페이스와 메모리 시스템을 효율적으로 조직하고 유지보수하는 방법을 알아봅니다.

디렉토리 조직 전략

추천 구조

~/.openclaw/workspace/
├── sessions/              # 세션별 작업 공간
│   └── {sessionId}/
│       ├── input/         # 입력 파일
│       ├── output/        # 생성된 결과물
│       └── temp/          # 임시 파일
│
├── projects/              # 장기 프로젝트
│   ├── project-alpha/
│   │   ├── data/
│   │   ├── scripts/
│   │   └── results/
│   └── project-beta/
│
├── resources/             # 재사용 리소스
│   ├── templates/
│   ├── datasets/
│   └── configs/
│
├── persistent/            # 영구 저장
│   └── user-preferences.json
│
└── archive/               # 오래된 프로젝트 보관
    └── 2025/

파일 명명 규칙

좋은 예시:

data-analysis-2026-02-23.json
script-data-loader-v1.0.0.py
report-monthly-summary-q1.pdf
config-production-db.json

나쁜 예시:

data.json               # 무슨 데이터?
file1.txt               # 용도 불명
final_final_v3.json     # 버전 관리 실패
CODE.js                 # 대문자 사용

프로젝트 구조

projects/{project-name}/
├── README.md                   # 프로젝트 개요
├── data/
│   ├── raw/                   # 원본 데이터 (읽기 전용)
│   ├── processed/             # 처리된 데이터
│   └── external/              # 외부 데이터 참조
├── scripts/                    # 스크립트
├── results/                    # 결과물
│   ├── figures/
│   └── reports/
└── archive/                    # 구버전 보관

프로젝트 설정 파일:

{
  "name": "customer-churn-analysis",
  "version": "1.0.0",
  "description": "고객 이탈률 분석 및 예측",
  "createdAt": "2026-01-15",
  "tags": ["ml", "analytics", "customer"]
}

메모리 관리 전략

메모리 카테고리

메모리 태그 시스템

!work          # 업무 관련
!personal      # 개인용
!project-{name} # 프로젝트별
!important     # 중요 (삭제 불가)
!temp          # 임시 (자동 정리 대상)
!code          # 코드 스니펫
!reference     # 참조 자료

메모리 정리 일정

sessions:
  memory:
    cleanup:
      schedule: "0 3 * * 0"  # 매주 일요일 새벽 3시

      rules:
        - tag: "temp"
          action: "delete"
          ageDays: 7

        - tag: "project-*"
          action: "archive"
          ageDays: 90

        - accessCount: 0
          action: "review"
          ageDays: 30

모범 사례 체크리스트

워크스페이스 조직

• 명확한 디렉토리 구조 유지
• 일관된 파일 명명 규칙 사용
• README.md로 프로젝트 문서화
• 3개월 이상 된 프로젝트 아카이빙
• 100MB 이상 파일은 별도 저장소

메모리 관리

• 중요한 정보는 !important 태그
• 임시 데이터는 !temp 태그
• 매주 메모리 정리 실행
• 민감한 정보는 저장하지 않음
• 프로젝트 종료 시 관련 메모리 정리

보안

• API 키, 비밀번호는 워크스페이스에 저장 금지
• 개인정보 포함 파일은 암호화
• 불필요한 파일은 정기적 삭제
• 백업은 안전한 외부 저장소에 보관

문제 해결

워크스페이스가 꽉 찼을 때

openclaw workspace stats
find ~/.openclaw/workspace -type f -size +100M
openclaw workspace clean --dry-run
openclaw workspace clean

메모리 검색이 느릴 때

openclaw memory list --count
openclaw memory archive --before "2026-01-01"
openclaw memory cleanup --threshold 0.3

참고:

• 공식 문서: Best Practices