통증: 잊은 것은 모델이 아니라 참조 설계다
구두 런북. 절차가 채팅에 흩어지면 매 세션 재발명되어 버전된 진실과 충돌합니다.
긴 스레드 드리프트. CONTEXT가 없으면 요약이 경계를 떨어뜨려 기억 상실처럼 보입니다. 원인은 대개 컨텍스트 설계입니다.
JSON 변경이 안 보임. 탐색·전송은 캐시됩니다. 오래된 자식이 새 설정을 가립니다.
조용한 채널. 먼저 페어링을 의심하고 Skills 문구 조정은 뒤로 둡니다.
Skills와 권한 혼동. Skills는 의도이고 workspaceAccess가 실제 읽기·쓰기입니다.
검색·스폰. web_search의 아웃바운드와 allowAgents 남용은 비용·드리프트를 키웁니다.
운영 품질. PATH 전제, 다국어 혼합, 링크 부패, 느린 공유 마운트, 리뷰 없는 형식적 도입이 반복됩니다.
최소 권한 너머에서 Skills·CONTEXT가 더하는 것
최소 권한은 디렉터리를 정하고 Skills는 벽 안의 어휘·순서를 정하며 CONTEXT는 짧은 사실·승인 URL을 실어 나릅니다.
탐색은 감사 가능하게 두고 공개면과 같은 리뷰 문화에 올립니다. CONTEXT 해시는 이미지와 함께 롤백합니다.
교육은 적중·미스 데모로, 보안은 Skills와 workspace를 같은 티켓에서 봅니다. 모델 업데이트 시 도구 이름 의존을 회귀하고, 연습으로 깨고 복구하는 근육을 만듭니다.
측정 가능한 기준
CONTEXT 재질문률, Skills 실패 분류, 재시작·티켓 대응, 첫 응답 지연, HITL 비율, 분기 샘플 감사, 스캔 CPU, skill-not-found·배포 상관, 복구 시간, 좋은 사례 로그를 묶습니다.
톤을 고객 대면 문구와 맞춰 요약 오역을 줄이고, 탐색 비용이 선형이면 glob 깊이를 의심합니다.
판단 표
| 모드 | 적합 | 이점 | 리스크 |
|---|---|---|---|
| 거대 시스템 프롬프트 | 개인 실험 | 빠름 | 리뷰 불가 드리프트 |
| Skills만 | 도구 중심 봇 | 탐색 쉬움 | 경계 텍스트 약함 |
| Skills+CONTEXT | 팀 프로덕션 | 버전된 명료함 | 규약 필요 |
| doctor 계단까지 | 상시 원격 Mac | 재현성 | 두꺼운 런북 |
기본 행을 하나 정하고 접두어로 환경을 나누며, 사고에서 빠진 플레이북은 Skill·티켓으로 닫습니다. 예산이 문서를 멈추면 낡은 지시가 증폭됩니다.
절차와 JSON 뼈대 예
{
"workspaceAccess": { "root": "/var/openclaw/work/acme" },
"skills": {
"searchPaths": ["/var/openclaw/skills/team", "/var/openclaw/skills/shared"],
"manifest": "/var/openclaw/skills/manifest.json"
},
"contextFiles": [
"/var/openclaw/context/PROJECT.md",
"/var/openclaw/context/BOUNDARIES.md"
]
}
키 이름은 바뀔 수 있어 구조 예시입니다. (1) 디렉터리 템플릿 (2) 스테이징에서 openclaw doctor (3) 콜드 재시작 후 도구 목록 (4) 허용·금지 합성 대화 (5) rsync/SFTP로 원격 Mac 복제 (6) CI에서 매니페스트 검증 (7) 읽기 전용 미러 (8) 카나리아 CONTEXT (9) 실험 Skills 플래그 (10) 폐기는 날짜 아카이브. 롤백 리허설·테넌트별 CONTEXT를 고정하고 비밀은 본문이 아닌 볼트 참조로 둡니다.
읽는 순서
doctor→MCP→본문→workspaceAccess→web_search→HITL→역프록시→홈. 릴리스 한 줄에 매니페스트·CONTEXT 해시·이미지 태그. 다중 게이트웨이는 승격 자동화, 승인자 명단, CI 비밀 패턴 금지, 서명 tarball, 로케일 분할로 비대를 막습니다.
FAQ·호스팅 원격 Mac 가치
Skills가 코드 리뷰를 대체하나요
아니요. 런타임 안내일 뿐이며 권위 있는 로직은 저장소·파이프라인에 남습니다.
여러 게이트웨이를 맞추려면
태그 스냅샷과 불변 디렉터리로 호스트 드리프트를 만들지 않습니다.
CONTEXT는 앱 repo에 둘까요
제품 사실은 같은 repo가 흔하고 운영 가드는 접근이 엄한 ops repo로 쪼갤 수 있습니다.
임베딩이 CONTEXT를 없애나요
검색을 돕지만 검토된 정본 텍스트는 여전히 필요합니다. 둘의 버전을 맞춥니다.
요약: Skills·CONTEXT는 채팅의 일시성을 doctor와 맞는 버전 자산으로 옮깁니다.
한계: 자체 Mac은 디스크·권한·복제를 직접 집니다. SFTPMAC 호스팅은 가동·위생을 묶어 Skills 작성에 집중하게 합니다. macOS·Xcode 전제는 CONTEXT에 적고, 절전 노트북 게이트웨이는 피하며 Skill 이름 메타 로그 보존은 보안과 합의합니다.
작은 정확한 차이가 신뢰성과 짧은 리뷰를 함께 가져가고, 감사의 교훈은 Skill diff·CONTEXT 주석에 남깁니다. Skills·CONTEXT·산출물 동기 트리일수록 호스팅이 빛납니다.
게이트웨이 릴리스와 같은 박자로 CONTEXT·Skills를 버전 관리할수록 호스팅 노드에서 강제가 쉬워집니다.