コンテンツにスキップ

Telegram 連携

無料版にはありません

Telegram への配信は StockClaw の無料版には含まれません。以前に Telegram を連携していた場合も連携は残りますが、何も送られません。代わりにスマホ・ブラウザ通知を使えます。料金はいくらですか? をご覧ください。

StockClaw はシグナルをあなたの個人 Telegram チャットにプッシュできます——デフォルトは FLASH と ALERT、オンにすれば NOTE と FYI も——プッシュ頻度(デフォルトは 30 分ごと)に合わせてレベルごとに 1 メッセージにまとめるので、シグナルごとに通知されることはありません。レベルと頻度は 設定 → アラートのレベルと頻度 で変更でき、スマホ・ブラウザ通知 をオンにしている場合も同じ設定が使われます。メッセージはアプリの表示言語で届きます(言語 を参照)。

一度だけのセットアップ

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 に届きます。

グループチャット

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

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

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

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

メッセージの見え方

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

  • ヘッダー(⚡ StockClaw AI — FLASH または 🔔 — ALERT)とシグナル数。
  • シグナルごとのブロック:選んだ言語の要約、影響ティッカーのバーチャート(影響度 % と関連の種類付き)、影響度/確信度の値、個別レイテンシ付きのエージェント内訳。
  • ソース URL。
  • signal id(先頭 8 文字、サポート / デバッグ用)。

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

言語

Telegram メッセージはアプリの表示言語で届きます。設定 → 表示 またはヘッダーの言語メニューで選んだ言語です。アカウントに保存されるため、スマホ、パソコン、すべての通知(Telegram、スマホ・ブラウザ通知、メール)が同じ言語になり、どの端末で切り替えても全体が切り替わります。

  • 英語: 英語のみです。中国語の情報源からのシグナルに英語の要約がない場合は、中国語の見出しを表示する代わりに、対象のティッカーとレベルを示してアプリを開くよう案内します。中国語の情報源名は省かれ、リンクはエンコードされた形で送られます。
  • 簡体字 / 繁体字中国語: 中国語の要約と中国語のラベルです。
  • 日本語 / 韓国語: ラベルは選んだ言語です。要約は送信時に翻訳され、翻訳できない場合は英語になります。

レベル名(FLASH、ALERT、NOTE、FYI)とエージェント名はどの言語でもそのままです。

連携解除

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

トラブルシューティング

メッセージが届かない:

  • ボットを実際に /start しましたか(ステップ 1)。
  • Celery ワーカーは動いていますか——パイプラインタスクを消費するワーカーが必要です。
  • シグナルの緊急度が重要です:設定 → アラートのレベルと頻度 でチェックしたレベルだけがプッシュされます(デフォルトは FLASH と ALERT)。メッセージはプッシュ頻度も待つので、4 時間ごとのダイジェストならその間は何も届きません。
  • サイレント時間は Telegram にも効きます:設定 → サイレント時間 がオンなら、あなたのタイムゾーンでの開始から終了までは何も送られず、保留したシグナルはその後の次のダイジェストで届きます。
  • サーバーのワーカーログを見て、[run_user_pipeline] user=<your id> を検索——配信ステップが chat_id と成功を印字します。

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

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

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

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