임대 원격 Mac에서 RAG를 돌릴 때 Chroma 로컬 벡터 저장소는 OpenClaw와 같은 호스트에 두기 쉽습니다. 운영은 경로 고정·콜드 스냅샷·게이트웨이 헬스·쿼리 데드라인 네 가지로 갈립니다. 아래는 SSH만으로 고정하는 AI 연산 재현 절차입니다. 설치·바인드는 Docker·하드닝 가이드, 스크랩·알림 파이프는 게이트웨이 지표·Prometheus HowTo, 디스크·레이어 IO는 Docker·Podman 캐시 매트릭스와 같이 보세요.
Chroma 지속 디렉터리와 스냅샷 절차
상태는 지속 디렉터리 한 곳에만 쌓이게 하세요. CHROMA_PERSIST_DIRECTORY를 셸·launchd·Docker 바인드·OpenClaw 스킬에 동일하게 넣고, 시스템 루트가 아닌 볼륨에 절대 경로로 둡니다.
콜드 스냅샷: 임베디드 프로세스·chroma 서버를 모두 멈춘 뒤(컬렉션명·모델·버전 메모) 아카이브합니다. 다른 머신 스크래치에서 count() 등으로 검증하고, 로컬 2세대+오프호스트 1본을 유지합니다. 가동 중 복사는 database is locked 위험이 큽니다.
# 경로만 바꿔 사용; Chroma 정지 후 실행
export SRC="$CHROMA_PERSIST_DIRECTORY"
export STAMP=$(date -u +%Y%m%dT%H%M%SZ)
tar -C "$(dirname "$SRC")" -czf "/backup/chroma-${STAMP}.tgz" "$(basename "$SRC")"
shasum -a 256 /backup/chroma-${STAMP}.tgz > /backup/chroma-${STAMP}.tgz.sha256rsync -a --delete 업로드도 동일하게 “쓰기 정지 후”만 적용하세요.
OpenClaw 헬스 프로브와 알림 템플릿
게이트웨이 기본 127.0.0.1:18789에서 /healthz·/readyz를 주기적으로 호출합니다. Prometheus·blackbox 스크랩에 env·instance 라벨을 고정하세요.
curl -fsS http://127.0.0.1:18789/healthz
curl -fsS http://127.0.0.1:18789/readyz알림 템플릿(시작값): /healthz가 연속 2회 비정상이면 다운으로 간주(간격 15~30초). /readyz만 깨지면 의존성·설정을 먼저 봅니다. Chroma 볼륨 여유는 node_exporter·df 등으로 노출하고, 대략 20GB 미만 경고·5GB 미만 치명(튜닝) 또는 유입률로 2시간 내 소진 치명을 겁니다. 서버 모드 Chroma만 별도 TCP/HTTP 프로브를 붙입니다. 주석에 토큰 교체·디스크·tar 롤백 런북 URL을 넣으세요.
쿼리 타임아웃·회로 차단 파라미터
collection.query·chroma run HTTP 호출에 가장 안쪽 데드라인을 둡니다. 대화형 top-k는 4~8초, 배치만 크리티컬 패스 밖이면 15~30초, 동시 쿼리는 프로세스당 2~4개 상한부터 시작하세요.
5분 창에서 연속 3회 타임아웃·5xx면 30~120초 퓨즈를 열고 디그레이드 응답을 반환하며 error_class=chroma_breaker_open을 로그에 남깁니다. 스킬 매니페스트에 숫자를 적어 두면 온콜이 튜닝과 장애를 구분합니다.
# asyncio 예시(개념)
import asyncio
async def query_with_cap(coro, seconds=6.0):
return await asyncio.wait_for(coro, timeout=seconds)동기 스택은 httpx.Client(timeout=6.0) 등으로 동일 계약을 만듭니다.
권한·경로 오류 FAQ
PermissionError·복제 후 경로: sudo chown -R $USER:staff "$CHROMA_PERSIST_DIRECTORY" 또는 mkdir -p 후 rsync -a 이전.
database is locked: 동일 경로 다중 프로세스 또는 쓰기 중 백업. 전부 중지·lsof 확인 후 단일 소유자만 기동.
경로·컨테이너: plist·Compose는 절대 경로만; APFS 대소문자·Docker 바인드 선존재를 런북에 적습니다.
정리
전용 볼륨·정지 스냅샷·헬스 프로브·디스크 알림·쿼리 퓨즈를 묶으면 임대 Mac에서도 Chroma+RAG가 조용히 굴러갑니다. 공개 가격·구매·도움말 페이지는 로그인 없이 열람할 수 있습니다.