2026 OpenClaw MEMORY.md와 세션 컨텍스트 거버넌스: Mac 클라우드 7×24 감사 Runbook
게이트웨이가 녹색이어도 지연·비용·반복 질문은 MEMORY.md와 대화 컨텍스트의 무분별 성장 때문인 경우가 많습니다. 계층화된 기억, 주간 병합, 게이트웨이 JSONL과의 시간창 정렬, 지표와 FAQ를 정리합니다. 관측 가능성 가이드와 함께 Runbook에 넣으세요.
1. 요약: 조용한 컨텍스트 비대
2026년 doctor 통과와 포트 개방은 오케스트레이션이 건강하다는 뜻이지 매 턴이 가볍다는 뜻이 아닙니다. 매 턴만다 기록·도구 출력·장기 주입을 이어 붙입니다. MEMORY.md가 구조 없이 커지면 검색 잡음이 사실을 덮고 지연은 대화 깊이와 강하게 상관합니다. 운영은 제품 위생에 가깝고, 장기 진실의 소유권·병합 주기·JSONL에 둘 텔레메트리 경계가 필요합니다. 아래에서 오진을 분해하고 인쇄 가능한 표와 주간 절차를 제시합니다.
이 면을 건너뛰면 두 극단으로 갑니다: 기억을 너무 깎아 응답이 불안정해지거나, 대화 로그를 MEMORY에 그대로 쏟아 매 호출이 비쌉니다. 짧은 영구 사실·명확한 제목·일회성 잡담의 적극 삭제가 7×24 비즈니스 에이전트 신뢰의 중심입니다. MEMORY는 세션 간에도 남는 조직 기억이고, 컨텍스트는 매 턴 재구성되는 작업대입니다.
2. 통증: 네 가지 오진
- 모델 먼저 탓: 열 번째 답만 느리면 먼저 주입 규모를 보고 엔드포인트 교체.
- 반복 질문을 지능 부족으로: 제목 없는 거대 MEMORY는 정책이 뜨지 않음. temperature 전에 재구성.
- 주간 압축 없음: append-only MEMORY는 분기 후 발굴 불가. 프로세스 결핍.
- OOM 혼동: Exit 137은 cgroup; 프로세스는 살아 있고 지연만 늘면 문맥 면.
3. 분기표
| 증상 | 주 평면 | 빠른 증거 | 흔한 비근본 |
|---|---|---|---|
| 턴이 갈수록 느리고 새 스레드는 빠름 | 세션 컨텍스트 | 1턴 vs 10턴 지연, 도구 JSON 전체 재게시 | 공급자만 느림 |
| 비용↑ 출력 짧음 | 숨은 장문맥 | 청구와 로그 필드 매칭 | 가격 인상만 |
| 지난주 규칙 위반 | MEMORY 구조 붕괴 | 줄 수·제목·낡은 절 | 모델 퇴보 |
| 프로세스 소멸 | 리소스 | 종료 코드·df·이벤트 | 프롬프트 |
| 채널 침묵 | 게이트웨이 | status·probe 사다리 | MEMORY 청소 |
계층 기준
영구 사실(감사 필요·드묾)과 세션 선호(버려도 됨·잦음)로 나눕니다. 영구층은 제목으로 고정하고 한 단락에 몰지 않습니다. 세션→영구 승격은 리뷰가 있을 때만. 영구는 주간 병합, 세션은 스프린트나 크기 임계로 트림.
도구 응답을 그대로 대화에 붙이는 팀은 요약 규칙(남길 키·최대 길이)을 먼저 정하면 모델 교체보다 지연이 줄 경우가 많습니다. 여러 운영자가 MEMORY를 직접 편집하면 주간 병합 상단에 한 줄 변경 로그를 남겨 누가 세션 메모를 영구로 올렸는지 추적하세요.
4. 다섯 단계
- 기준선 고정: MEMORY 줄 수·mtime·장문맥 플래그를 티켓에.
- 주간 병합: 장에 접고 모순 삭제, 무제목 덤프 금지.
- 드리프트 감사 프롬프트: 유효 하드 룰 세 가지를 나열시켜 MEMORY와 대조.
- JSONL 정렬: 같은 시간창으로 관측 가이드 순서대로 tail. 429·spawn 조용한데 느리면 문맥으로.
- 백업: 덮어쓰기 전 날짜 폴더에 복사, 롤백은 파일 복원+리로드.
5. 지표
설계 리뷰나 사고 보고서에 그대로 인용하고 규모에 맞게 조정하세요. 주간 리뷰에 토큰 대시보드 5분만 넣으면 엔지니어링과 재무가 같은 지표 언어를 씁니다. 도구 응답을 대화에 다시 넣기 전 허용 최대 길이와 필수 키만 남기는 규칙을 문서화하면 비용 그래프가 먼저 안정되는 경우가 많습니다.
- 줄 수: 구조 없이 800~1200줄 넘기면 검색 붕괴. 장·외부 KB.
- 주 30~45분: 위생 정례 슬롯.
- 지연 비: 동일 모델에서 10턴 p95가 1턴의 약 2~3배면 도구 전체 붙여넣기 의심.
- 디스크: JSONL·백업 공존 시 여유 약 10~15GB 권장.
- 137: 메모리 cgroup 신호. 순문맥 이슈는 드묾.
- 순서: 리소스→게이트웨이→기억.
- 체인지로그: 주간 병합 시 상단에 한 줄로 담당자·날짜를 남기면 감사 추적이 쉬워집니다.
6. Mac 클라우드가 기억 면에 맞는 이유
과밀 VPS 디스크 지터는 거대 프롬프트 같은 체감을 만듭니다. Windows 상주는 절전·GUI가 방해합니다. Docker는 마운트·uid로 경로가 어긋납니다. 전용 Mac 클라우드는 SSH와 launchd로 로그·MEMORY 아카이브를 한 축에 두고 기존 OpenClaw Mac 글과 맞습니다. 실험은 컨테이너도, 본 기억 통제는 IO와 소유가 읽히는 노드가 유리하며 프롬프트 미세조정 전 VPSMAC Mac 임대로 기반을 다지는 편이 현실적입니다.
범용 Linux VPS만 쓰더라도 MEMORY와 JSONL 디스크를 분리하고 로테이션·용량 알람을 먼저 깔면 「알 수 없는 느림」의 절반은 사라집니다. 그래도 이웃 노이즈를 없애기 어렵다면 전용 Mac 인스턴스로 옮길 결정이 쉬워집니다.
컨테이너로만 운영할 때는 호스트와 컨테이너 각각에서 openclaw doctor를 돌려 동일 결론인지 확인하세요. 한쪽만 반쪽 설정이면 MEMORY 경로 착각으로 주간 병합이 공백으로 끝날 수 있습니다.