notification-hub

notification-hub

알림 통합 — 모든 스킬의 알림을 하나로 모아 우선순위별로 형님에게 효율적으로 전달합니다.

🎯 목적

각 스킬이 생성하는 다양한 알림을 중앙에서 관리하고, 중요도에 따라 적절한 타이밍과 채널로 전달하여 알림 피로도를 줄입니다.

📥 알림 소스

events/ 디렉토리의 모든 이벤트 파일을 수집:

events/
  ├── health-2026-02-14.json         (health-monitor)
  ├── scrape-result-2026-02-14.json  (data-scraper)
  ├── dm-check-2026-02-14.json       (insta-post)
  ├── competitor-2026-02-14.json     (competitor-watch)
  └── workflow-2026-02-14.json       (skill-composer)

🚦 우선순위 필터

1. urgent — 즉시 Discord DM

조건:

• 보안 이슈 (비정상 로그인, 의심스러운 접근)
• 시스템 에러 (OpenClaw 다운, 브라우저 연결 끊김)
• 비용 초과 (API 사용량 90% 이상)
• 중요 멘션

전송:

• Discord DM (채널 ID는 TOOLS.md에 설정)
• 즉시 전송 (1분 이내)

예시:

🚨 긴급: 브라우저 연결 끊김
포트 18800 응답 없음. 자동 복구 시도했으나 실패.
수동 확인 필요: openclaw browser start

2. important — 다음 heartbeat에 포함

조건:

• 새로운 인스타 DM (읽지 않음)
• 트렌드 급상승 키워드 발견
• 경쟁사 신규 서비스 출시
• Git push 필요 (unpushed commits 10개 이상)

전송:

• 다음 heartbeat 응답에 포함 (~30분 간격)
• 여러 알림을 묶어서 한 번에 전송

예시:

📢 업데이트 3건

📩 인스타 DM 2건 (iam.dawn.kim, partner_xyz)
📈 트렌드: "AI 에이전트" 급상승 (+150%)
🔄 Git: 12개 커밋 push 대기중

3. info — daily-report에만 포함

조건:

• 정기 통계 업데이트
• 일일 토큰 사용량
• 완료된 워크플로우
• 일반 시스템 로그

전송:

• daily-report 스킬 실행 시 포함
• 하루 1회 요약 전송

예시:

📊 일일 리포트 (2026-02-14)

✅ 워크플로우 3건 완료
📊 토큰 사용: 45,230 / 100,000 (45%)
📝 메모리 사용: 3.2 GB
🔧 헬스 체크: 정상

🔕 중복 알림 방지

동일한 이벤트에 대해 2번 이상 알림을 보내지 않습니다.

중복 판정 기준

{
  "event_id": "health-check-2026-02-14-07:00",
  "fingerprint": "sha256(source + type + key_data)",
  "notified_at": "2026-02-14T07:05:00+09:00"
}

히스토리 저장

memory/notifications/
  ├── sent-2026-02-14.json
  ├── sent-2026-02-13.json
  └── ...

sent-YYYY-MM-DD.json 구조:

{
  "date": "2026-02-14",
  "notifications": [
    {
      "id": "health-check-2026-02-14-07:00",
      "priority": "info",
      "sent_at": "2026-02-14T07:05:00+09:00",
      "channel": "discord_dm",
      "source": "health-monitor"
    }
  ]
}