OpenClaw 패밀리 게이트웨이: 토큰 예산, 메모리 튜닝, 그리고 커스텀 플러그인

설정 및 하드웨어

이 시스템은 CLI 노드로 MacBook Pro(Apple Silicon)를 사용하고, 항상 켜진 게이트웨이로 QNAP TS-253A NAS(Intel Celeron N3150, 8GB RAM)를 사용하며, 장기 메모리를 위해 Cloud Run 인스턴스를 활용합니다. Mac은 Tailscale Serve를 통해 WebSocket으로 QNAP 게이트웨이에 연결됩니다. 게이트웨이 컨테이너는 1.5GB RAM과 2개의 CPU 코어로 실행됩니다. Celeron 프로세서에서 스킬 컴파일을 위한 시작 시간은 약 3분이 소요됩니다.

문제 1: 토큰 팽창

워크스페이스 마크다운 파일이 부풀어 올라 대화가 시작되기 전에 컨텍스트 창을 소모하고 있었습니다. 해결책:

• 엄격한 예산 설정: 최대 9개의 워크스페이스 파일, 총 최대 6,600바이트
• 에이전트 정체성, 권한 규칙, 도구 참조, 메모리 프로토콜을 간결한 파일로 압축: SOUL.md, AGENTS.md, TOOLS.md, MEMORY.md
• 삭제할 수 없는 업스트림 기본 파일을 잘라냄(워크스페이스 동기화로 복원됨) - IDENTITY.md는 636바이트에서 14바이트로 축소
• 15분마다 cron 결과와 시스템 상태를 포함하는 HEARTBEAT.md를 자동 생성, 1,000바이트 미만으로 제한
• autoRecall(에이전트가 요청 시 메모리 검색)과 humanDelay(인위적인 타이핑 지연 없음)를 끔
• 파일 수와 바이트 총량을 강제하는 E2E 테스트 생성, 업데이트 중 팽창 증가를 확인

문제 2: 메모리 시스템 조정

3,000개 이상의 메모리가 축적된 Redis 기반 메모리 시스템(agent-memory-server 0.13.2) 사용.

• 회상 품질: 기본 유사도 임계값(0.2)이 너무 낮았음. 0.3으로 높이고, 7개 범위(가족 정보, 기술, 선호도, 건강, 업무, 미디어, 도구)에 걸친 24개의 테스트 쿼리로 평가 스크립트를 작성하여 임계값을 경험적으로 조정
• 재순위화 계층: 플러그인이 서버에서 3배 초과 인출(최대 45개 결과), 그 후 메타데이터 점수화(중요도 수준, 고정 상태, 시간적 관련성)를 적용한 후 재순위화 및 최종 결과 집합으로 잘라냄
• 상황별 임베딩: 매일 밤 스크립트가 저장 전 메모리에 상황별 컨텍스트(날짜, 소스 유형, 언급된 가족 구성원)를 추가하여 의미론적 검색 개선
• 서버 버그 우회: ?namespace=claw 쿼리 매개변수 없이 PATCH 요청 실패; 서버가 업데이트 시 주제 배열을 파이프로 재결합하여 손상; 엔터티/주제 필터가 RediSearch 스키마 필드 누락으로 500 오류 반환
• 매일 밤 "꿈 주기": 오전 2시 cron 작업이 7단계 메모리 통합 실행: 카탈로그 작성, 중요한 메모리 고정, 관련 사실 상호 참조, 중복 제거, 시간적 패턴 강화, 격차 분석, 건강 보고서 생성
• 주간 큐레이터: 더 깊은 유지보수 처리 - 의미론적 중복 제거, 풍부화, 모순 감지, 오래된 메모리 감소, 평가자-최적화 패턴과 LLM 품질 게이팅을 사용한 조각 통합

문제 3: 맞춤 플러그인

가정 관리용으로 175개 이상의 명령어를 가진 12개의 맞춤 플러그인 구축:

• Spotify: 다중 사용자 가정 음악 제어를 위한 19개 명령어(5개 가족 계정)
• Eero: 메시 네트워크 관리를 위한 41개 명령어 - 장치 제어, 프로필, 자녀 보호 설정
• NextDNS: DNS 필터링, 분석, 자녀 활동 모니터링을 위한 22개 명령어
• Tailscale: 네트워크 장치 관리, ACL, 인증을 위한 21개 명령어

시스템 기능

채널: 사용자별 DM 세션과 격리를 갖춘 Slack 및 Discord. 가족 구성원(10-15세)을 위한 연령에 적합한 콘텐츠 필터링을 포함한 계층적 권한 시스템(관리자/보조/신뢰됨).