Que fait signalradar ?
Canaux de livraison
SignalRadar prend en charge trois adaptateurs de livraison pour envoyer des alertes :
webhook(recommandé, portable) — HTTP POST vers n'importe quel endpoint (webhook Slack, API Telegram Bot, Discord, etc.). Fonctionne sur toutes les plateformes. Associé à une planificationcrontab, délivre des notifications sans coût LLM et sans dépendance à une plateforme.file— Ajoute les alertes à un fichier JSONL local. Idéal pour la journalisation locale ou une consommation personnalisée.openclaw(OpenClaw uniquement) — Messagerie de la plateforme OpenClaw. Disponible uniquement lorsqu'il est installé via ClawHub. Non portable vers d'autres plateformes.
Le canal de livraison par défaut est webhook. Définissez l'URL de votre webhook avec :
python3 scripts/signalradar.py config delivery webhook https://votre-url-webhook
Chemin de livraison (détail technique) :
crontab → signalradar.py run --yes --output json → HIT détecté → deliver_hit() → HTTP POST vers l'URL du webhook → message livré. Zéro dépendance à une plateforme, zéro coût LLM.
Correspondance des intentions
Après avoir reçu un message de l'utilisateur, choisissez une commande dans ce tableau. Quand aucune intention ne correspond, n'exécutez AUCUNE commande — discutez normalement.
| Intention utilisateur (expressions courantes en chinois) | Intention en anglais | Commande |
|---|---|---|
| "看看我监控了啥" / "我的列表" / "在追踪哪些" | "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 (sans argument) → une liste de surveillance vide renvoie ONBOARD_NEEDED, l'Agent démarre le flux 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 (voir le statut) |
| "现在设置是什么" / "阈值多少" | "what are current settings?" | config (doit vérifier la valeur réelle) |
| "健康检查" / "能用吗" | "health check" / "is it working?" | doctor --output json |
| "周报" / "本周总结" / "生成 digest" | "weekly digest" / "summary report" | digest |
| "设置推送" / "配置通知渠道" | "set up notifications" / "configure delivery" | Guidez l'utilisateur pour fournir une URL de webhook, puis config delivery webhook <url> |
| "通知改中文" / "语言改中文" | "switch to Chinese notifications" | config profile.language zh |
| "好的" / "没事" / "OK" / "知道了" | conversation informelle | N'exécutez AUCUNE commande |
| "那个 GPT 概率多少了" | "what's the probability of X?" | `show <number |
Règles critiques
CR-01 Les événements à marchés multiples doivent d'abord signaler le nombre
Si l'événement comporte plusieurs marchés (>3), le CLI force l'affichage du nombre, un résumé des types et la liste des marchés avant d'attendre la confirmation ; --yes ne peut pas ignorer cela. L'Agent doit quand même expliquer le nombre et les types avant d'exécuter add.
CR-02 Ne jamais ajouter automatiquement des marchés L'utilisateur doit fournir explicitement une URL Polymarket ou choisir parmi les préréglages. N'ajoutez pas automatiquement.
CR-03 L'Agent ne doit pas éditer directement les fichiers de données
L'Agent ne doit pas éditer ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json ou les fichiers de référence à l'aide d'outils Write/Edit. Utilisez uniquement les commandes CLI. Les exécutions normales écrivent automatiquement ces fichiers — c'est un comportement attendu. (Remarque : l'utilisateur humain peut modifier manuellement watchlist.json — le système le tolère. Cette règle ne restreint que l'Agent.)
CR-04 Pas de --yes dans les conversations humaines
Lorsqu'il interagit avec un utilisateur humain, l'Agent ne doit PAS utiliser le flag --yes. Le flag --yes est réservé aux pipelines automatisés/CI (tests de fumée, tâches cron, gates de pré-publication). Laissez la confirmation intégrée gérer l'interaction utilisateur.
CR-05 Toujours vérifier les valeurs de configuration réelles
Lorsque l'utilisateur demande les paramètres actuels, exécutez TOUJOURS signalradar.py config en premier. Ne devinez pas et ne vous souvenez pas de mémoire. Si une valeur est manquante, signalez la valeur par défaut et indiquez "c'est la valeur par défaut".
CR-06 Activer automatiquement la surveillance après le premier ajout (crontab en premier, avec porte de routage)
Après le premier add ou onboard finalize, la surveillance en arrière-plan tente de s'activer automatiquement (intervalle de 10 minutes). Préfère le crontab système ; se rabat sur openclaw cron uniquement lorsque crontab n'est pas disponible. Porte de routage : lorsque delivery.primary.channel == openclaw + pilote crontab + aucune route de réponse capturée, le CLI active la surveillance mais renvoie un avertissement route_missing car les vérifications peuvent s'exécuter alors que la livraison par chat en arrière-plan n'est pas prête. L'Agent ne doit PAS demander "dois-je configurer cron?" et ne doit PAS créer manuellement des tâches. Vérifiez delivery_status dans schedule --output json et signalez honnêtement si la surveillance et la livraison sont actives. Combinaison recommandée : planification crontab + livraison webhook = zéro coût LLM + zéro dépendance à une plateforme.
CR-07 Utiliser le CLI pour gérer les paramètres et la planification
Utilisez signalradar.py config [key] [value] pour les paramètres (seuil, canal de livraison, etc.). Utilisez signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] pour la fréquence de surveillance. NE modifiez PAS manuellement les fichiers de configuration JSON.
CR-08 Une liste de surveillance vide déclenche l'intégration
Lorsque la liste de surveillance est vide et que l'Agent exécute add/run --output json, la réponse sera ONBOARD_NEEDED. L'Agent doit alors démarrer le flux onboard en 3 étapes, et non suggérer de fournir une URL.
CR-09 L'intégration est un flux en 3 étapes + guide webhook (principe du pont étroit)
En mode Bot/Agent, l'intégration des nouveaux utilisateurs passe par la sous-commande onboard en trois étapes :
onboard --step preview --output json→ afficher la liste des événements prédéfinis + éducation à la terminologie (event/market) → demander à l'utilisateur "lesquels supprimer ?"onboard --step confirm --keep <sélection-utilisateur> --output json→ afficher les détails des sous-marchés + terminologie (category/baseline) → demander "confirmer l'ajout ?"onboard --step finalize --output json→ écrire la liste de surveillance + activer la surveillance automatique → afficher la complétion + les prochaines étapes Chaque étape doit attendre la réponse de l'utilisateur avant de continuer. Ne compressez PAS les 3 étapes en 1.
Guide webhook (après finalisation) : le JSON ONBOARD_COMPLETE contient le champ webhook_setup. Lorsque webhook_setup.needed == true, l'Agent doit guider proactivement l'utilisateur pour configurer une URL de webhook pour la livraison push en arrière-plan. Fournissez des exemples d'URL pour l'API Telegram Bot / Slack / Discord. Après que l'utilisateur a fourni l'URL, exécutez config delivery webhook <URL>.
CR-10 Le push en arrière-plan nécessite une route de réponse capturée
Le --push en arrière-plan sur le chemin crontab nécessite une route de réponse stockée (~/.signalradar/cache/openclaw_reply_route.json). Si elle est manquante, ne prétendez PAS que la livraison en arrière-plan fonctionne. Pour la livraison openclaw, vérifiez schedule --output json pour delivery_status et route_ready.
CR-11 Vérifier le statut réel avant de prétendre que le push est prêt (conscient du canal)
Avant de dire à l'utilisateur que le push en arrière-plan fonctionne, vérifiez schedule --output json → champ delivery_status :
"ready"→ le push fonctionne pour le canal de livraison actuel"webhook_url_missing"→ guidez l'utilisateur pour exécuterconfig delivery webhook <URL>"route_missing"→ pertinent uniquement pour le canal openclaw ; si l'utilisateur est sur webhook, ce champ n'apparaîtra pas"file_target_missing"→ guidez l'utilisateur pour définir une cible de fichier
Ne mélangez PAS les diagnostics entre les canaux. Si le canal de livraison est webhook, ne vérifiez PAS et ne signalez PAS route_ready — ce n'est pas pertinent. Le champ delivery_status tient déjà compte du canal actif.
Erreurs connues de l'IA (À NE PAS répéter)
Ces erreurs se sont réellement produites en production. L'Agent doit les éviter.
Erreur 1 : Ajout de 28 marchés sans signaler le nombre d'abord
- FAUX : L'utilisateur envoie une URL Bitcoin → l'Agent exécute
addet ajoute 28 marchés silencieusement - CORRECT : Signaler "Cet événement a 28 sous-marchés (14 haussiers + 14 baissiers). Ajouter tout ou choisir ?" → attendre la réponse
Erreur 2 : L'utilisateur dit "好的" → L'Agent déclenche run et affiche NO_REPLY
- FAUX : L'utilisateur dit "好的" → L'Agent exécute
signalradar.py run→ répond "NO_REPLY" - CORRECT : "好的" est un accusé de réception informel. Répondez normalement sans exécuter de commande.
Erreur 3 : Utilisation de --yes dans une conversation humaine
- FAUX :
signalradar.py add <url> --yes(ignore la confirmation dans un chat humain) - CORRECT :
signalradar.py add <url>(laissez la confirmation intégrée gérer cela ; le CLI force la prévisualisation des lots volumineux)
Erreur 4 : Édition de watchlist.json avec des outils Write/Edit
- FAUX : Éditer
~/.signalradar/config/watchlist.jsonavec des outils Write/Edit - CORRECT : Utilisez les commandes CLI
signalradar.py add,remove,config
Erreur 5 : Deviner les valeurs de configuration de mémoire
- FAUX : "Le seuil par défaut est de 5 pp" (sans vérification)
- CORRECT : Exécutez d'abord
signalradar.py config threshold.abs_pp, puis répondez avec la valeur réelle
Erreur 6 : Écrire des scripts compensatoires en dehors de la compétence
- FAUX : Écrire des scripts d'aide en dehors de la compétence, comme
send_alerts_to_telegram.py, pour compenser un comportement manquant - CORRECT : Gardez la surveillance, la planification et la livraison à l'intérieur du contrat compétence/runtime. Si une lacune est réelle, corrigez la compétence elle-même au lieu d'inventer des scripts parallèles
Erreur 7 : Traiter une mise à jour clawhub comme une nouvelle installation sans vérifier les données
- FAUX : Après
clawhub update, supposer que l'utilisateur a perdu toutes les données et traiter l'installation comme fraîche sans vérifier le répertoire de données runtime - CORRECT : Lisez d'abord le répertoire de données utilisateur réel (
~/.signalradar/ouSIGNALRADAR_DATA_DIR) et seulement ensuite décidez si une migration ou une récupération est nécessaire
Erreur 8 : Prétendre que le push est prêt sans vérifier l'URL du webhook
- FAUX : "La surveillance en arrière-plan est active et les alertes seront livrées !" (alors que l'URL du webhook est vide)
- CORRECT : Vérifiez
doctor --output json→ siwebhook_url_configured: false, guidez l'utilisateur pour configurer l'URL du webhook
Erreur 9 : Compresser l'intégration en 3 étapes en une seule exécution
- FAUX : Exécuter les 3 étapes d'intégration en séquence sans montrer aucun résultat à l'utilisateur
- CORRECT : Montrez la sortie de chaque étape à l'utilisateur et attendez sa réponse avant de continuer
Erreur 10 : Prétendre que le push est prêt sans vérifier la route
- FAUX : "Le push en arrière-plan est tout prêt !" (sans vérifier route_ready)
- CORRECT : Vérifiez
schedule --output json→ siroute_ready: false, dites à l'utilisateur que la livraison n'est pas encore armée
Erreur 11 : Prétendre que le push est prêt sans vérifier l'URL du webhook
- FAUX : "La surveillance en arrière-plan est active et les alertes seront livrées !" (alors que l'URL du webhook est vide)
- CORRECT : Vérifiez
doctor --output json→ siwebhook_url_configured: false, guidez l'utilisateur pour configurer l'URL du webhook
Démarrage rapide
# Installer (utilisateurs OpenClaw)
clawhub install signalradar
# Ou cloner directement
git clone https://github.com/vahnxu/signalradar.git && cd signalradar
# 1. Vérification de santé
python3 scripts/signalradar.py doctor --output json
# 2. Ajouter des marchés (configuration guidée ou par URL)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/votre-marche-ici
# 3. La surveillance démarre automatiquement après le premier ajout (toutes les 10 min)
# 4. Vérifier le statut de la planification
python3 scripts/signalradar.py schedule
# 5. Vérification manuelle (simulation)
python3 scripts/signalradar.py run --dry-run --output json
Tâches courantes
Ajouter un marché
python3 scripts/signalradar.py add # Configuration guidée
python3 scripts/signalradar.py add <url-evenement-polymarket> [--category <nom>]
Flux : analyser l'URL → interroger l'API Polymarket → afficher la question du marché + la probabilité actuelle → l'utilisateur confirme → enregistrer la référence.
- Si l'événement a plusieurs marchés (par exemple, différentes tranches de dates), le CLI affiche tous les marchés avec leurs probabilités actuelles avant d'ajouter. Pour les grands événements (>3 marchés), il affiche également un résumé des types et force une confirmation interactive même si
--yesa été passé. - Si certains marchés de l'événement sont déjà surveillés, seuls les nouveaux sont ajoutés.
- Si le marché est réglé/expiré, un avertissement s'affiche mais l'utilisateur peut toujours l'ajouter.
- La catégorie par défaut est
defaultsi elle n'est pas spécifiée. L'utilisateur n'est pas invité à saisir une catégorie. - Lors du tout premier ajout (liste de surveillance vide), une brève explication du concept de référence est affichée.
Lister les surveillances
python3 scripts/signalradar.py list [--category <nom>] [--archived]
Affiche toutes les entrées groupées par catégorie avec une numérotation séquentielle globale. Chaque entrée montre : numéro, question, dernière probabilité connue (à partir du cache de référence local), date de fin.
--archived affiche les entrées précédemment supprimées (conservées pour l'export).
Afficher un marché surveillé
python3 scripts/signalradar.py show <numéro-ou-mot-clé> [--output json]
Recherche un ou plusieurs marchés surveillés par numéro de liste ou mot-clé, récupère la probabilité actuelle et renvoie un instantané en lecture seule sans mettre à jour les références.
Supprimer une surveillance
python3 scripts/signalradar.py remove <numéro>
Affiche le nom de l'entrée et demande une confirmation avant de la supprimer. Les entrées supprimées sont archivées (déplacées vers le tableau archived dans ~/.signalradar/config/watchlist.json) avec tout l'historique conservé.
Exécuter une vérification
python3 scripts/signalradar.py run [--dry-run] [--output json]
Vérifie toutes les entrées actives par rapport à l'API Polymarket. Si le changement de probabilité dépasse le seuil, envoie une alerte via le canal de livraison configuré.
- Les entrées réglées/expirées sont ignorées lors de l'exécution, avec un résumé à la fin : "N entrées réglées, envisagez de les supprimer."
- Lorsque plusieurs marchés déclenchent une alerte dans la même exécution, ils sont listés dans la même notification regroupée par événement.
- Après qu'un HIT est poussé, la référence se met à jour avec la nouvelle valeur de probabilité. Le texte de la notification inclut "référence mise à jour à XX%."
--dry-runrécupère et évalue mais n'écrit aucun état.--output openclawest réservé aux exécutions en arrière-plan de la plateforme. Il émetHEARTBEAT_OKsur les vérifications silencieuses, le texte HIT prêt pour l'utilisateur sur les alertes en temps réel, et le texte du digest lorsqu'un digest planifié est dû et que le canal de livraison principal estopenclaw.
Gérer la planification
python3 scripts/signalradar.py schedule # Afficher le statut actuel
python3 scripts/signalradar.py schedule 10 # Pilote automatique (crontab en premier)
python3 scripts/signalradar.py schedule 10 --driver openclaw # Forcer le cron openclaw
python3 scripts/signalradar.py schedule disable # Désactiver la surveillance
Gérer la configuration
python3 scripts/signalradar.py config # Afficher toute la configuration
python3 scripts/signalradar.py config delivery webhook <url> # Définir le webhook
python3 scripts/signalradar.py config threshold.abs_pp 5 # Seuil : changement absolu de 5 points de pourcentage
python3 scripts/signalradar.py config profile.language zh # Notifications en chinois
Digest hebdomadaire
python3 scripts/signalradar.py digest
Diagnostic
python3 scripts/signalradar.py doctor --output json
Sections développeur
Variables d'environnement
| Variable | Description | Valeur par défaut |
|---|---|---|
SIGNALRADAR_DATA_DIR | Répertoire de données pour les caches et la configuration | ~/.signalradar |
SIGNALRADAR_LOG_LEVEL | Niveau de journalisation | INFO |
Structure du répertoire de données
~/.signalradar/
├── config/
│ └── watchlist.json # Liste de surveillance + configuration
├── cache/
│ ├── baselines.json # Dernières probabilités connues pour chaque marché
│ ├── event_cache.json # Cache des métadonnées des événements
│ ├── app_config.json # Préférences de l'utilisateur (langue des notifications, etc.)
│ ├── openclaw_reply_route.json # (OpenClaw uniquement) Route de réponse capturée pour le push en arrière-plan
│ └── provider_cache.json # Résultats de cache du fournisseur Polymarket
└── logs/
└── signalradar.log # Fichier journal
doctor : vérification de santé complète (JSON)
La commande doctor --output json vérifie la configuration, la connectivité, la liste de surveillance et l'état de la planification en une seule fois, et renvoie un rapport structuré :
{
"watchlist": {
"monitored_count": 8,
"archived_count": 1
},
"connectivity": {
"polymarket_graphql": true,
"polymarket_archive": true
},
"config": {
"threshold": {
"abs_pp": 5
},
"delivery": {
"primary": {
"channel": "webhook"
}
},
"profile": {
"language": "en"
}
},
"schedule": {
"active": true,
"interval_minutes": 10,
"driver": "crontab",
"delivery_status": "webhook_url_missing",
"route_ready": false,
"next_run_eta": "in ~7 minutes"
},
"webhook_url_configured": false,
"suggestions": [
"Configurer l'URL du webhook pour la livraison push : signalradar.py config delivery webhook <URL>"
]
}
Cette commande est le point d'entrée unique pour le diagnostic. Ne devinez pas l'état – exécutez doctor et utilisez les valeurs réelles.
Format de sortie --output openclaw (exécutions en arrière-plan)
Lorsque run est exécuté avec --output openclaw, la sortie change de comportement :
- Aucun HIT → sortie silencieuse (code de sortie 0, pas de sortie standard). Utile comme battement de cœur.
- HIT détecté → Texte du message formaté directement sur la sortie standard.
--yesest implicite car il n'y a pas d'utilisateur interactif. - Digest dû → Texte du digest formaté sur la sortie standard, si le canal principal est
openclaw.
Ce format est conçu pour la messagerie plateforme des bots et n'est pas destiné aux utilisateurs humains ou aux tuyaux automatisés.
Architecture & flux de travail
[crontab] ──exécute──> signalradar.py run --yes --output json
│
▼
Boucle des marchés surveillés
│
├─ Aucun changement → sortie silencieuse (HEARTBEAT_OK)
│
└─ Changement > seuil → deliver_hit()
│
├─ webhook → HTTP POST → Slack / Telegram / Discord
├─ file → ajouter au fichier .jsonl
└─ openclaw → Message plateforme
Principes fondamentaux
-
Zéro dépendance LLM — Une fois configurée, la surveillance s'exécute entièrement via
crontab+ scripts Python. Aucun appel API LLM n'est nécessaire pour les vérifications, réduisant les coûts d'exploitation à zéro. -
Zéro dépendance à une plateforme — Le chemin
webhook+crontabfonctionne sur n'importe quel système *nix, n'importe quel fournisseur de cloud, n'importe quel environnement. Aucune plateforme d'agent spécifique requise pour le fonctionnement de base. -
Portabilité via la norme des fichiers — Toutes les données sont stockées dans
~/.signalradar/en JSON simple. Aucune base de données, aucun service externe. Sauvegardez ce répertoire et vous pouvez migrer vers n'importe quelle machine. -
La CLI est la loi — Toute interaction passe par
signalradar.py. Aucun contournement par édition manuelle de fichiers JSON (sauf toléré pour les utilisateurs humains). Cela garantit la cohérence de l'état et empêche la corruption de données.