diff --git a/journey/troubleshooting/260226_51124_openclaw_gateway_상주프로세스_정리.md b/journey/troubleshooting/260226_51124_openclaw_gateway_상주프로세스_정리.md new file mode 100644 index 0000000..3ce11f9 --- /dev/null +++ b/journey/troubleshooting/260226_51124_openclaw_gateway_상주프로세스_정리.md @@ -0,0 +1,38 @@ +# 51124 openclaw-gateway 상주 프로세스 정리 + +**날짜**: 2026-02-26 +**작성자**: admin +**관련 파일**: `/home/admin/.nvm/versions/node/v24.4.0/lib/node_modules/openclaw/package.json`, `/proc/1127450/*` + +--- + +## 문제 상황 +- 메모리 상위 프로세스 점검 중 `openclaw-gateway`(PID 1127458) 발견 +- 51124 운영 대상 서비스 목록(AGENTS.md)에는 `openclaw`가 포함되지 않아 비관리 상주 프로세스로 판단 +- 장기 상주 상태로 메모리 점유 및 운영 혼선 가능성 존재 + +## 사실 확인 +- 시작 시각: `2026-02-05 09:33:48 KST` (`ps -o lstart` 기준) +- 실행 주체: `admin` 계정 SSH 세션(`session-60400.scope`, `SSH_CLIENT=192.228.158.63`) +- 실행 형태: systemd 서비스/크론 등록 없음, 수동 실행 후 orphan 상주 +- 프로세스 체인: `systemd(1) -> openclaw(PID 1127450) -> openclaw-gateway(PID 1127458)` +- 패키지 정체: npm 글로벌 `openclaw@2026.2.2-3` (`description: WhatsApp gateway CLI ...`) + +## 해결 방안 +1. 비관리 프로세스 종료 + - `pkill -f '^openclaw$'` + - `pkill -f 'openclaw-gateway'` +2. 잔여 프로세스/포트 검증 + - `ps`, `pgrep`, `ss -tlnp` 재확인으로 `openclaw` 관련 미검출 확인 +3. 리소스 재확인 + - 종료 전후 메모리 비교에서 `free/available` 증가, swap 사용량 감소 확인 + +## 검증 결과 +- `openclaw`, `openclaw-gateway` 프로세스 미검출 +- openclaw 관련 리슨 포트 미검출 +- 운영 필수 컨테이너(`rb8001`, `skill-*`, `robeing_monitor`) 영향 없음 + +## 교훈 +- 운영 대상 외 프로세스는 발견 즉시 실행 주체/시작 시각/자동실행 경로(systemd·cron)까지 함께 확인해야 함 +- 비관리 상주 프로세스는 종료 후 반드시 `ps/pgrep/ss` 3중 검증으로 잔존 여부를 확인해야 함 +- 운영 문서(DOCS)에 즉시 기록해 동일 유형 이슈 재발 시 판단 시간을 단축해야 함 diff --git a/journey/troubleshooting/README.md b/journey/troubleshooting/README.md index 4723b37..e9074e3 100644 --- a/journey/troubleshooting/README.md +++ b/journey/troubleshooting/README.md @@ -46,3 +46,6 @@ rg "Docker" DOCS/troubleshooting -g "*.md" # 도커 관련 문서 검색 - 월별 인덱스 문서 작성 (예: `2025-07.md`) - Slack/Email/Calendar 등 서비스별 태그 파일 정리 - 교훈 섹션 자동 추출 스크립트 추가 (plans/ 디렉토리 예정) + +- [260226_51124_openclaw_gateway_상주프로세스_정리.md](./260226_51124_openclaw_gateway_상주프로세스_정리.md) + - 51124에서 비관리 openclaw-gateway 상주 프로세스 확인 및 종료/검증 기록