EJClaw 경량화·최적화 계획 (v2 — 사용자 결정 반영)
- 최초 조사: 2026-10-01 (기준 커밋
af28bae), 결정 반영: 2026-10-01 16시
- 번호는 첫 조사 문서와 같다. 빠진 번호는 "제외"로 표시했다.
- 상태 표기
- 확정: 결정이 끝나 바로 진행
- 추천: 결정은 필요 없지만, 진행하겠다고 확인만 받으면 됨
- 결정 필요: 아래 설명을 보고 골라 주셔야 함
- 제외: 하지 않음
0. 한눈에 보기
| 번호 |
내용 |
상태 |
| 1 |
중재자가 판정 규칙을 못 받는 버그 수정 |
확정 (버그) |
| 2 |
리뷰어가 owner 규칙을 받는 버그 수정 |
확정 (버그) |
| 3 |
사용자에게 묻는 경우(NEEDS_CONTEXT) 중재 없이 바로 전달 |
확정 (버그) |
| 4·17 |
Claude 한도 소진 시 답변이 사라지는 failover 경로 제거 |
확정 (버그) |
| 5 |
Codex 사용량 조회가 구버전·잠금 없이 실행되는 문제 |
확정 (버그) |
| 6 |
owner 세션을 작업 단위로 새로 시작 |
추천 (효과 가장 큼) |
| 7 |
공용 메모리 다이어트 |
추천 |
| 8 |
아무것도 안 바꾼 작업은 리뷰 생략 |
결정 필요 (아래 쉬운 설명) |
| 9 |
리뷰 효과 낮은 방을 single로 |
제외 (요청 시에만 전환) |
| 10 |
마무리 턴 비용 줄이기 |
결정 필요 (해결책 3가지) |
| 11~15 |
폴링·로그·IPC 정리 |
추천 |
| 16 |
웹 대시보드·Android·Glasses 전부 삭제 |
확정 |
| 18~21, 23, 24, 29 |
안 쓰는 기능·죽은 코드·의존성 삭제 |
추천 |
| 22 |
/stop 등 명령어 → 대화 중 "그만해"로 중단 |
확정 (새 기능으로 교체) |
| 25 |
DB 마이그레이션 정리 |
추천 (백업 후) |
| 26 |
서비스 ID 단일화 |
보류 (위험 높음) |
| 27 |
main 방 |
결정 필요 (역할 설명 아래) |
| 28 |
계정 로테이션 단순화 (계정 1개 고정) |
확정 |
| 30~35 |
디스크 정리 약 3.3GB |
추천 |
| 36 |
런처 이전 버전 설치 파일 삭제 약 10.5GB |
확정 |
결정이 필요한 3가지 — 쉬운 설명
8. "리뷰 생략"이 뭔가요?
지금은 어떤 질문이든 이렇게 3번 돌아갑니다.
- Claude(owner)가 답을 만든다
- Codex(리뷰어)가 그 답을 검토한다 (평균 1분 30초)
- Claude가 최종 정리를 한다 (평균 20초)
그런데 "이 채널 왜 답 안 해?", "main 방 역할이 뭐야?"처럼 파일을 하나도 고치지 않고 설명만 하는 작업이 전체의 약 44%입니다. "리뷰 생략"은 이런 경우에 2·3번을 건너뛰고 1번 답을 바로 보내는 것입니다.
|
지금 |
리뷰 생략 시 |
| 코드를 고친 작업 |
3단계 그대로 |
3단계 그대로 (변화 없음) |
| 설명만 한 작업 |
3단계 (약 2분 더 걸림) |
1단계 (약 2분 빨라짐) |
| 잃는 것 |
— |
설명 답변의 사실 오류를 리뷰어가 잡아줄 기회 |
- 참고: 오늘도 리뷰어가 설명형 답변에서 실수를 잡은 적이 있습니다(KAclaw 로그인 미확인 상태로 완료 처리하려던 것). 리뷰 품질을 중시하시면 하지 않는 것을 권합니다.
- 선택지: (가) 하지 않음 / (나) 설명만 한 작업은 리뷰 생략
10. 마무리 턴, 다른 해결책
마무리 턴이 생긴 이유(말씀하신 것): owner와 리뷰어가 서로 대화만 하고, 마지막에 "해결했어요"만 남기는 경우가 많아서 전체를 정리해 보여달라고 하신 것.
지금 문제: 마무리 턴이 owner의 거대한 대화 세션 전체(수십만 토큰)를 다시 읽고 정리합니다. 정리 자체는 몇 천 토큰이면 되는데, 매번 수십만 토큰을 씁니다(30일 178회).
| 안 |
방법 |
결과물 |
비용 |
| A |
리뷰어가 수정 요청 없이 바로 승인하면, owner의 첫 답변을 그대로 최종 답변으로 보냄 (owner 규칙상 첫 답변도 이미 "사용자용 완결 답변" 형식) |
수정 없이 끝난 작업은 그대로 / 수정이 있었던 작업만 마무리 턴 |
작업의 약 80%에서 마무리 턴 0회 |
| B |
마무리 턴은 유지하되, 거대한 세션 대신 이번 작업의 owner·리뷰어 답변(최대 6개, 수천 토큰)만 넣은 가벼운 호출로 정리 |
지금과 같은 정리 형식 |
마무리 1회당 수십만 → 수천 토큰 |
| C |
A + B 함께: 바로 승인 → A, 수정 있었음 → B |
같음 |
가장 적음 |
- 추천: C. 보여지는 최종 답변 형식은 지금과 같고, 비용만 줄어듭니다.
- 참고: 6번(세션을 작업 단위로 새로 시작)을 하면 마무리 턴이 읽는 세션도 작아져서 B의 효과 일부가 자동으로 생깁니다.
27. main 방의 역할
main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일은 다음과 같습니다.
| main 방만 가능한 것 |
근거 |
| 다른 방의 예약 작업 보기·취소·일시정지·새로 만들기 |
src/ipc-task-processor/tasks.ts, schedule.ts |
채널 등록·설정 변경 도구(assign_room) |
src/ipc-task-processor/rooms.ts |
| 다른 방으로 메시지 보내기 |
src/ipc-message-forwarding.ts |
| 전체 방 목록, 모든 방의 DB 기록 조회 |
agent-runner-snapshot.ts, db-evidence.ts |
| 트리거 없이 항상 응답, 세션 명령 허용 |
message-runtime-rules.ts, session-commands.ts |
| (부작용) 공용 메모리를 받지 않음 |
agent-runner-environment.ts:671 |
현재 상황:
- main 방이 하나도 없어서 위 기능은 모든 방에서 꺼져 있습니다.
- 대신 base_all 방에서 셸 명령으로 같은 관리 작업(채널 등록, 다른 방 작업 중단, 서비스 재시작 등)을 해 왔습니다. 에이전트가 호스트 셸을 직접 쓸 수 있어서 main 권한이 사실상 필요 없었습니다.
| 선택지 |
내용 |
장점 |
단점 |
| (가) 지금처럼 둠 |
main 없음, 관리는 base_all에서 셸로 |
변경 없음 |
main 관련 코드 163곳이 쓸모없이 남음 |
| (나) base_all을 main으로 지정 |
base_all에서 관리 도구를 정식으로 사용 |
다른 방 예약 작업 관리 등이 도구로 깔끔해짐 |
base_all이 공용 메모리를 못 받게 됨(코드 수정 필요). 위험한 관리 도구가 한 방에 열림 |
| (다) main 개념과 방 간 기능 삭제 |
관련 코드 제거 |
코드 정리, 지금 실제 사용 방식 그대로 |
방 간 관리 도구는 영구히 없어짐(셸로는 계속 가능) |
- 추천: (다). 지금도 쓰지 않고 있고, 셸로 다 하고 있기 때문입니다.
A. 버그 수정 (확정)
1. 중재자가 판정 규칙을 받지 못함
- 근거: 규칙 파일을 읽는 코드가 꺼져 있는 경로(unsafe 모드, MoA)에서만 호출된다. 중재자 세션 폴더에 규칙 파일이 없다.
- 영향: 30일간 중재 23회 중 20회가 판정을 해석하지 못하고 사용자에게 그냥 넘어감.
- 수정: 일반 경로의 중재자 세션에 중재자 규칙을 넣는다.
2. Codex 리뷰어가 owner 규칙을 받음
- 근거: 실제 리뷰어 세션
AGENTS.md에 "You are the owner"가 들어 있다.
- 수정: 리뷰어 세션에는 리뷰어 규칙만 넣는다.
3. NEEDS_CONTEXT가 중재자를 거침
- 근거: 중재 23회 중 13회가 이 경우. 중재자 규칙상 항상 사용자에게 넘기는 경우다.
- 수정: 중재 없이 바로 사용자에게 보낸다. 중재 호출 -57% 이상.
4·17. 받을 곳 없는 Claude→Codex failover 제거
- 근거: Claude 한도 소진 시 이 배포에 없는
codex-main으로 작업을 넘긴다. 5월에 넘긴 2건이 아직 pending.
- 수정: 체인 제거(코드 약 -2천 줄), 한도 소진 시 "한도 소진, ○시 재개 예정"을 바로 보냄.
- 주의: DB 스키마와 엮여 있어 백업 후 진행.
5. Codex 사용량 조회
- 근거: 구버전 전역 Codex(0.128)를 계정 잠금 없이 실행 → 토큰 충돌 위험.
- 수정: 저장소에 고정된 0.159.3 사용 + 계정 잠금 + 주기 5~10분(12번과 함께).
B. 토큰·속도
6. owner 세션을 작업 단위로 새로 시작 (추천, 효과 가장 큼)
- 근거: 방마다 한 세션을 몇 주씩 이어 써서 호출 1회에 중앙값 26만, 최대 100만 토큰을 읽는다. Claude 5시간 사용량 89%의 주원인.
- 수정: 새 작업이 시작되면 세션을 새로 연다. 직전 최종 답변은 이미 자동으로 넘겨주고 있어 맥락 손실이 작다.
- 효과: Claude 입력 토큰 -50~70% (추정).
7. 공용 메모리 다이어트 (추천)
- 근거: 모든 세션에 공용 메모리 약 1.1만 토큰이 들어간다. 세탁기 앱 배포, Windows CI, .5 docker, EJClaw 운영 절차 등 대부분 방과 무관한 내용.
- 수정: 공통 규칙만 남기고, 프로젝트·운영 내용은 해당 방 메모리나 "필요하면 이 문서를 읽어라" 링크로 옮긴다.
- 효과: 호출당 -7~8K 토큰.
8. 리뷰 생략 — 위 설명 참고 (결정 필요)
9. single 전환 — 제외 (요청하신 방만 전환)
10. 마무리 턴 — 위 해결책 참고 (결정 필요)
- 리뷰어 effort를 xhigh → high로 낮추는 것은 별도로 추천(리뷰 평균 97초 단축 예상).
C. 실행 자원 (추천)
| 번호 |
내용 |
효과 |
| 11 |
대시보드 중복 정리: 2초마다 Discord 메시지 100개 조회 → 시작 시 1회 + 5분 주기 |
Discord 호출 하루 4.3만 건 → 수백 건 |
| 12 |
Codex 사용량 조회: 1분마다 프로세스 생성 → 5~10분 + 리뷰 직후 |
프로세스 생성 -80~90% |
| 13 |
Claude 사용량 조회: 1분 → 5분 |
호출 -80%, 429 오류 거의 0 |
| 14 |
로그 한 줄 출력 + 반복 로그 4종 debug로 |
로그 줄 수 -90% |
| 15 |
IPC 고아 폴더 7개 삭제 |
1초 폴링 부담 -20% |
D. 코드 덜어내기
| 번호 |
내용 |
줄어드는 코드 |
상태 |
| 16 |
웹 대시보드·Android 앱·Glasses·관련 설정/스크립트·의존성(react, vite, playwright 등) |
약 -2.4만 줄 (+테스트 -5.8천) |
확정 |
| 18 |
MoA + Kimi 사용량 |
약 -600 |
추천 |
| 19 |
auto-paired-mode |
약 -370 |
추천 |
| 20 |
참조 0인 코드 28개 + 고아 파일 3개 |
약 -500 |
추천 |
| 21 |
엉뚱한 계정을 갱신하는 6시간 Codex 갱신 루프 |
약 -150 |
추천 |
| 22 |
/compact·/clear·/stop 명령 삭제 → 아래 새 기능으로 교체 |
약 -280 (+테스트 -324) |
확정 |
| 23 |
macOS·launchd·nohup 설치 경로, repo-tokens |
약 -150 |
추천 |
| 24 |
쓰지 않는 의존성, 루트 dist 빌드 |
— |
추천 |
| 25 |
DB 마이그레이션 정리 |
약 -4천 |
추천 (백업 후) |
| 26 |
서비스 ID 단일화 |
약 -1천 |
보류 (위험 높음) |
| 27 |
main 방 |
(다) 선택 시 정리 |
결정 필요 |
| 28 |
계정 로테이션을 계정 1개 기준으로 단순화 (Codex 잠금은 유지) |
약 -400~600 |
확정 |
| 29 |
Codex warmup 설정을 primer로 합침 |
약 -200 |
추천 |
- 전부 진행하면 운영 코드 약 7.6만 줄 중 약 3만 줄(약 40%) 감소.
22번 새 기능: 대화 중 "그만해"로 작업 중단 (확정)
| 항목 |
설계 |
| 언제 멈추나 |
방에서 작업이 돌고 있을 때 사용자가 중단 의사만 담긴 짧은 메시지를 보내면 |
| 멈추는 말 |
"그만", "그만해", "멈춰", "중단", "하지마", "하지 마", "취소", "스톱", "stop" 등 |
| 멈추지 않는 경우 |
"그거 하지 말고 이걸 해줘"처럼 다른 지시가 함께 있는 메시지는 방향 수정으로 보고 평소처럼 처리 |
| 멈출 때 하는 일 |
① 그 방에서 돌던 owner·리뷰어·중재자 실행 종료 ② 진행 중이던 작업 종료 처리 ③ 대기 중이던 메시지까지 처리 완료로 표시(지난번 pdf 방처럼 저절로 다시 시작되는 것 방지) ④ "진행 중이던 작업을 중단했습니다"라고 답장 |
| 다시 시작 |
다음에 보내는 메시지부터 평소처럼 새 작업으로 처리 |
| 오작동 방지 |
짧은 메시지만 대상, 판단이 애매하면 멈추지 않고 평소처럼 처리 |
E. 디스크 정리
| 번호 |
대상 |
크기 |
상태 |
| 30 |
DB 백업 23개 중 최근 3개만 남김 |
약 555MB |
추천 |
| 31 |
Codex 임시 플러그인 복제본 등 |
약 1.2GB |
추천 |
| 32 |
세션별 Codex 로그 DB |
약 536MB |
추천 |
| 33 |
등록 안 된 방의 폴더 |
약 560MB |
추천 |
| 34 |
리뷰용 임시 폴더 |
약 208MB |
추천 |
| 35 |
30일 지난 작업 첨부 |
일부 |
추천 |
| 36 |
음악퀴즈 런처 release 폴더의 이전 버전 설치 파일 0.4.9~0.4.30 (6종 × 22버전). 최신 1.0.0 설치 파일 6개(474MB)와 win-unpacked는 남김 |
약 10.5GB |
확정 |
| 36-참고 |
unifi-site 작업공간의 .venv 7.7GB |
— |
남김 (이전 버전이 아니라 지금 쓰는 개발 환경. 실제 사이트는 /home/claude/unifi-site/.venv를 씀. 지우길 원하시면 말씀해 주세요, 다시 만들 수 있음) |
- 30·31·32·35는 주기적으로 정리하는 cron도 함께 추가(추천).
F. 유지
| 대상 |
이유 |
| Tribunal(owner·리뷰어·중재자) 구조, 방별 모드 |
사용자 결정. 리뷰가 결과를 바꾼 비율 13~16% |
| Discord 상태 대시보드 |
사용량 확인용으로 실제 사용 중 (웹 대시보드와 별개) |
| usage primer, evidence·verification 도구, 재시작 복구 등 안전장치 |
실제 동작 기록 있음 |
| DB 보존 정책 |
37MB, 증가 완만. 당장 불필요 |
G. 진행 순서 (제안)
| 단계 |
번호 |
내용 |
| 1단계 |
1, 2, 3, 5, 11~15 |
버그 수정 + 폴링·로그 정리 (작은 수정, 바로 효과) |
| 2단계 |
16, 18~21, 22, 23, 24, 28, 29 |
삭제·단순화 일괄 + "그만해" 중단 기능 |
| 3단계 |
6, 7, 10 |
토큰 절감 (세션 교체, 공용 메모리, 마무리 턴) |
| 4단계 |
4·17, 25 |
DB와 엮인 구조 정리 (백업 후) |
| 5단계 |
30~36 |
디스크 정리 + 주기 정리 cron |
| 보류 |
26 |
서비스 ID 단일화 |
H. 남은 결정 (3개)
- 8번 리뷰 생략: (가) 하지 않음 / (나) 설명만 한 작업은 생략
- 10번 마무리 턴: A / B / C(추천) / 지금 그대로
- 27번 main 방: (가) 그대로 / (나) base_all을 main으로 / (다) 개념 삭제(추천)