docs: record unmanaged openclaw gateway process cleanup on 51124

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)에 즉시 기록해 동일 유형 이슈 재발 시 판단 시간을 단축해야 함

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 상주 프로세스 확인 및 종료/검증 기록