O que signalradar faz?
Canais de Entrega
O SignalRadar suporta três adaptadores de entrega para enviar alertas:
webhook(recomendado, portátil) — HTTP POST para qualquer endpoint (webhook do Slack, API do Telegram Bot, Discord, etc.). Funciona em qualquer plataforma. Quando emparelhado com agendamentocrontab, entrega notificações com custo zero de LLM e zero dependência de plataforma.file— Anexa alertas a um arquivo JSONL local. Bom para registro local ou consumo personalizado.openclaw(apenas OpenClaw) — Mensagens da plataforma OpenClaw. Disponível apenas quando instalado via ClawHub. Não portátil para outras plataformas.
O canal de entrega padrão é webhook. Defina sua URL de webhook com:
python3 scripts/signalradar.py config delivery webhook https://sua-url-de-webhook
Caminho de entrega (detalhe técnico):
crontab → signalradar.py run --yes --output json → HIT detectado → deliver_hit() → HTTP POST para URL do webhook → mensagem entregue. Zero dependência de plataforma, custo zero de LLM.
Mapeamento de Intenções
Após receber uma mensagem do usuário, escolha um comando desta tabela. Quando nenhuma intenção corresponder, NÃO execute nenhum comando — apenas converse normalmente.
| Intenção do usuário (expressões comuns em chinês) | Intenção em inglês | Comando |
|---|---|---|
| "看看我监控了啥" / "我的列表" / "在追踪哪些" | "list my monitors" / "what am I tracking" | list |
| "有啥变化吗" / "检查一下" / "跑一下" | "any changes?" / "run a check" | run |
| "帮我加一下 [URL]" / "监控这个链接" | "add this market" / "monitor this" | add <url> |
| "帮我加几个市场" / "想监控但没链接" | "add markets" (sem URL) | add (sem argumento) → watchlist vazia retorna ONBOARD_NEEDED, Agente inicia fluxo 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 (ver status) |
| "现在设置是什么" / "阈值多少" | "what are current settings?" | config (deve verificar o valor real) |
| "健康检查" / "能用吗" | "health check" / "is it working?" | doctor --output json |
| "周报" / "本周总结" / "生成 digest" | "weekly digest" / "summary report" | digest |
| "设置推送" / "配置通知渠道" | "set up notifications" / "configure delivery" | Guie o usuário a fornecer URL do webhook, depois config delivery webhook <url> |
| "通知改中文" / "语言改中文" | "switch to Chinese notifications" | config profile.language zh |
| "好的" / "没事" / "OK" / "知道了" | conversa casual | NÃO execute nenhum comando |
| "那个 GPT 概率多少了" | "what's the probability of X?" | `show <number |
Regras Críticas
CR-01 Eventos com múltiplos mercados devem relatar a contagem primeiro
Se o evento tiver vários mercados (>3), a CLI força a impressão da contagem, resumo do tipo e lista de mercados antes de aguardar confirmação; --yes não pode pular isso. O Agente ainda deve explicar a contagem e os tipos antes de executar add.
CR-02 Nunca adicionar mercados automaticamente O usuário deve fornecer explicitamente uma URL do Polymarket ou escolher entre predefinições. Não adicione automaticamente.
CR-03 O Agente não deve editar arquivos de dados diretamente
O Agente não deve editar ~/.signalradar/cache/, ~/.signalradar/config/watchlist.json ou arquivos de linha de base usando ferramentas Write/Edit. Use apenas comandos CLI. Execuções normais automaticamente escrevem neles — esse é o comportamento esperado. (Nota: o usuário humano pode editar manualmente o watchlist.json — o sistema tolera isso. Esta regra restringe apenas o Agente.)
CR-04 Sem --yes em conversas humanas
Ao interagir com um usuário humano, o Agente NÃO deve usar a flag --yes. A flag --yes é apenas para pipelines automatizados/CI (testes de fumaça, cron jobs, gates de pré-publicação). Deixe a confirmação embutida lidar com a interação com o usuário.
CR-05 Sempre verificar os valores de configuração reais
Quando o usuário perguntar sobre as configurações atuais, SEMPRE execute signalradar.py config primeiro. Não adivinhe ou lembre de memória. Se um valor estiver ausente, relate o padrão e declare "este é o valor padrão".
CR-06 Ativar monitoramento automaticamente após a primeira adição (crontab primeiro, com portão de rota)
Após a primeira add ou onboard finalize, o monitoramento em segundo plano tenta ativar automaticamente (intervalo de 10 minutos). Prefere crontab do sistema; cai para openclaw cron apenas quando crontab não está disponível. Portão de rota: quando delivery.primary.channel == openclaw + driver crontab + sem rota de resposta capturada, a CLI ativa o monitoramento, mas retorna um aviso route_missing porque as verificações podem ser executadas enquanto a entrega de chat em segundo plano não está pronta. O Agente NÃO deve perguntar "devo configurar o cron?" e NÃO deve criar jobs manualmente. Verifique delivery_status em schedule --output json e relate honestamente se o monitoramento e a entrega estão ativos. Combinação recomendada: agendamento crontab + entrega webhook = custo zero de LLM + zero dependência de plataforma.
CR-07 Usar CLI para gerenciar configurações e agendamento
Use signalradar.py config [chave] [valor] para configurações (threshold, canal de entrega, etc.). Use signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] para frequência de monitoramento. Não edite manualmente arquivos JSON de configuração.
CR-08 Watchlist vazia aciona integração
Quando a watchlist está vazia e o Agente executa add/run --output json, a resposta será ONBOARD_NEEDED. O Agente deve então iniciar o fluxo onboard de 3 etapas, não sugerir fornecer uma URL.
CR-09 Integração é um fluxo de 3 etapas + orientação de webhook (princípio da ponte estreita)
No modo Bot/Agente, a integração de novos usuários passa pelo subcomando onboard em três etapas:
onboard --step preview --output json→ mostrar lista de eventos predefinidos + educação de terminologia (evento/mercado) → perguntar ao usuário "quais remover?"onboard --step confirm --keep <seleção-do-usuário> --output json→ mostrar detalhes do sub-mercado + terminologia (categoria/linha de base) → perguntar "confirmar adição?"onboard --step finalize --output json→ escrever watchlist + ativar monitoramento automático → mostrar conclusão + próximos passos Cada etapa deve aguardar a resposta do usuário antes de prosseguir. Não comprima as 3 etapas em 1.
Orientação de webhook (após finalize): O JSON ONBOARD_COMPLETE contém o campo webhook_setup. Quando webhook_setup.needed == true, o Agente deve proativamente guiar o usuário a configurar uma URL de webhook para entrega push em segundo plano. Forneça exemplos de URL da API do Telegram Bot / Slack / Discord. Após o usuário fornecer a URL, execute config delivery webhook <URL>.
CR-10 Push em segundo plano requer uma rota de resposta capturada
--push em segundo plano no caminho crontab requer uma rota de resposta armazenada (~/.signalradar/cache/openclaw_reply_route.json). Se estiver ausente, NÃO afirme que a entrega em segundo plano está funcionando. Para entrega openclaw, verifique schedule --output json para delivery_status e route_ready.
CR-11 Verificar o status real antes de afirmar prontidão de push (ciente do canal)
Antes de dizer ao usuário que o push em segundo plano está funcionando, verifique schedule --output json → campo delivery_status:
"ready"→ push está funcionando para o canal de entrega atual"webhook_url_missing"→ guie o usuário a executarconfig delivery webhook <URL>"route_missing"→ relevante apenas para o canal openclaw; se o usuário estiver no webhook, este campo não aparecerá"file_target_missing"→ guie o usuário a definir o destino do arquivo
NÃO misture diagnósticos entre canais. Se o canal de entrega for webhook, NÃO verifique ou relate route_ready — é irrelevante. O campo delivery_status já leva em conta o canal ativo.
Erros Conhecidos de IA (NÃO repita)
Estes erros realmente ocorreram em produção. O Agente deve evitá-los.
Erro 1: Adicionar 28 mercados sem relatar a contagem primeiro
- ERRADO: Usuário envia URL do Bitcoin → Agente executa
adde adiciona 28 mercados silenciosamente - CORRETO: Informar "Este evento tem 28 sub-mercados (14 alta + 14 baixa). Adicionar todos ou escolher?" → aguardar resposta
Erro 2: Usuário diz "好的" → Agente aciona run e gera NO_REPLY
- ERRADO: Usuário diz "好的" → Agente executa
signalradar.py run→ responde "NO_REPLY" - CORRETO: "好的" é um reconhecimento casual. Responda normalmente sem executar nenhum comando.
Erro 3: Usar --yes em conversa humana
- ERRADO:
signalradar.py add <url> --yes(pula confirmação em chat humano) - CORRETO:
signalradar.py add <url>(deixe a confirmação embutida lidar; a CLI força pré-visualização de grandes lotes)
Erro 4: Editar watchlist.json com ferramentas Write/Edit
- ERRADO: Editar
~/.signalradar/config/watchlist.jsoncom ferramentas Write/Edit - CORRETO: Usar comandos CLI
signalradar.py add,remove,config
Erro 5: Adivinhar valores de configuração de memória
- ERRADO: "O limite padrão é 5pp" (sem verificar)
- CORRETO: Execute
signalradar.py config threshold.abs_ppprimeiro, depois responda com o valor real
Erro 6: Escrever scripts compensatórios fora da skill
- ERRADO: Escrever scripts auxiliares fora da skill, como
send_alerts_to_telegram.py, para compensar comportamento ausente - CORRETO: Mantenha monitoramento, agendamento e entrega dentro do contrato skill/runtime. Se uma lacuna é real, corrija a própria skill em vez de inventar scripts paralelos
Erro 7: Tratar atualização clawhub como instalação nova sem verificar dados
- ERRADO: Após
clawhub update, assumir que o usuário perdeu todos os dados e tratar a instalação como nova sem verificar o diretório de dados do runtime - CORRETO: Leia o diretório de dados real do usuário primeiro (
~/.signalradar/ouSIGNALRADAR_DATA_DIR) e só então decidir se migração ou recuperação é necessária
Erro 8: Afirmar prontidão de push sem verificar URL do webhook
- ERRADO: "O monitoramento em segundo plano está ativo e os alertas serão entregues!" (quando a URL do webhook está vazia)
- CORRETO: Verifique
doctor --output json→ sewebhook_url_configured: false, guie o usuário a configurar a URL do webhook
Erro 9: Comprimir integração de 3 etapas em uma única execução
- ERRADO: Executar todas as 3 etapas do onboard em sequência sem mostrar nenhum resultado ao usuário
- CORRETO: Mostre a saída de cada etapa ao usuário e aguarde sua resposta antes de prosseguir
Erro 10: Afirmar prontidão de push sem verificar rota
- ERRADO: "Push em segundo plano está configurado!" (sem verificar route_ready)
- CORRETO: Verifique
schedule --output json→ seroute_ready: false, diga ao usuário que a entrega ainda não está armada
Erro 11: Afirmar prontidão de push sem verificar URL do webhook
- ERRADO: "O monitoramento em segundo plano está ativo e os alertas serão entregues!" (quando a URL do webhook está vazia)
- CORRETO: Verifique
doctor --output json→ sewebhook_url_configured: false, guie o usuário a configurar a URL do webhook
Início Rápido
# Instalar (usuários OpenClaw)
clawhub install signalradar
# Ou clonar diretamente
git clone https://github.com/vahnxu/signalradar.git && cd signalradar
# 1. Verificação de integridade
python3 scripts/signalradar.py doctor --output json
# 2. Adicionar mercados (configuração guiada ou por URL)
python3 scripts/signalradar.py add
python3 scripts/signalradar.py add https://polymarket.com/event/seu-mercado-aqui
# 3. Monitoramento inicia automaticamente após a primeira adição (a cada 10 min)
# 4. Verificar status do agendamento
python3 scripts/signalradar.py schedule
# 5. Verificação manual (dry-run)
python3 scripts/signalradar.py run --dry-run --output json
Tarefas Comuns
Adicionar um mercado
python3 scripts/signalradar.py add # Configuração guiada
python3 scripts/signalradar.py add <url-do-evento-polymarket> [--category <nome>]
Fluxo: analisar URL → consultar API do Polymarket → mostrar pergunta do mercado + probabilidade atual → usuário confirma → registrar linha de base.
- Se o evento tiver vários mercados (por exemplo, diferentes faixas de data), a CLI mostra todos os mercados com suas probabilidades atuais antes de adicionar. Para eventos grandes (>3 mercados), também mostra um resumo do tipo e força confirmação interativa mesmo se
--yesfoi passado. - Se alguns mercados do evento já estão sendo monitorados, apenas os novos são adicionados.
- Se o mercado foi liquidado/expirado, um aviso é mostrado, mas o usuário ainda pode adicioná-lo.
- A categoria padrão é
defaultse não especificada. O usuário não é solicitado a informar a categoria. - Na primeira adição (watchlist vazia), uma breve explicação do conceito de linha de base é mostrada.
Listar monitores
python3 scripts/signalradar.py list [--category <nome>] [--archived]
Mostra todas as entradas agrupadas por categoria com numeração sequencial global. Cada entrada mostra: número, pergunta, última probabilidade conhecida (do cache de linha de base local), data de término.
--archived mostra entradas removidas anteriormente (preservadas para exportação).
Mostrar um mercado monitorado
python3 scripts/signalradar.py show <número-ou-palavra-chave> [--output json]
Pesquisa um ou mais mercados monitorados por número da lista ou palavra-chave, busca a probabilidade atual e retorna um snapshot somente leitura sem atualizar as linhas de base.
Remover um monitor
python3 scripts/signalradar.py remove <número>
Mostra o nome da entrada e pede confirmação antes de remover. Entradas removidas são arquivadas (movidas para o array archived em ~/.signalradar/config/watchlist.json) com histórico completo preservado.
Executar uma verificação
python3 scripts/signalradar.py run [--dry-run] [--output json]
Verifica todas as entradas ativas na API do Polymarket. Se a mudança de probabilidade exceder o limite, envia alerta pelo canal de entrega configurado.
- Entradas liquidadas/expiradas são ignoradas durante a execução, com um resumo no final: "N entradas liquidadas, considere remover."
- Quando vários mercados disparam na mesma execução, eles são listados na mesma notificação agrupados por evento.
- Após um HIT ser enviado, a linha de base é atualizada para o novo valor de probabilidade. O texto da notificação inclui "linha de base atualizada para XX%."
--dry-runbusca e avalia, mas não escreve nenhum estado.--output openclawé reservado para execuções em segundo plano da plataforma. EmiteHEARTBEAT_OKem verificações sem alterações, texto HIT pronto para o usuário em alertas em tempo real e texto de resumo quando um resumo agendado está devido e o canal de entrega principal éopenclaw.
Gerenciar agendamento
python3 scripts/signalradar.py schedule # Mostrar status atual
python3 scripts/signalradar.py schedule 10 # Driver automático (crontab primeiro)
python3 scripts/signalradar.py schedule 10 --driver openclaw # Forçar cron openclaw
python3 scripts/signalradar.py sched