signalradar은(는) 무엇을 하나요?
전달 채널
SignalRadar는 알림 전송을 위한 세 가지 전달 어댑터를 지원합니다.
webhook(권장, 이식성 높음) — 모든 엔드포인트(Slack 웹훅, Telegram Bot API, Discord 등)로 HTTP POST를 전송합니다. 모든 플랫폼에서 작동합니다.crontab스케줄링과 함께 사용하면 LLM 비용 제로, 플랫폼 의존성 제로로 알림을 전달합니다.file— 알림을 로컬 JSONL 파일에 추가합니다. 로컬 로깅이나 커스텀 소비에 적합합니다.openclaw(OpenClaw 전용) — OpenClaw 플랫폼 메시징입니다. ClawHub를 통해 설치된 경우에만 사용 가능합니다. 다른 플랫폼으로는 이식할 수 없습니다.
기본 전달 채널은 webhook입니다. 웹훅 URL 설정은 다음과 같습니다.
python3 scripts/signalradar.py config delivery webhook https://your-webhook-url
전달 경로 (기술 세부 사항):
crontab → signalradar.py run --yes --output json → HIT 감지 → deliver_hit() → 웹훅 URL로 HTTP POST → 메시지 전달. 플랫폼 의존성 제로, LLM 비용 제로.
의도 매핑
사용자 메시지를 수신한 후, 다음 표에서 명령을 선택하세요. 어떤 의도와도 일치하지 않으면 명령을 실행하지 말고 일반적인 채팅을 하세요.
| 사용자 의도 (일반 표현) | English intent | Command |
|---|---|---|
| "내가 모니터링하는 거 봐" / "내 목록" / "추적 중인 거" | "list my monitors" / "what am I tracking" | list |
| "변화 있어?" / "확인해 봐" / "실행해" | "any changes?" / "run a check" | run |
| "URL 추가해 줘" / "이 링크 모니터링" | "add this market" / "monitor this" | add <url> |
| "시장 몇 개 추가해 줘" / "모니터링할 거 없어?" | "add markets" (no URL) | add (인자 없음) → 빈 감시 목록은 ONBOARD_NEEDED 반환, 에이전트가 onboard 흐름 시작 |
| "N 번째 삭제" / "이것만 빼" | "remove #N" / "stop monitoring" | remove <N> |
| "임계값 X로 바꿔" / "민감도 높여" | "change threshold" / "more sensitive" | config threshold.abs_pp <X> |
| "얼마나 자주 확인해?" / "30분으로 바꿔" | "check frequency" / "every 30 min" | schedule / schedule 30 |
| "자동 모니터링 아직 돌아가?" / "cron 상태" | "is auto-monitoring running?" | schedule (상태 확인) |
| "지금 설정 뭐야?" / "임계값 얼마야?" | "what are current settings?" | config (실제 값을 반드시 확인) |
| "건강 검진" / "잘 되나?" | "health check" / "is it working?" | doctor --output json |
| "주간 보고서" / "이번 주 요약" / "digest 생성" | "weekly digest" / "summary report" | digest |
| "알림 설정" / "전달 채널 구성" | "set up notifications" / "configure delivery" | 사용자에게 웹훅 URL을 제공하도록 안내한 후 config delivery webhook <url> |
| "알림 한국어로" / "언어 한국어로" | "switch to Chinese notifications" | config profile.language zn |
| "응" / "괜찮아" / "OK" / "알았어" | casual chat | 어떤 명령도 실행하지 않음 |
| "X 확률 얼마야?" | "what's the probability of X?" | `show <number |
중요 규칙
CR-01 다중 마켓 이벤트는 먼저 개수를 보고해야 함
이벤트에 여러 마켓(>3개)이 있으면 CLI가 개수, 유형 요약, 마켓 목록을 강제로 출력한 후 확인을 기다립니다. --yes 플래그로도 이를 건너뛸 수 없습니다. 에이전트는 add를 실행하기 전에 개수와 유형을 설명해야 합니다.
CR-02 마켓을 자동 추가하지 않음 사용자가 Polymarket URL을 명시적으로 제공하거나 사전 설정에서 선택해야 합니다. 자동 추가하지 마세요.
CR-03 에이전트는 데이터 파일을 직접 편집해서는 안 됨
에이전트는 Write/Edit 도구를 사용하여 ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json 또는 기준 파일을 편집해서는 안 됩니다. CLI 명령어만 사용하세요. 일반 실행 시 파일이 자동으로 기록되는 것은 예상된 동작입니다. (참고: 사람 사용자가 watchlist.json을 수동 편집할 수 있습니다. 시스템이 허용합니다. 이 규칙은 에이전트에게만 적용됩니다.)
CR-04 사람과의 대화에서 --yes 금지
사용자와 상호작용할 때 에이전트는 --yes 플래그를 사용해서는 안 됩니다. --yes 플래그는 자동화/CI 파이프라인(스모크 테스트, 크론 작업, 게시 전 게이트) 전용입니다. 내장된 확인 절차가 사용자 상호작용을 처리하게 하세요.
CR-05 항상 실제 설정 값을 확인
사용자가 현재 설정에 대해 물을 때, 반드시 먼저 signalradar.py config를 실행하세요. 기억에서 추측하거나 떠올리지 마세요. 값이 없으면 기본값을 보고하고 "이것은 기본값입니다"라고 명시하세요.
CR-06 첫 번째 추가 후 자동 모니터링 활성화 (crontab 우선, 라우트 게이트 포함)
첫 번째 add 또는 onboard finalize 후, 백그라운드 모니터링이 자동 활성화를 시도합니다(10분 간격). 시스템 crontab을 우선하며, crontab을 사용할 수 없는 경우에만 openclaw cron으로 폴백합니다. 라우트 게이트: delivery.primary.channel == openclaw + crontab 드라이버 + 캡처된 응답 라우트 없음인 경우, CLI는 모니터링을 활성화하지만 route_missing 경고를 반환합니다. 검사는 실행될 수 있지만 백그라운드 채팅 전달이 준비되지 않았기 때문입니다. 에이전트는 "cron을 설정할까요?"라고 묻지 말고 작업을 수동으로 생성해서는 안 됩니다. schedule --output json에서 delivery_status를 확인하고 모니터링과 전달이 활성화되어 있는지 정직하게 보고하세요. 권장 조합: crontab 스케줄링 + webhook 전달 = LLM 비용 제로 + 플랫폼 의존성 제로.
CR-07 CLI를 사용하여 설정과 일정 관리
설정(임계값, 전달 채널 등)은 signalradar.py config [key] [value]를 사용하세요. 모니터링 빈도는 signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab]를 사용하세요. JSON 설정 파일을 수동 편집하지 마세요.
CR-08 빈 감시 목록은 온보딩을 트리거
감시 목록이 비어 있고 에이전트가 add/run --output json을 실행하면 응답이 ONBOARD_NEEDED가 됩니다. 에이전트는 URL을 제공하도록 제안하지 말고 3단계 onboard 흐름을 시작해야 합니다.
CR-09 온보딩은 3단계 흐름 + 웹훅 안내 (좁은 브리지 원칙)
봇/에이전트 모드에서 새 사용자 온보딩은 onboard 하위 명령을 통해 세 단계로 진행됩니다.
onboard --step preview --output json→ 사전 설정된 이벤트 목록 + 용어 교육(이벤트/마켓) 표시 → "어떤 것을 제거할까요?" 질문onboard --step confirm --keep <user-selection> --output json→ 하위 마켓 세부 정보 + 용어(카테고리/기준) 표시 → "추가할까요?" 질문onboard --step finalize --output json→ 감시 목록 쓰기 + 자동 모니터링 활성화 → 완료 + 다음 단계 표시 각 단계는 진행하기 전에 사용자의 답변을 기다려야 합니다. 3단계를 1단계로 압축하지 마세요.
웹훅 안내(finalize 후): ONBOARD_COMPLETE JSON에는 webhook_setup 필드가 포함됩니다. webhook_setup.needed == true이면 에이전트가 사용자에게 백그라운드 푸시 전달을 위한 웹훅 URL을 구성하도록 적극적으로 안내해야 합니다. Telegram Bot API / Slack / Discord URL 예시를 제공하세요. 사용자가 URL을 제공한 후 config delivery webhook <URL>을 실행합니다.
CR-10 백그라운드 푸시에는 캡처된 응답 라우트가 필요함
crontab 경로에서의 --push 백그라운드는 저장된 응답 라우트(~/.signalradar/cache/openclaw_reply_route.json)가 필요합니다. 없으면 백그라운드 전달이 작동 중이라고 주장하지 마세요. openclaw 전달의 경우 schedule --output json에서 delivery_status와 route_ready를 확인하세요.
CR-11 실제 상태를 확인한 후에만 푸시 준비 완료 주장 (채널 인식)
사용자에게 백그라운드 푸시가 작동 중이라고 말하기 전에 schedule --output json → delivery_status 필드를 확인하세요.
"ready"→ 현재 전달 채널에 대해 푸시가 작동 중"webhook_url_missing"→ 사용자에게config delivery webhook <URL>실행 안내"route_missing"→ openclaw 채널에만 관련됨. 사용자가 webhook을 사용 중이면 이 필드는 나타나지 않음"file_target_missing"→ 사용자에게 file 대상을 설정하도록 안내
채널 간 진단을 혼동하지 마세요. 전달 채널이 webhook이면 route_ready를 확인하거나 보고하지 마세요. 관련이 없습니다. delivery_status 필드는 이미 활성 채널을 고려합니다.
알려진 AI 실수 (반복 금지)
이러한 실수는 실제 프로덕션에서 발생했습니다. 에이전트는 이를 피해야 합니다.
오류 1: 개수를 먼저 보고하지 않고 28개 마켓 추가
- 잘못됨: 사용자가 Bitcoin URL을 보냄 → 에이전트가
add를 실행하여 28개 마켓을 조용히 추가함 - 올바름: "이 이벤트에는 28개의 하위 마켓(14개 상승 + 14개 하락)이 있습니다. 모두 추가할까요, 아니면 선택할까요?" → 답변 대기
오류 2: 사용자가 "응"이라며 → 에이전트가 run을 트리거하고 NO_REPLY 출력
- 잘못됨: 사용자가 "응"이라고 말함 → 에이전트가
signalradar.py run실행 → "NO_REPLY" 응답 - 올바름: "응"은 일반적인 승인입니다. 명령을 실행하지 않고 정상적으로 답변하세요.
오류 3: 사람과의 대화에서 --yes 사용
- 잘못됨:
signalradar.py add <url> --yes(인간 채팅에서 확인 절차 건너뜀) - 올바름:
signalradar.py add <url>(내장 확인이 처리하도록 함. CLI는 대규모 배치를 강제로 미리 봄)
오류 4: Write/Edit 도구로 watchlist.json 편집
- 잘못됨: Write/Edit 도구로
~/.signalradar/config/watchlist.json편집 - 올바름:
signalradar.py add,remove,configCLI 명령어 사용
오류 5: 기억에서 설정 값 추측
- 잘못됨: "기본 임계값은 5pp입니다" (확인하지 않고)
- 올바름: 먼저
signalradar.py config threshold.abs_pp를 실행한 후 실제 값으로 답변
오류 6: 스킬 외부에 보상 스크립트 작성
- 잘못됨:
send_alerts_to_telegram.py와 같은 헬퍼 스크립트를 스킬 외부에 작성하여 누락된 동작 보상 - 올바름: 모니터링, 스케줄링, 전달을 스킬/런타임 계약 내에 유지하세요. 실제 격차가 있다면 스킬 자체를 수정하고 부수적인 스크립트를 발명하지 마세요.
오류 7: clawhub 업데이트를 데이터 확인 없이 새 설치로 간주
- 잘못됨:
clawhub update후 사용자가 모든 데이터를 잃었다고 가정하고 런타임 데이터 디렉토리를 확인하지 않고 새 설치로 간주 - 올바름: 먼저 실제 사용자 데이터 디렉토리(
~/.signalradar/또는SIGNALRADAR_DATA_DIR)를 읽은 후에만 마이그레이션이나 복구가 필요한지 결정
오류 8: 웹훅 URL 확인 없이 푸시 준비 완료 주장
- 잘못됨: "백그라운드 모니터링이 활성화되어 알림이 전달됩니다!" (웹훅 URL이 비어 있을 때)
- 올바름:
doctor --output json확인 →webhook_url_configured: false이면 사용자에게 웹훅 URL 설정 안내
오류 9: 3단계 온보딩을 한 번에 실행
- 잘못됨: 사용자에게 결과를 보여주지 않고 3개의 onboard 단계를 순차적으로 실행
- 올바름: 각 단계의 출력을 사용자에게 보여주고 진행하기 전에 답변을 기다림
오류 10: 라우트 확인 없이 푸시 준비 완료 주장
- 잘못됨: "백그라운드 푸시가 모두 설정되었습니다!" (route_ready 확인 없이)
- 올바름:
schedule --output json확인 →route_ready: false이면 전달이 아직 준비되지 않았다고 알림
오류 11: 웹훅 URL 확인 없이 푸시 준비 완료 주장
- 잘못됨: "백그라운드 모니터링이 활성화되어 알림이 전달됩니다!" (웹훅 URL이 비어 있을 때)
- 올바름:
doctor --output json확인 →webhook_url_configured: false이면 사용자에게 웹훅 URL 설정 안내
빠른 시작
# 설치 (OpenClaw 사용자)
clawhub install signalradar
# 또는 직접 클론
git clone https://github.com/vahnxu/signalradar.git && cd signalradar
# 1. 건강 검진
python3 scripts/signalradar.py doctor --output json
# 2. 마켓 추가 (안내 설정 또는 URL로)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/your-market-here
# 3. 첫 번째 추가 후 모니터링 자동 시작 (10분 간격)
# 4. 스케줄 상태 확인
python3 scripts/signalradar.py schedule
# 5. 수동 확인 (드라이 런)
python3 scripts/signalradar.py run --dry-run --output json
일반 작업
마켓 추가
python3 scripts/signalradar.py add # 안내 설정
python3 scripts/signalradar.py add <polymarket-event-url> [--category <name>]
흐름: URL 구문 분석 → Polymarket API 쿼리 → 마켓 질문 + 현재 확률 표시 → 사용자 확인 → 기준 기록.
- 이벤트에 여러 마켓(예: 다른 날짜 범위)이 있는 경우 CLI는 추가하기 전에 모든 마켓과 현재 확률을 표시합니다. 큰 이벤트(>3개 마켓)의 경우 유형 요약도 표시하고
--yes가 전달되었더라도 대화형 확인을 강제합니다. - 이벤트의 일부 마켓이 이미 모니터링 중이면 새 마켓만 추가됩니다.
- 마켓이 결제/만료된 경우 경고가 표시되지만 사용자는 계속 추가할 수 있습니다.
- 카테고리를 지정하지 않으면 기본값은
default입니다. 사용자에게 카테고리를 묻지 않습니다. - 첫 번째 추가(빈 감시 목록) 시 기준 개념에 대한 간단한 설명이 표시됩니다.
모니터 목록
python3 scripts/signalradar.py list [--category <name>] [--archived]
카테고리별로 그룹화된 모든 항목을 전역 순차 번호와 함께 표시합니다. 각 항목은 다음을 보여줍니다: 번호, 질문, 마지막으로 알려진 확률(로컬 기준 캐시에서), 종료 날짜.
--archived는 이전에 제거된 항목을 표시합니다(내보내기를 위해 보존됨).
하나의 모니터링 중인 마켓 표시
python3 scripts/signalradar.py show <number-or-keyword> [--output json]
목록 번호나 키워드로 하나 이상의 모니터링 중인 마켓을 조회하고, 현재 확률을 가져와 기준을 업데이트하지 않고 읽기 전용 스냅샷을 반환합니다.
모니터 제거
python3 scripts/signalradar.py remove <number>
항목 이름을 표시하고 제거하기 전에 확인을 요청합니다. 제거된 항목은 전체 기록과 함께 ~/.signalradar/config/watchlist.json의 archived 배열로 이동되어 보관됩니다.
점검 실행
python3 scripts/signalradar.py run [--dry-run] [--output json]
모든 활성 항목을 Polymarket API에 대해 확인합니다. 확률 변화가 임계값을 초과하면 구성된 전달 채널을 통해 알림을 보냅니다.
- 결제/만료된 항목은 점검 중 건너뛰며, 끝에 요약이 표시됩니다: "N개 항목이 결제되었습니다. 제거를 고려하세요."
- 동일한 점검에서 여러 마켓이 트리거되면 이벤트별로 그룹화되어 동일한 알림에 나열됩니다.
- HIT가 푸시된 후 기준은 새 확률 값으로 업데이트됩니다. 알림 텍스트에는 "기준이 XX%로 업데이트되었습니다."가 포함됩니다.
--dry-run은 가져오고 평가하지만 상태를 기록하지 않습니다.--output openclaw는 플랫폼 백그라운드 실행을 위해 예약되었습니다. 조용한 점검 시HEARTBEAT_OK, 실시간 알림 시 사용자 준비 HIT 텍스트, 기본 전달 채널이openclaw일 때 예약된 다이제스트가 예정된 경우 다이제스트 텍스트를 내보냅니다.
스케줄 관리
python3 scripts/signalradar.py schedule # 현재 상태 표시
python3 scripts/signalradar.py schedule 10 # 자동 드라이버 (crontab 우선)
python3 scripts/signalradar.py schedule 10 --driver openclaw # openclaw 크론 강제
python3 scripts/signalradar.py schedule disable # 모니터링 중지
스케줄 드라이버:
auto(기본값): 시스템 crontab을 우선 사용, 사용 불가 시 openclaw cron으로 폴백openclaw: OpenClaw 크론 강제 사용 (OpenClaw에서 실행 중일 때만 작동)crontab: 시스템 crontab 강제 사용
드라이버 가용성 확인:
python3 scripts/signalradar.py schedule --available-drivers
crontab이 doctor에서 not_available을 보고하면(예: Docker 컨테이너) 자동 드라이버는 openclaw로 폴백합니다.
설정 관리
python3 scripts/signalradar.py config # 모든 설정 표시
python3 scripts/signalradar.py config delivery webhook https://... # 전달 채널 설정
python3 scripts/signalradar.py config threshold.abs_pp 3 # 임계값을 3pp로 설정
python3 scripts/signalradar.py config profile.language zn # 알림 언어를 중국어로 변경
python3 scripts/signalradar.py config profile.language en # 알림 언어를 영어로 변경
사용 가능한 설정 키:
threshold.abs_pp— 절대 퍼센티지 포인트 임계값 (기본값: 5). 1pp 변화가 감지되면 HIT가 트리거됩니다.delivery.webhook.url— 웹훅 전달 URL. 설정되면 기본 전달 채널이 자동으로webhook이 됩니다.delivery.primary.channel— 기본 전달 채널 (webhook|file|openclaw).delivery.file.path— file 전달 대상 경로.profile.language— 알림 언어 (en또는zn).data_dir— 모든 SignalRadar 데이터가 저장되는 디렉토리 (기본값:~/.signalradar).
건강 검진
python3 scripts/signalradar.py doctor --output json
API 연결, cron 가용성, 전달 구성 등을 확인합니다. 사람 친화적인 요약과 머신 판독 가능한 JSON을 모두 반환합니다.
주간 다이제스트
python3 scripts/signalradar.py digest [--output json] [--force]
지난 7일 동안의 모든 확률 변화를 검토하고 요약을 생성합니다. --force는 아직 전송되지 않았더라도 다이제스트를 강제로 생성 및 전송합니다.
점검 중 --output openclaw와 함께 자동으로 연결됩니다: 긴 침묵 기간 후 다이제스트가 예정되어 있으면 HEARTBEAT_OK 대신 다이제스트 텍스트가 전송됩니다.
일반 워크플로 (에이전트 안내)
새 사용자 (빈 감시 목록)
사용자가 모니터링을 설정하고 싶다고 말하면:
python3 scripts/signalradar.py add실행 → ONBOARD_NEEDED 반환- 3단계 흐름 시작:
onboard --step preview --output json→ 이벤트 목록 표시 → "어떤 것을 제거할까요?"onboard --step confirm --keep <선택> --output json→ 하위 마켓 표시 → "추가할까요?"onboard --step finalize --output json→ 완료 → 웹훅 안내
- ONBOARD_COMPLETE가 webhook_setup.needed == true를 표시하면 사용자에게 웹훅 URL을 제공하도록 안내
config delivery webhook <URL>실행
기존 사용자
사용자가 특정 URL을 제공하면:
python3 scripts/signalradar.py add <url>실행- CLI가 프리뷰를 표시하고 확인을 요청할 때까지 기다림
- 질문을 받으면 요약을 설명하고 계속 진행할지 또는 조정할지 선택
사용자가 점검을 요청하면:
python3 scripts/signalradar.py run --dry-run --output json실행- 출력을 사용자가 읽을 수 있는 텍스트로 요약
- 자동 점검이 실행 중인 경우
schedule로 상태 확인 가능
사용자가 모니터를 제거하고 싶어하면:
- 전역 번호를 확인하기 위해
python3 scripts/signalradar.py list실행 python3 scripts/signalradar.py remove <number>실행
환경 변수
SIGNALRADAR_DATA_DIR— 재정의된 데이터 디렉토리 (기본값:~/.signalradar). 설치는 이 변수를 존중합니다. 절대 경로여야 합니다.POLYMARKET_API_BASE— Polymarket API 기본 URL (기본값:https://gamma-api.polymarket.com)