signalradar は何をしますか?
配信チャンネル
SignalRadarはアラート送信のための3つの配信アダプタをサポートしています:
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 → メッセージ配信。プラットフォーム依存ゼロ、LLMコストゼロ。
インテントマッピング
ユーザーメッセージを受信した後、このテーブルからコマンドを選択してください。どのインテントにも一致しない場合は、コマンドを実行せず、通常の会話を行ってください。
| ユーザー意図(中国語の一般的な表現) | 英語のインテント | コマンド |
|---|---|---|
| "看看我监控了啥" / "我的列表" / "在追踪哪些" | "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" | Webhook URLの入力をユーザーに促し、config delivery webhook <url> を実行します |
| "通知改中文" / "语言改中文" | "switch to Chinese notifications" | config profile.language zh |
| "好的" / "没事" / "OK" / "知道了" | カジュアルな会話 | コマンドを実行しない |
| "那个 GPT 概率多少了" | "what's the probability of X?" | show <number|keyword> |
重要なルール
CR-01 複数マーケットイベントでは、まず数を報告すること
イベントに複数のマーケットがある場合(>3)、CLIは確認を待つ前に、強制的に数、タイプの要約、マーケットリストを出力します。--yesはこれをスキップできません。エージェントはaddを実行する前に、数とタイプを説明しなければなりません。
CR-02 マーケットを自動追加しないこと ユーザーが明示的にPolymarket URLを提供するか、プリセットから選択する必要があります。自動追加してはいけません。
CR-03 エージェントはデータファイルを直接編集してはいけません
エージェントは~/.signalradar/cache/、~/.signalradar/config/watchlist.json、またはベースラインファイルをWrite/Editツールを使用して編集してはいけません。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になります。エージェントはURLを提案するのではなく、3ステップのonboardフローを開始しなければなりません。
CR-09 オンボーディングは3ステップフロー + Webhookガイダンス(狭い橋の原則)
ボット/エージェントモードでは、新規ユーザーのオンボーディングはonboardサブコマンドを通じて3つのステップで行われます:
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のマーケットを追加する
- 誤り:ユーザーがBitcoin URLを送信 → エージェントが
addを実行し、28のマーケットを静かに追加する - 正しい:「このイベントには28のサブマーケット(14の上昇 + 14の下降)があります。すべて追加しますか、それとも選択しますか?」と報告し、返信を待つ
エラー2:ユーザーが「好的」と言った → エージェントが実行をトリガーし、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ステップのオンボーディングを1回の実行に圧縮する
- 誤り:ユーザーに結果を表示せずに、3つのオンボードステップを順番に実行する
- 正しい:各ステップの出力をユーザーに表示し、次のステップに進む前にユーザーの返信を待つ
エラー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
# または直接クローン
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は以前に削除されたエントリ(エクスポート用に保存)を表示します。
1つの監視マーケットを表示する
python3 scripts/signalradar.py show <number-or-keyword> [--output json]
リスト番号またはキーワードで1つ以上の監視マーケットを検索し、現在の確率を取得し、ベースラインを更新せずに読み取り専用のスナップショットを返します。
監視を削除する
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 cronを強制
python3 scripts/signalradar.py shedule disable # 監視を無効化
--driver auto(デフォルト)は、利用可能な場合はcrontabを、そうでなければopenclaw cronを使用します。スマートコントラクト駆動の監視は現在サポートされていません。
ダイジェストを生成する
python3 scripts/signalradar.py digest [--days 7] [--output json]
指定された日数の間のすべてのHITを期間別(0-10pp、11-20pp、21pp+)に集計し、マークダウン形式のレポートを生成します。
- HITがない場合は空のレポートを返します。
- デフォルトは7日間です。
--days 0は「今日」を意味します。- 間隔部分(例:10-20pp)は期間を示し、パーセンテージではありません。
設定を構成する
python3 scripts/signalradar.py config # 現在の設定をすべて表示
python3 scripts/signalradar.py config threshold.abs_pp 5 # 絶対パーセンテージポイントのしきい値を設定
python3 scripts/signalradar.py config delivery webhook <url> # Webhook URLを設定
python3 scripts/signalradar.py config delivery file ~/alerts.jsonl
python3 scripts/signalradar.py config profile.language zh # 通知言語を中国語に設定
- デフォルトの絶対しきい値は
5パーセンテージポイントです。 deliveryキーの下で配信チャンネルを構成します。deliveryを単独でconfigに渡すと、現在の設定が表示されます。- 言語オプション:
en(英語)、zh(中国語)、ko(韓国語)、ja(日本語)。
ヘルスチェック
python3 scripts/signalradar.py doctor --output json
すべての依存関係が利用可能で、Polymarket APIに到達可能で、設定が有効であることを確認します。doctorをパラメータなしで実行すると、人間が読める出力が得られます。
オンボーディングフロー
python3 scripts/signalradar.py onboard --step preview --output json
python3 scripts/signalradar.py onboard --step confirm --keep 1,3,5 --output json
python3 scripts/signalradar.py onboard --step finalize --output json
3ステップのガイド付きセットアップ:
- プレビュー:利用可能なイベントの提案と用語の説明を表示します。
- 確認:選択したイベントのサブマーケットの詳細を表示し、ベースラインの概念を説明します。
- 確定:ウォッチリストを書き込み、自動監視を有効にし、Webhook設定を促します(必要な場合)。
各ステップは対話的です。ユーザーの返信を待ってから次のステップに進みます。
環境変数
SIGNALRADAR_DATA_DIR:データディレクトリのパスをオーバーライドします(デフォルト:~/.signalradar/)。すべての設定、キャッシュ、ログファイルがここに保存されます。OPENCLAW_API_KEY:OpenClawプラットフォーム機能用。インストール時に自動的に設定されます。SIGNALRADAR_OPENCLAW_CRON:OpenClaw cronモードを強制します。内部使用。