Was macht signalradar?
Zustellungskanäle
SignalRadar unterstützt drei Zustellungsadapter für das Senden von Alarmen:
webhook(empfohlen, portabel) — HTTP-POST an einen beliebigen Endpunkt (Slack-Webhook, Telegram Bot API, Discord usw.). Funktioniert auf jeder Plattform. In Kombination mit dercrontab-Planung werden Benachrichtigungen ohne LLM-Kosten und ohne Plattformabhängigkeit zugestellt.file— Alarme an eine lokale JSONL-Datei anhängen. Gut für lokale Protokollierung oder benutzerdefinierte Verarbeitung.openclaw(nur OpenClaw) — Nachrichtenübermittlung auf der OpenClaw-Plattform. Nur verfügbar, wenn über ClawHub installiert. Nicht auf andere Plattformen übertragbar.
Standardzustellungskanal ist webhook. Lege deine Webhook-URL fest mit:
python3 scripts/signalradar.py config delivery webhook https://deine-webhook-url
Zustellungspfad (technisches Detail):
crontab → signalradar.py run --yes --output json → HIT erkannt → deliver_hit() → HTTP-POST an Webhook-URL → Nachricht zugestellt. Keine Plattformabhängigkeit, keine LLM-Kosten.
Absichtszuordnung
Nach Erhalt einer Benutzernachricht wähle einen Befehl aus dieser Tabelle. Wenn keine Absicht passt, führe KEINEN Befehl aus – chatte einfach normal.
| Benutzerabsicht (deutsch) | Englische Absicht | Befehl |
|---|---|---|
| „Was überwache ich gerade?“ / „Meine Liste“ / „Welche Märkte tracke ich?“ | „list my monitors“ / „what am I tracking“ | list |
| „Gibt es Änderungen?“ / „Überprüfe“ / „Führe einen Check durch“ | „any changes?“ / „run a check“ | run |
| „Füge [URL] hinzu“ / „Überwache diesen Link“ | „add this market“ / „monitor this“ | add <url> |
| „Füge ein paar Märkte hinzu“ / „Möchte überwachen, aber habe keinen Link“ | „add markets“ (no URL) | add (kein Argument) → leere Watchlist gibt ONBOARD_NEEDED zurück, Agent startet onboard-Ablauf |
| „Entferne den N-ten“ / „Überwache diesen nicht mehr“ | „remove #N“ / „stop monitoring“ | remove <N> |
| „Ändere den Schwellenwert auf X“ / „Erhöhe die Empfindlichkeit“ | „change threshold“ / „more sensitive“ | config threshold.abs_pp <X> |
| „Wie oft wird geprüft?“ / „Ändere auf 30 Minuten“ | „check frequency“ / „every 30 min“ | schedule / schedule 30 |
| „Läuft die automatische Überwachung noch?“ / „Cron-Status“ | „is auto-monitoring running?“ | schedule (Status anzeigen) |
| „Was sind die aktuellen Einstellungen?“ / „Wie hoch ist der Schwellenwert?“ | „what are current settings?“ | config (muss den tatsächlichen Wert überprüfen) |
| „Gesundheitscheck“ / „Funktioniert es?“ | „health check“ / „is it working?“ | doctor --output json |
| „Wochenbericht“ / „Zusammenfassung“ / „Erstelle einen Digest“ | „weekly digest“ / „summary report“ | digest |
| „Richte Benachrichtigungen ein“ / „Konfiguriere den Zustellungskanal“ | „set up notifications“ / „configure delivery“ | Führe den Benutzer dazu, eine Webhook-URL bereitzustellen, dann config delivery webhook <url> |
| „Benachrichtigungen auf Deutsch“ / „Sprache auf Deutsch umstellen“ | „switch to Chinese notifications“ | config profile.language de |
| „OK“ / „In Ordnung“ / „Alles klar“ / „Verstanden“ | casual chat | Führe KEINEN Befehl aus |
| „Wie hoch ist die Wahrscheinlichkeit für X?“ | „what's the probability of X?“ | show <nummer|keyword> |
Kritische Regeln
KR-01 Bei Ereignissen mit mehreren Märkten zuerst die Anzahl melden
Wenn ein Ereignis mehrere Märkte (>3) hat, gibt die CLI zwangsweise die Anzahl, eine Typzusammenfassung und die Marktliste aus, bevor sie auf Bestätigung wartet; --yes kann dies nicht überspringen. Der Agent muss dennoch die Anzahl und Typen erklären, bevor add ausgeführt wird.
KR-02 Niemals Märkte automatisch hinzufügen Der Benutzer muss explizit eine Polymarket-URL angeben oder aus Voreinstellungen wählen. Nicht automatisch hinzufügen.
KR-03 Der Agent darf keine Datendateien direkt bearbeiten
Der Agent darf ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json oder Baseline-Dateien nicht mit Schreib-/Bearbeitungswerkzeugen bearbeiten. Nur CLI-Befehle verwenden. Normale Ausführungen schreiben diese automatisch – das ist erwartetes Verhalten. (Hinweis: Der menschliche Benutzer kann watchlist.json von Hand bearbeiten – das System toleriert dies. Diese Regel schränkt nur den Agenten ein.)
KR-04 Kein --yes in Gesprächen mit Menschen
Bei der Interaktion mit einem menschlichen Benutzer darf der Agent das Flag --yes NICHT verwenden. Das Flag --yes ist nur für automatisierte/CI-Pipelines vorgesehen (Smoke-Tests, Cron-Jobs, Prepublish-Gates). Lasse die eingebaute Bestätigung die Benutzerinteraktion übernehmen.
KR-05 Immer die tatsächlichen Konfigurationswerte überprüfen
Wenn der Benutzer nach aktuellen Einstellungen fragt, führe IMMER zuerst signalradar.py config aus. Nicht raten oder aus dem Gedächtnis wiedergeben. Fehlt ein Wert, melde den Standardwert und gib an: „Dies ist der Standardwert.“
KR-06 Automatische Überwachung nach dem ersten Hinzufügen aktivieren (crontab zuerst, mit Routenprüfung)
Nach dem ersten add oder onboard finalize versucht die Hintergrundüberwachung, sich automatisch zu aktivieren (10-Minuten-Intervall). Bevorzugt systemeigene crontab; fällt auf openclaw cron nur zurück, wenn crontab nicht verfügbar ist. Routenprüfung: Wenn delivery.primary.channel == openclaw + crontab-Treiber + keine erfasste Antwortroute, aktiviert die CLI die Überwachung, gibt aber eine route_missing-Warnung aus, da Prüfungen laufen können, während die Hintergrund-Chat-Zustellung nicht bereit ist. Der Agent darf NICHT fragen „Soll ich Cron einrichten?“ und darf NICHT manuell Jobs erstellen. Überprüfe delivery_status in schedule --output json und berichte ehrlich, ob Überwachung und Zustellung aktiv sind. Empfohlene Kombination: crontab-Planung + webhook-Zustellung = null LLM-Kosten + keine Plattformabhängigkeit.
KR-07 CLI zum Verwalten von Einstellungen und Zeitplan verwenden
Verwende signalradar.py config [key] [value] für Einstellungen (Schwellenwert, Zustellungskanal usw.). Verwende signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] für die Überwachungshäufigkeit. JSON-Konfigurationsdateien NICHT von Hand bearbeiten.
KR-08 Leere Watchlist löst Onboarding aus
Wenn die Watchlist leer ist und der Agent add/run --output json ausführt, lautet die Antwort ONBOARD_NEEDED. Der Agent muss dann den 3-schrittigen onboard-Ablauf starten, nicht vorschlagen, eine URL bereitzustellen.
KR-09 Onboarding ist ein 3-Schritt-Ablauf + Webhook-Anleitung (Schmale-Brücke-Prinzip)
Im Bot-/Agentenmodus durchläuft das Onboarding neuer Benutzer den onboard-Unterbefehl in drei Schritten:
onboard --step preview --output json→ vordefinierte Ereignisliste anzeigen + Begriffserklärung (Ereignis/Markt) → Benutzer fragen „welche entfernen?“onboard --step confirm --keep <user-selection> --output json→ Details zu Untermärkten anzeigen + Begriffserklärung (Kategorie/Baseline) → „Hinzufügen bestätigen?“ fragenonboard --step finalize --output json→ Watchlist schreiben + automatische Überwachung aktivieren → Abschluss + nächste Schritte anzeigen Jeder Schritt muss auf die Antwort des Benutzers warten, bevor fortgefahren wird. Die 3 Schritte NICHT zu einem zusammenfassen.
Webhook-Anleitung (nach finalize): Das JSON ONBOARD_COMPLETE enthält das Feld webhook_setup. Wenn webhook_setup.needed == true ist, sollte der Agent den Benutzer proaktiv anleiten, eine Webhook-URL für die Hintergrund-Push-Zustellung zu konfigurieren. Beispiele für Telegram Bot API / Slack / Discord-URLs bereitstellen. Nachdem der Benutzer die URL bereitgestellt hat, führe config delivery webhook <URL> aus.
KR-10 Hintergrund-Push erfordert eine erfasste Antwortroute
Hintergrund---push auf dem crontab-Pfad erfordert eine gespeicherte Antwortroute (~/.signalradar/cache/openclaw_reply_route.json). Fehlt diese, behaupte NICHT, dass die Hintergrundzustellung funktioniert. Für die openclaw-Zustellung prüfe schedule --output json auf delivery_status und route_ready.
KR-11 Tatsächlichen Status überprüfen, bevor Push-Bereitschaft behauptet wird (kanalabhängig)
Bevor du dem Benutzer mitteilst, dass der Hintergrund-Push funktioniert, prüfe schedule --output json → Feld delivery_status:
"ready"→ Push funktioniert für den aktuellen Zustellungskanal"webhook_url_missing"→ Führe den Benutzer zur Eingabe vonconfig delivery webhook <URL>"route_missing"→ nur für den openclaw-Kanal relevant; wenn der Benutzer Webhook verwendet, erscheint dieses Feld nicht"file_target_missing"→ Führe den Benutzer zur Festlegung eines Dateiziels
Diagnose NICHT kanalübergreifend mischen. Wenn der Zustellungskanal webhook ist, prüfe NICHT route_ready und melde es auch nicht – es ist irrelevant. Das Feld delivery_status berücksichtigt bereits den aktiven Kanal.
Bekannte KI-Fehler (NICHT wiederholen)
Diese Fehler sind tatsächlich in der Produktion aufgetreten. Der Agent muss sie vermeiden.
Fehler 1: 28 Märkte hinzufügen, ohne die Anzahl zuerst zu melden
- FALSCH: Benutzer sendet Bitcoin-URL → Agent führt
addaus und fügt 28 Märkte stillschweigend hinzu - RICHTIG: Melde „Dieses Ereignis hat 28 Untermärkte (14 Aufwärts- + 14 Abwärts-Chancen). Alle hinzufügen oder auswählen?“ → auf Antwort warten
Fehler 2: Benutzer sagt „OK“ → Agent löst run aus und gibt NO_REPLY aus
- FALSCH: Benutzer sagt „OK“ → Agent führt
signalradar.py runaus → antwortet „NO_REPLY“ - RICHTIG: „OK“ ist eine beiläufige Bestätigung. Antworte normal, ohne einen Befehl auszuführen.
Fehler 3: --yes in menschlichen Gesprächen verwenden
- FALSCH:
signalradar.py add <url> --yes(überspringt Bestätigung im menschlichen Chat) - RICHTIG:
signalradar.py add <url>(eingebaute Bestätigung verwenden; CLI zeigt große Batches vorab an)
Fehler 4: Bearbeiten von watchlist.json mit Schreib-/Bearbeitungswerkzeugen
- FALSCH: Bearbeite
~/.signalradar/config/watchlist.jsonmit Schreib-/Bearbeitungswerkzeugen - RICHTIG: Verwende die CLI-Befehle
signalradar.py add,remove,config
Fehler 5: Konfigurationswerte aus dem Gedächtnis raten
- FALSCH: „Der Standard-Schwellenwert ist 5 PP“ (ohne Überprüfung)
- RICHTIG: Führe zuerst
signalradar.py config threshold.abs_ppaus, dann antworte mit dem tatsächlichen Wert.
Fehler 6: Kompensationsskripte außerhalb des Skills schreiben
- FALSCH: Schreibe Hilfsskripte außerhalb des Skills, wie
send_alerts_to_telegram.py, um fehlendes Verhalten zu kompensieren - RICHTIG: Behalte Überwachung, Planung und Zustellung innerhalb des Skills/Runtime-Vertrags. Wenn eine Lücke real ist, repariere den Skill selbst, anstatt Nebenskripte zu erfinden.
Fehler 7: ClawHub-Update als Neuinstallation behandeln, ohne Daten zu prüfen
- FALSCH: Nach
clawhub updateannehmen, der Benutzer habe alle Daten verloren, und die Installation als neu behandeln, ohne das Runtime-Datenverzeichnis zu prüfen - RICHTIG: Lese zuerst das tatsächliche Benutzerdatenverzeichnis (
~/.signalradar/oderSIGNALRADAR_DATA_DIR) und entscheide dann, ob Migration oder Wiederherstellung erforderlich ist.
Fehler 8: Push-Bereitschaft behaupten, ohne die Webhook-URL zu prüfen
- FALSCH: „Hintergrundüberwachung ist aktiv und Benachrichtigungen werden zugestellt!“ (wenn Webhook-URL leer ist)
- RICHTIG: Prüfe
doctor --output json→ wennwebhook_url_configured: false, führe den Benutzer zur Einrichtung der Webhook-URL.
Fehler 9: 3-Schritt-Onboarding zu einer einzigen Ausführung zusammenfassen
- FALSCH: Führe alle 3 Onboarding-Schritte nacheinander aus, ohne dem Benutzer Ergebnisse anzuzeigen
- RICHTIG: Zeige die Ausgabe jedes Schritts dem Benutzer an und warte auf seine Antwort, bevor du fortfährst.
Fehler 10: Push-Bereitschaft behaupten, ohne die Route zu prüfen
- FALSCH: „Hintergrund-Push ist einsatzbereit!“ (ohne
route_readyzu prüfen) - RICHTIG: Prüfe
schedule --output json→ wennroute_ready: false, teile dem Benutzer mit, dass die Zustellung noch nicht bereit ist.
Fehler 11: Push-Bereitschaft behaupten, ohne die Webhook-URL zu prüfen
- FALSCH: „Hintergrundüberwachung ist aktiv und Benachrichtigungen werden zugestellt!“ (wenn Webhook-URL leer ist)
- RICHTIG: Prüfe
doctor --output json→ wennwebhook_url_configured: false, führe den Benutzer zur Einrichtung der Webhook-URL.
Schnellstart
# Installation (OpenClaw-Benutzer)
clawhub install signalradar
# Oder direkt klonen
git clone https://github.com/vahnxu/signalradar.git && cd signalradar
# 1. Gesundheitscheck
python3 scripts/signalradar.py doctor --output json
# 2. Märkte hinzufügen (geführte Einrichtung oder per URL)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/your-market-here
# 3. Überwachung startet automatisch nach dem ersten Hinzufügen (alle 10 Min)
# 4. Zeitplanstatus prüfen
python3 scripts/signalradar.py schedule
# 5. Manueller Check (Probelauf)
python3 scripts/signalradar.py run --dry-run --output json
Häufige Aufgaben
Markt hinzufügen
python3 scripts/signalradar.py add # Geführte Einrichtung
python3 scripts/signalradar.py add <polymarket-event-url> [--category <name>]
Ablauf: URL parsen → Polymarket-API abfragen → Marktfrage + aktuelle Wahrscheinlichkeit anzeigen → Benutzer bestätigt → Baseline aufzeichnen.
- Wenn das Ereignis mehrere Märkte hat (z. B. verschiedene Datumsbereiche), zeigt die CLI alle Märkte mit ihren aktuellen Wahrscheinlichkeiten an, bevor sie hinzugefügt werden. Bei großen Ereignissen (>3 Märkte) wird auch eine Typzusammenfassung angezeigt und eine interaktive Bestätigung erzwungen, selbst wenn
--yesübergeben wurde. - Wenn einige Märkte aus dem Ereignis bereits überwacht werden, werden nur neue hinzugefügt.
- Wenn der Markt abgerechnet/abgelaufen ist, wird eine Warnung angezeigt, aber der Benutzer kann ihn trotzdem hinzufügen.
- Die Kategorie standardmäßig auf
default, wenn nicht angegeben. Der Benutzer wird nicht nach einer Kategorie gefragt. - Beim ersten Hinzufügen (leere Watchlist) wird eine kurze Erklärung des Baseline-Konzepts angezeigt.
Überwachte Märkte auflisten
python3 scripts/signalradar.py list [--category <name>] [--archived]
Zeigt alle Einträge gruppiert nach Kategorie mit globaler fortlaufender Nummerierung. Jeder Eintrag zeigt: Nummer, Frage, zuletzt bekannte Wahrscheinlichkeit (aus lokalem Baseline-Cache), Enddatum.
--archived zeigt zuvor entfernte Einträge an (für Export aufbewahrt).
Einen überwachten Markt anzeigen
python3 scripts/signalradar.py show <number-or-keyword> [--output json]
Sucht einen oder mehrere überwachte Märkte nach Listennummer oder Suchbegriff, ruft die aktuelle Wahrscheinlichkeit ab und gibt eine schreibgeschützte Momentaufnahme zurück, ohne Baselines zu aktualisieren.
Überwachung entfernen
python3 scripts/signalradar.py remove <number>
Zeigt den Eintragsnamen an und fragt vor dem Entfernen nach Bestätigung. Entfernte Einträge werden archiviert (in das Archiv-Array in ~/.signalradar/config/watchlist.json verschoben) mit vollständigem Verlauf.
Prüfung durchführen
python3 scripts/signalradar.py run [--dry-run] [--output json]
Überprüft alle aktiven Einträge gegen die Polymarket-API. Wenn die Wahrscheinlichkeitsänderung den Schwellenwert überschreitet, wird ein Alarm über den konfigurierten Zustellungskanal gesendet.
- Abgerechnete/abgelaufene Einträge werden während des Durchlaufs übersprungen, mit einer Zusammenfassung am Ende: „N Einträge abgerechnet, Entfernen erwägen.“
- Wenn in derselben Prüfung mehrere Märkte auslösen, werden sie in derselben Benachrichtigung nach Ereignis gruppiert aufgelistet.
- Nachdem ein HIT gepusht wurde, aktualisiert sich die Baseline auf den neuen Wahrscheinlichkeitswert. Der Benachrichtigungstext enthält „Baseline auf XX% aktualisiert.“
--dry-runruft ab und evaluiert, schreibt aber keinen Zustand.--output openclawist für plattformgesteuerte Hintergrundläufe reserviert. Es gibtHEARTBEAT_OKbei leisen Prüfungen, benutzerfreundlichen HIT-Text bei Echtzeitwarnungen und Digest-Text aus, wenn ein geplanter Digest fällig ist und der primäre Zustellungskanalopenclawist.
Zeitplan verwalten
python3 scripts/signalradar.py schedule # Aktuellen Status anzeigen
python3 scripts/signalradar.py schedule 10 # Auto-Treiber (crontab zuerst)
pyth