이미 Gateway를 돌리는 팀이 막히는 이유는 “모델이 잠들었다”기보다 AGENTS.md, Skills, 부트스트랩 주입이 컨텍스트를 부풀리고 memory_search와 일상적인 memory/*.md가 섞이면서 예측이 어려워지기 때문입니다. 어느 층이 예산을 태우는지 가리기 힘들어집니다. 본 글은 엔지니어링 마찰 여섯 가지, promptMode 대 부트스트랩 매트릭스, 로그에 맞출 수 있는 컨텍스트 지표 세 가지, 최소 AGENTS.md 예시, 여섯 단계 조정 런북을 제공합니다. 멀티플랫폼 설치 가이드, 설치 후 doctor 분류, 프로바이더 라우팅과 페일오버, Docker 네트워크 분류, 채널 설정과 함께 읽습니다. 앞선 글들은 기동하지 않음·연결되지 않음을, 본 글은 돌아가지만 컨텍스트가 통제되지 않음을 다룹니다.
2026년 OpenClaw는 보통 시작 시 저장소 파일 묶음을 주입합니다(예: AGENTS.md, Skills, 정체성과 도구 경계). 메모리는 부트스트랩과 온디맨드 검색으로 나뉩니다. 부트스트랩에 둘 것과 memory_search에 맡길 것에 합의가 없으면 매 턴 거대한 정적 접두가 붙고 도구 체인이 길어지며 비용과 지연이 함께 오릅니다. 아래 여섯 항목을 주간 토큰 추정, 도구 실패율, 평균 턴 수 옆에 둡니다.
minimal 또는 none으로 옮깁니다.memory/*.md에 붙여 넣고 memory_search로 훑으면 IO와 임베딩 비용이 오릅니다. 요약은 저장소 안, 원문은 외부로 둡니다.이 여섯 가지를 Docker 글의 건강한 Gateway 대 모델 계층 실패 구분과 맞추면 컨텍스트 정책 문제인지 네트워크·프로바이더 문제인지 더 빨리 알 수 있습니다.
리뷰에서는 아래 표를 씁니다. 목표는 문장을 예쁘게 하는 것이 아니라 작업 형태별로 예측 가능한 토큰 상한을 두는 것입니다. 정확한 키는 사용 중인 OpenClaw 버전을 따릅니다.
| 차원 | 부트스트랩(시작) | memory_search / memory_get(온디맨드) |
|---|---|---|
| 전형적 내용 | AGENTS.md, 핵심 Skill 요약, 정체성과 도구 경계 | 날짜가 있는 메모, 의사결정 로그, 긴 부록 |
| 실패 모습 | 매 턴이 느리고 비싸며 시끄러운 접두 | 빗나간 적중, 지나치게 넓은 적중, 반복 읽기 |
| 조정 레버 | 총 문자 상한, 단계적 주입, promptMode | 색인 입도, 이름 규칙, 요약 정책 |
| promptMode | full이 가장 많이 주입한다. minimal은 절을 생략할 수 있는 서브에이전트에 적합 | 부트스트랩을 대체하지 않는다. 중요한 경계만 memory에 숨기지 않는다 |
| 협업 | 코드 리뷰와 버전 관리가 필요하다 | 감사 필드(작성자, 만료)가 필요하다 |
| 원격 Mac | 클라우드의 큰 클론에서는 동기 지연과 권한을 주시한다 | 쓰기 변동이 크면 노트북과 경합한다 |
로그와 거친 토큰 추정에서 모읍니다. 수치는 자리 표시자이므로 팀 기준선으로 바꿉니다.
agents.defaults.bootstrapTotalMaxChars 같은 상한(이름은 릴리스마다 다를 수 있음, 공식 문서 준수)을 조입니다.memory_search 결과 중 모델이 실제로 쓴 비율(스팟 체크 또는 재확인)입니다. MRH가 낮으면 색인·요약 부채이고, BEL도 높은데 MRH도 높으면 내용이 중복되었을 수 있습니다.멀티모델 라우팅과 동적 컨텍스트 추정은 2025~2026년에도 계속 바뀌지만, 저장소 쪽 노이즈가 품질 상한을 고정합니다. BEL, TLI, MRH를 보드에 남깁니다.
비개발자에게는 BEL은 “대화마다 다시 읽는 직원 안내책자 분량”, TLI는 “진전 없이 같은 질문이 에스컬레이션되는 횟수”에 비유할 수 있습니다. 그것을 고치지 않고 모델만 키우면 비싼 종이에 같은 두꺼운 책을 인쇄하는 셈입니다.
# AGENTS.md (example: only eternal boundaries; details live in Skills or memory) ## Repository role - This repo is the xxx service; default branch main; release cadence in docs/release.md. ## Tooling boundaries - Do not change CI secrets or production configs without review; DB migrations need two-person sign-off. ## OpenClaw conventions - Skills directory: .openclaw/skills/ (example—use your layout) - Long decisions: memory/YYYY-MM-decisions.md with a one-line summary at the top.
경고: 부트스트랩 텍스트에 고객 이름, 생 시크릿, 편집하지 않은 로그 전문을 넣지 마십시오. 보관이 의무인 경우 범위가 제한된 온디맨드 검색을 사용합니다.
minimal 또는 동등 설정으로 옮기고 전후 지연, 성공률, 비용을 로그한다.간헐적 타임아웃은 모델 교체나 GPU 추가를 부릅니다. BEL과 TLI 없이는 시끄러운 프롬프트와 불안정한 인프라를 섞어 읽습니다. Docker 글대로 Gateway와 채널을 먼저, 그다음 프로바이더, 마지막에 저장소 프롬프트입니다. 채널 글의 분류와 같은 층이며 맨 위에 컨텍스트 예산을 둡니다.
인시던트 티켓마다 최소 재현 네 가지를 붙입니다. (1) 활성 promptMode와 BEL 구간, (2) 최근 AGENTS·Skills 병합 요청 링크, (3) memory_search 쿼리와 적중 수, (4) 도구 호출 인근 Gateway 로그 조각. 서브에이전트나 병렬 작업에는 분기별 상한도 같은 장부에 기록합니다. 메인 세션만 본 집계는 오도합니다.
개인 기기에는 거대한 프롬프트와 임시 시크릿이 전역 설정에 섞여 감사가 어렵습니다. CI나 공유 원격 Mac으로 옮기면 권한과 동기 지연이 더해져 AGENTS와 memory가 보이지 않게 갈라집니다. 명시적 컨텍스트 정책과 전용 원격 환경을 짝지으면 에이전트 워크플로가 검토 가능하고 인수인계 가능한 자산이 됩니다.
일시적 클라우드 데스크톱에서도 OpenClaw는 돌아가지만, 긴 가동 시간, 고정 경로, 낮은 도구체인 드리프트에는 전용 물리 원격 Mac이 유리합니다. Gateway가 큰 모노레포와 같은 호스트나 리전을 공유하고 디스크 IO가 컨텍스트와 함께 병목이 될 때도 마찬가지입니다. MACCOME은 Mac mini M4 및 M4 Pro 노드를 싱가포르, 일본, 한국, 홍콩, 미국 연안에 두고 상시 Gateway와 대규모 클론에 맞는 유연한 대여 조건을 제공합니다. 공개 요금 페이지에서 BEL 행과 맞추고 디렉터리 정책을 고정한 뒤 Skills를 반복합니다.
파일럿에서는 더 큰 모델이나 채널을 늘리기 전에 일주일 동안 BEL을 팀 목표 구간으로 맞춥니다. 저장소 노이즈는 더 큰 모델로 거의 해결되지 않습니다.
자주 묻는 질문
설치 문제부터 보려면 무엇을 먼저 읽나요?
멀티플랫폼 설치 가이드를 읽은 다음 doctor 분류로 이어갑니다. 본 글에서는 포트와 의존성 확인을 반복하지 않습니다.
네트워크와 모델 주제는 어디에 있나요?
CLI 도달성은 Docker 네트워크 분류, 모델 체인은 프로바이더 라우팅을 참고합니다.