OpenClaw 프로젝트 운영 체제: 다중 프로젝트 관리 프레임워크

핵심 문제와 해결책

OpenClaw 프로젝트 운영 체제는 다중 프로젝트 환경에서 발생하는 실행 실패와 불일치 문제를 해결합니다. 주요 문제는 도구가 처리해야 할 예측 가능한 작업을 에이전트가 수행하면서 토큰 낭비, 컨텍스트 오염, 불안정성, 실행 불일치가 발생한 것이었습니다.

핵심 전환: "에이전트는 예측 가능한 작업을 해서는 안 됩니다. 도구가 해야 합니다." 에이전트는 프로세스 모니터링, 반복적인 요약, 상태 확인 루프, 수동 상태 관리와 같은 반복 작업을 수행하고 있었습니다. 이제 도구와 스크립트가 모든 예측 가능한 작업을 처리하고, cron이 모든 것을 자동으로 실행하며, 에이전트는 계획 수립, 디버깅, 의사 결정에만 사용됩니다.

시스템 아키텍처

핵심 시스템 규칙:

• 에이전트는 생각합니다. 도구는 실행합니다. Cron은 코드를 실행합니다.
• 모든 프로젝트는 필수 구조로 격리됩니다: /project_name/ PROJECT.md SKILL.md /state/ /chat/ /daily/ /scripts/ /logs/ /backups/ /archive/ /cleanup_queue/
• 파일 우선 메모리: 메모리는 마크다운 문서, JSON 상태, 로그, 요약입니다 (채팅은 메모리가 아닙니다)
• 백업 우선 (필수): 변경 전에 먼저 백업하고, 파일 버전을 관리하며, 롤백을 허용합니다
• 푸시 전 풀 (중요): 서버, 웹사이트, 원격 시스템 업데이트 전에 반드시: 1. 풀 2. 비교 3. 백업 4. 푸시 순서로 진행합니다
• 즉시 삭제 금지: 파일을 archive/ 또는 cleanup_queue/로 이동하고, cron을 통해 나중에 삭제합니다
• 변경 사항 설명: 무엇이든 변경할 때 문제, 해결책, 이점을 설명하고 백업을 확인합니다

자동화 시스템

Cron은 스크립트, 작업, 결정론적 작업을 실행하지만 자유 형식 에이전트나 추론 루프는 실행하지 않습니다.

필수 Cron 작업:

• 프로젝트 탐색: 모든 프로젝트 찾기, 구조 검증, 레지스트리 구축
• 6시간 요약기 (로컬 모델): 프로젝트 요약, 마지막 10개 메시지 유지, 나머지 아카이브, 매 실행 시 신선한 컨텍스트
• 일일 계획자: 일일 작업 기록, 차단 요소 추적, 결정 사항 추적
• 상태 점검: 오래된 프로젝트, 실패한 작업, 누락된 업데이트 감지
• 백업/체크포인트: 파일 버전 관리, 상태 스냅샷
• 주간 정리: 안전한 경우에만 오래된 파일 제거, 체크포인트 필요
• Cron 감사: 누락된 작업, 실패 감지
• 예약된 게시: JSON + 도구 사용, 에이전트 없음
• 원격 동기화: 업데이트 전 풀, 버전 비교
• 아침 보고서: 모든 프로젝트 요약, 에이전트 검토 준비

요약 시스템

6시간마다: 프로젝트 로그 읽기, 요약, 상태 업데이트, 마지막 10개 메시지만 유지, 나머지 아카이브.