跳轉到

Telegram 整合

StockClaw 可以把 FLASH 和 ALERT 訊號推送到您個人的 Telegram 聊天——每個流程週期最多聚合成兩則訊息(所有 FLASH 合成一則,所有 ALERT 合成一則),所以不會每條訊號各 ping 您一次。

一次性設定

1. 啟動 bot

打開 Telegram,點擊 @stockclaw_notify_bot,按 Start(或傳送 /start)。

這一步不能跳過

Telegram 不允許 bot 主動開啟對話。在您傳送第一則訊息之前,bot 沒有權限私訊您——推送會默默失敗並回傳 chat not found。

2. 取得您的 chat id

打開 @userinfobot 並傳送 /start。它會回覆類似這樣的內容:

Id: 123456789
First: Kaitao

複製那串 123456789(只要數字,不要空格)。

3. 在 StockClaw 綁定

前往 設定 → Telegram 整合。貼上 chat id,可選填 @username(純裝飾——會顯示在「Linked as」那行),點 綁定。

下一次跑流程只要有 FLASH / ALERT 訊號,就會送達您的 Telegram。

群組聊天

想讓 bot 貼到共用群組(家庭投資組合、團隊頻道)嗎?

  1. 建立群組(或用現成的)。
  2. 把 @stockclaw_notify_bot 加為成員。
  3. 請任一位管理員在群組內傳送 /start@stockclaw_notify_bot——跟 DM 同樣規則。
  4. 群組的 chat id 是負數(例如 -1001234567890)。要找到它,把群組任一則訊息轉傳給 @userinfobot,它會回覆該群組的 Forwarded from id。
  5. 把那個負數 id 貼到 StockClaw。運作方式完全一樣。

兩個帳號、一個聊天

沒有什麼擋得住兩個 StockClaw 帳號綁到同一個 chat id——這就是「家庭共用聊天」模式。兩位使用者的訊號都會匯進同一個 Telegram 聊天。如果他們自選股有重疊,同一則新聞事件可能產生兩條訊號(每帳號一條),於是變成兩則 Telegram 訊息。如果您不介意重複就沒事;如果想看「是誰觸發的」標籤,請開 issue。

訊息長什麼樣

每則批次訊息都帶有:

  • 標頭(⚡ StockClaw AI — FLASH 或 🔔 — ALERT)和訊號數量。
  • 每條訊號的區塊,包含摘要(EN + ZH)、受影響 ticker 的長條圖(帶 impact % 和 link_type)、impact / confidence 數值、以及 5-agent breakdown 附個別延遲。
  • 原始新聞的 URL。
  • Signal id(前 8 碼,供 support / debug 使用)。

儀表板的訊號卡片有一個視覺對應版本——刻意做得類似。

解除綁定

設定 → Telegram 整合 → Unlink。您 user_settings 那列的 telegram_chat_id 會被清成 null。推送立刻停止。Telegram 上的 bot 權限仍保留——之後要重新綁定不需要再 /start 一次。

疑難排解

完全收不到訊息:

  • 確認您真的對 bot 按過 /start(步驟 1)。
  • 確認 Celery workers 有在跑——pipeline tasks 需要 worker 來消耗。
  • 訊號的緊急程度有關:NOTE 和 FYI 只進儀表板,不進 Telegram。只有 FLASH 和 ALERT 會推送。
  • 去看 server 的 worker 日誌,搜尋 [run_user_pipeline] user=<your id>——傳送步驟會印出 chat_id 和成功狀態。

worker 日誌出現 "chat not found":

  • 您的 chat id 錯了,或使用者 / 群組還沒對 bot /start 過。

Bot 有回覆但沒訊號:

  • 您的自選股可能是空的,或今天沒有新聞產出 FLASH / ALERT。試試加一支熱門 ticker 像是 NVDA,等兩個 Beat 週期(約 40 分鐘)。