🦞 20. OpenClaw 운영 아키텍처·규칙 (쉽게 이해하기)

OpenClaw를 쓰다 보면 이런 순간이 와요.
”왜 어떤 날은 술술 되고, 어떤 날은 꼬이지?”

답은 간단합니다. 챗봇처럼 쓰면 불안정하고, 시스템처럼 쓰면 안정적입니다.
이 문서는 독자 관점에서 OpenClaw 운영 구조를 쉽고 재밌게 이해하도록 만든 20편입니다.

안내: 본문은 생성형 AI를 활용해 작성·정리했습니다.

flowchart LR
A[요청 접수] --> B[메인 에이전트]
B --> C[도구 실행]
B --> D[서브에이전트 실행]
C --> E[결과물]
D --> E
E --> F[기록]
F --> B

왜 공감되냐면: 우리도 늘 같은 실수를 하니까

• 급할수록 요청을 뭉뚱그려서 던진다
• 검증 없이 “됐겠지” 하고 넘긴다
• 다음날 왜 이렇게 했는지 기록이 없다

OpenClaw도 똑같아요.
요청 명확도 + 검증 습관 + 기록 루틴이 없으면, 똑똑한데도 결과가 흔들립니다.

OpenClaw를 “작은 팀”으로 보면 쉬워진다

• 메인 에이전트 = 팀장 (우선순위 정리)
• 도구 계층 = 실무자 (실제 작업 수행)
• 서브에이전트 = 리뷰어 (확장/검증/실행 보조)
• memory = 회의록 (다음날 이어달리기)

이렇게 보면 핵심은 하나예요.
혼자 다 하려 하지 말고, 역할을 분리해라.

실전에서 잘 굴러가는 5가지 규칙

1. 단순 작업은 빠르게 (과한 분산 금지)
2. 복잡 작업은 3자 검토 (확장→검증→실행)
3. 완료 보고는 파일/링크 기준으로
4. 파괴적 작업은 확인 후 실행
5. 매일 memory 업데이트 (맥락 끊김 방지)

지금 실제 운영에 적용 중인 장치

아래는 이론이 아니라, 지금 실제로 돌고 있는 운영 장치입니다.

• 출력 강제 라우터: archive/ops/result_router.py, save_result.sh
  • 결과물을 archive/projects/<slug>/<stage>로 강제 저장
• 발행 전 문법 게이트: archive/ops/quartz_preflight_gate.py
  • 링크 깨짐, Mermaid 문법 오류를 배포 전에 차단
• inbox 적체 감시: archive/ops/inbox_48h_guard.py (cron)
  • inbox 48시간 초과 파일 자동 감시
• 주간 재분류 루프: archive/ops/misc_lab_weekly_triage.py (cron)
  • misc-lab에 쌓인 파일을 재분류 후보로 정리

핵심은 이것입니다.
메인 에이전트가 바빠도, 기본 정리/검증 루프는 백그라운드에서 계속 돈다.

메인 에이전트 병목 대응: 역할 분산 규칙

메인이 병목일 때는 “더 열심히”가 아니라 “역할 분리”가 답입니다.

• 메인 에이전트: 우선순위·최종 의사결정·최종 보고
• 서브A(확장): 리서치/아이디어 확장
• 서브B(검증): 리스크·문법·링크 검증
• 서브C(실행): 파일 반영·패키징·정리

flowchart LR
A[요청 접수] --> B[메인: 우선순위 결정]
B --> C[서브A: 확장]
B --> D[서브B: 검증]
B --> E[서브C: 실행]
C --> F[메인 통합]
D --> F
E --> F
F --> G[최종 보고]

실무 적용 90초 체크

WORKSPACE_ROOT=<your-workspace-root>
 
# 1) 결과물 저장 강제
bash "$WORKSPACE_ROOT/archive/ops/save_result.sh" <source> <project-slug> <stage>
 
# 2) 게시 전 문법/링크 검사
python3 "$WORKSPACE_ROOT/archive/ops/quartz_preflight_gate.py" --paths 'Agent/🚀 OpenClaw'
 
# 3) 주간 재분류 후보 리포트 생성
python3 "$WORKSPACE_ROOT/archive/ops/misc_lab_weekly_triage.py"

칠판 치트시트

• 결과 품질 = 요청 명확도 × 검증 강도 × 기록 습관
• 문제의 70%는 “도구”가 아니라 “운영 루틴”에서 발생
• 잘되는 팀은 “잘하는 사람”보다 “같은 규칙”이 있다

독자용 60초 적용 루틴

• 아침: 오늘 우선순위 1~3개만 고정
• 점심: 진행률 말고 “실제 산출물” 확인
• 저녁: 잘된 것 1개/막힌 것 1개 기록

이 3개만 해도 OpenClaw 체감이 확 달라집니다.

자주 생기는 오해 3개

• “모델 바꾸면 다 해결된다” → 절반만 맞음 (운영이 더 큼)
• “많이 시키면 더 빨라진다” → 오히려 검증 비용 증가
• “기록은 나중에” → 다음날 재작업의 시작

한 줄 결론

OpenClaw는 도구가 아니라 운영 시스템입니다.
도구를 바꾸기 전에, 먼저 규칙을 고정하면 결과가 안정됩니다.

관련 문서

• OpenClaw 21: Archive PARA+Z 리팩터링 실행
• OpenClaw 17: Subagents 실패패턴 5가지
• OpenClaw 18: 텔레그램 5분 복구
• 🦞 24. 11가지 핵 실전운영가이드
• 🦞 08. 육성매뉴얼