Telegram 連携¶

StockClaw は FLASH と ALERT のシグナルをあなたの個人 Telegram チャットにプッシュできます——パイプライン実行あたり最大 2 メッセージにまとめて(全 FLASH を統合、全 ALERT を統合)、シグナルごとに通知されないようになっています。

一度だけのセットアップ¶

1. ボットを起動¶

Telegram を開き、@stockclaw_notify_bot をタップして Start を押します(または /start を送信)。

このステップは必須です

Telegram はボットが会話を開始することを許可しません。あなたが最初のメッセージを送るまで、ボットは DM を送る権限を持たず——プッシュは chat not found で静かに失敗します。

2. chat id を取得¶

@userinfobot を開いて /start を送信します。以下のような返答が返ります:

Id: 123456789
First: Kaitao

123456789 をコピー(数字のみ、スペースなし)。

3. StockClaw で連携¶

設定 → Telegram 連携 へ。chat id を貼り付け、任意で @username を追加(装飾用——"Linked as" 行に表示)、連携をクリック。

FLASH/ALERT シグナルが出る次のパイプライン実行で、Telegram に届きます。

グループチャット¶

ボットに共有グループ(家族ポートフォリオ、チームチャネル)へ投稿させたいですか?

グループを作成(または既存のものを使用)。
@stockclaw_notify_bot をメンバーとして追加。
管理者の誰かがグループ内で /start@stockclaw_notify_bot を送信——DM と同じルールです。
グループの chat id は負の数です(例:-1001234567890)。見つけるには、任意のグループメッセージを @userinfobot に転送します。グループの Forwarded from id が返されます。
その負の id を StockClaw に貼り付け。同様に動作します。

2 アカウント、1 チャット¶

2 つの StockClaw アカウントが同じ chat id をリンクすることを妨げるものはありません——「家族共有チャット」パターンです。両ユーザーのシグナルが同じ Telegram チャットにファンインします。ウォッチリストが重複していると、同じニュースイベントが 2 つのシグナル(アカウントごとに 1 つ)を生成し、2 つの Telegram メッセージとして着地する可能性があります。重複があなたにとって問題なければ完了です。「誰がこれをトリガーしたか」ラベルが欲しければ issue を開いてください。

メッセージの見え方¶

各バッチメッセージには以下が含まれます:

ヘッダー(⚡ StockClaw AI — FLASH または 🔔 — ALERT)とシグナル数。
シグナルごとのブロック:要約(EN + ZH)、影響ティッカーのバーチャート(impact % と link_type 付き)、impact/confidence 値、個別レイテンシ付きの 5 エージェント内訳。
ソース URL。
signal id(先頭 8 文字、サポート / デバッグ用)。

ダッシュボードのシグナルカードを視覚的な類似物として参照してください——意図的に似せています。

連携解除¶

設定 → Telegram 連携 → 連携解除。user_settings 行の telegram_chat_id が null 化されます。プッシュは即時停止。Telegram 側のボット権限は残ります——ボットを再起動せずに後で再連携できます。

トラブルシューティング¶

メッセージが届かない:

ボットを実際に /start しましたか(ステップ 1)。
Celery ワーカーは動いていますか——パイプラインタスクを消費するワーカーが必要です。
シグナルの緊急度が重要です:NOTE と FYI はダッシュボードのみ、Telegram には行きません。FLASH と ALERT だけがプッシュされます。
サーバーのワーカーログを見て、[run_user_pipeline] user=<your id> を検索——配信ステップが chat_id と成功を印字します。

ワーカーログに "chat not found":

chat id が間違っているか、ユーザー / グループがまだボットを /start していません。

ボットは応答したがシグナルが来ない:

ウォッチリストにティッカーがないか、今日はニュースが FLASH/ALERT を生成していない可能性があります。NVDA のような人気ティッカーを追加して Beat サイクルを 2 回待ってみてください(約 40 分)。