Telegram 整合¶
免費版不提供
免費版 StockClaw 不包含 Telegram 推送。如果您之前連結過 Telegram,連結會保留,但不會傳送任何內容。可以改用手機與瀏覽器通知。見 費用多少?。
StockClaw 可以把訊號推送到您個人的 Telegram 聊天——預設 FLASH 和 ALERT,開啟後也包括 NOTE 和 FYI——依您的推送頻率(預設每 30 分鐘)每個級別聚合成一則訊息,所以不會每條訊號各 ping 您一次。級別和頻率在 設定 → 提醒級別與頻率 裡調整;如果您開啟了 手機與瀏覽器通知,它也沿用同一套設定。訊息使用您的介面語言(見 語言)。
一次性設定¶
1. 啟動 bot¶
打開 Telegram,點擊 @stockclaw_notify_bot,按 Start(或傳送 /start)。
這一步不能跳過
Telegram 不允許 bot 主動開啟對話。在您傳送第一則訊息之前,bot 沒有權限私訊您——推送會默默失敗並回傳 chat not found。
2. 取得您的 chat id¶
打開 @userinfobot 並傳送 /start。它會回覆類似這樣的內容:
複製那串 123456789(只要數字,不要空格)。
3. 在 StockClaw 綁定¶
前往 設定 → Telegram 整合。貼上 chat id,可選填 @username(純裝飾——會顯示在「Linked as」那行),點 綁定。
下一次跑流程只要有 FLASH / ALERT 訊號,就會送達您的 Telegram。
群組聊天¶
想讓 bot 貼到共用群組(家庭投資組合、團隊頻道)嗎?
- 建立群組(或用現成的)。
- 把
@stockclaw_notify_bot加為成員。 - 請任一位管理員在群組內傳送
/start@stockclaw_notify_bot——跟 DM 同樣規則。 - 群組的 chat id 是負數(例如
-1001234567890)。要找到它,把群組任一則訊息轉傳給 @userinfobot,它會回覆該群組的Forwarded fromid。 - 把那個負數 id 貼到 StockClaw。運作方式完全一樣。
兩個帳號、一個聊天¶
沒有什麼擋得住兩個 StockClaw 帳號綁到同一個 chat id——這就是「家庭共用聊天」模式。兩位使用者的訊號都會匯進同一個 Telegram 聊天。如果他們自選股有重疊,同一則新聞事件可能產生兩條訊號(每帳號一條),於是變成兩則 Telegram 訊息。如果您不介意重複就沒事;如果想看「是誰觸發的」標籤,請開 issue。
訊息長什麼樣¶
每則批次訊息都帶有:
- 標頭(
⚡ StockClaw AI — FLASH或🔔 — ALERT)和訊號數量。 - 每條訊號的區塊,包含您所選語言的摘要、受影響 ticker 的長條圖(帶影響度 % 和關聯類型)、影響度 / 信心度數值、以及智慧代理詳情附個別延遲。
- 原始新聞的 URL。
- Signal id(前 8 碼,供 support / debug 使用)。
儀表板的訊號卡片有一個視覺對應版本——刻意做得類似。
語言¶
Telegram 訊息使用您的介面語言,也就是您在 設定 → 顯示 或頁首語言選單裡選的語言。它儲存在您的帳戶中,所以手機、電腦和所有通知(Telegram、手機與瀏覽器通知、電子郵件)都用同一種語言;在任何一台裝置上切換,其他裝置都會跟著改變。
- 英文: 只有英文。來自中文來源的訊號如果沒有英文摘要,訊息會寫明涉及的 ticker 和級別並請您打開應用程式查看,而不是顯示中文標題。中文來源名稱會省略,連結以編碼後的形式傳送。
- 簡體 / 繁體中文: 中文摘要和中文標籤。
- 日文 / 韓文: 標籤使用您的語言;摘要在傳送時翻譯,翻譯失敗時退回英文。
級別名稱(FLASH、ALERT、NOTE、FYI)和智慧代理名稱在所有語言裡保持不變。
解除綁定¶
設定 → Telegram 整合 → Unlink。您 user_settings 那列的 telegram_chat_id 會被清成 null。推送立刻停止。Telegram 上的 bot 權限仍保留——之後要重新綁定不需要再 /start 一次。
疑難排解¶
完全收不到訊息:
- 確認您真的對 bot 按過 /start(步驟 1)。
- 確認 Celery workers 有在跑——pipeline tasks 需要 worker 來消耗。
- 訊號的緊急程度有關:只有在 設定 → 提醒級別與頻率 裡勾選的級別才會推送(預設 FLASH 和 ALERT)。訊息還要等到您的推送頻率,頻率設為每 4 小時時中間不會有訊息。
- 勿擾時段同樣作用於 Telegram:開啟 設定 → 勿擾時段 後,您所在時區的開始和結束時間之間不會傳送訊息,暫緩的訊號會在之後隨下一則摘要送達。
- 去看 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 分鐘)。