signalradar 是做什麼的?
傳遞渠道
SignalRadar 支援三種傳遞適配器來發送警報:
webhook(建議,可攜式)— HTTP POST 到任何端點(Slack webhook、Telegram Bot API、Discord 等)。可在任何平台上使用。搭配crontab排程時,可在零 LLM 成本、零平台依賴的情況下傳送通知。file— 將警報附加到本機 JSONL 檔案。適合本地記錄或自訂消費。openclaw(僅限 OpenClaw)— OpenClaw 平台訊息傳送。僅在透過 ClawHub 安裝時可用。不可移植到其他平台。
預設傳遞渠道是 webhook。 使用以下指令設定您的 webhook URL:
python3 scripts/signalradar.py config delivery webhook https://your-webhook-url
傳遞路徑(技術細節):
crontab → signalradar.py run --yes --output json → 偵測到 HIT → deliver_hit() → HTTP POST 到 webhook URL → 訊息送達。零平台依賴,零 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 (no arg) → empty watchlist returns ONBOARD_NEEDED, Agent starts onboard flow |
| "删掉第 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 (view status) |
| "现在设置是什么" / "阈值多少" | "what are current settings?" | config (must check actual value) |
| "健康检查" / "能用吗" | "health check" / "is it working?" | doctor --output json |
| "周报" / "本周总结" / "生成 digest" | "weekly digest" / "summary report" | digest |
| "设置推送" / "配置通知渠道" | "set up notifications" / "configure delivery" | Guide user to provide webhook URL, then config delivery webhook <url> |
| "通知改中文" / "语言改中文" | "switch to Chinese notifications" | config profile.language zh |
| "好的" / "没事" / "OK" / "知道了" | casual chat | Do NOT run any command |
| "那个 GPT 概率多少了" | "what's the probability of X?" | show <number|keyword> |
關鍵規則
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 管道使用(冒煙測試、cron 任務、發布前閘道)。讓內建確認機制來處理使用者互動。
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。代理接著必須啟動 3 步驟的 onboard 流程,而不是建議提供 URL。
CR-09 引導流程是一個 3 步驟的流程 + webhook 指引(狹橋原則)
在 Bot/Agent 模式下,新使用者的引導流程透過 onboard 子指令分三步驟進行:
onboard --step preview --output json→ 顯示預設事件列表 + 術語教育(事件/市場)→ 詢問使用者「要移除哪些?」onboard --step confirm --keep <user-selection> --output json→ 顯示子市場細節 + 術語(類別/基準線)→ 詢問「確認新增?」onboard --step finalize --output json→ 寫入監視列表 + 啟用自動監控 → 顯示完成訊息與後續步驟 每個步驟都必須等待使用者回覆後才能繼續。請勿將 3 個步驟壓縮成 1 個。
Webhook 指引(finalize 後):ONBOARD_COMPLETE JSON 包含 webhook_setup 欄位。當 webhook_setup.needed == true 時,代理應主動引導使用者設定 webhook 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"→ 引導使用者設定檔案目標
請勿跨渠道混合診斷。如果傳遞渠道是 webhook,請勿檢查或報告 route_ready — 這與之無關。delivery_status 欄位已考慮到活躍渠道。
已知的 AI 錯誤(請勿重複)
這些錯誤實際發生在生產環境中。代理必須避免它們。
錯誤 1:未事先報告數量就新增 28 個市場
- 錯誤:使用者發送比特幣 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:未檢查 webhook URL 就聲明推送就緒
- 錯誤:「背景監控已啟用,警報將會送達!」(當 webhook URL 為空時)
- 正確:檢查
doctor --output json→ 如果webhook_url_configured: false,引導使用者設定 webhook URL
錯誤 9:將 3 步驟引導流程壓縮成一次執行
- 錯誤:依序執行所有 3 個 onboard 步驟,而不向使用者顯示任何結果
- 正確:向使用者顯示每個步驟的輸出,並在繼續之前等待他們回覆
錯誤 10:未檢查路由就聲明推送就緒
- 錯誤:「背景推送已全部設定完成!」(未檢查 route_ready)
- 正確:檢查
schedule --output json→ 如果route_ready: false,告訴使用者傳遞尚未就緒
錯誤 11:未檢查 webhook URL 就聲明推送就緒
- 錯誤:「背景監控已啟用,警報將會送達!」(當 webhook URL 為空時)
- 正確:檢查
doctor --output json→ 如果webhook_url_configured: false,引導使用者設定 webhook URL
快速入門
# 安裝(OpenClaw 使用者)
clawhub install signalradar
# 或直接 Clone
出錯或無法再繼續進行翻譯