跳转至

Telegram 集成

免费版不提供

免费版 StockClaw 不包含 Telegram 推送。如果你之前绑定过 Telegram,绑定会保留,但不会向其发送任何内容。可以改用手机与浏览器通知。见 费用多少?。

StockClaw 可以把信号推送到你的私人 Telegram 聊天——默认 FLASH 和 ALERT,打开后也包括 NOTE 和 FYI——按你的推送频率(默认每 30 分钟)每个级别合并成一条消息,不会每条信号响一次。级别和频率在 设置 → 提醒级别与频率 里调整;如果你开启了 手机与浏览器通知,它也沿用同一套设置。消息使用你的界面语言(见 语言)。

一次性设置

1. 启动 bot

打开 Telegram,点 @stockclaw_notify_bot,点 Start(或发 /start)。

这一步不可省略

Telegram 不允许 bot 主动发起对话。在你发第一条消息之前,bot 没有权限给你 DM——推送会静默失败并返回 chat not found。

2. 拿到你的 chat id

打开 @userinfobot,发 /start。它会回复类似:

Id: 123456789
First: Kaitao

复制 123456789(只要数字,不要空格)。

3. 在 StockClaw 里绑定

进入 设置 → Telegram 集成。粘贴 chat id,可选填你的 @username(只是装饰——会显示在 "Linked as" 那行),点 Link。

下一次流水线跑出 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。

消息长什么样

每条批量消息带:

  • 一个 header(⚡ 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 被清空。推送立即停止。Telegram 上的 bot 权限保留——后续可以直接重新绑定,不用再 /start bot。

故障排查

没有消息到达:

  • 确认你确实给 bot /start'd 过(步骤 1)。
  • 确认 Celery worker 在跑——流水线任务需要 worker 消费。
  • 信号紧急度有关系:只有在 设置 → 提醒级别与频率 里勾选的级别才会推送(默认 FLASH 和 ALERT)。消息还要等到你的推送频率,频率设为每 4 小时时中间不会有消息。
  • 免打扰时段同样作用于 Telegram:打开 设置 → 免打扰时段 后,你所在时区的开始和结束时间之间不会发送消息,暂缓的信号会在之后随下一条摘要到达。
  • 看你服务器的 worker 日志;搜 [run_user_pipeline] user=<your id>——交付步骤会打印 chat_id 和是否成功。

worker 日志里是 "chat not found":

  • 你的 chat id 是错的,或者这个用户 / 群还没给 bot /start'd 过。

Bot 回了但没信号:

  • 可能是你自选股里一只股都没加,或者今天没有新闻产生 FLASH/ALERT。试着加一个热门 ticker,比如 NVDA,等两个 Beat 周期(约 40 分钟)。