X Bot 支持：故障排查、FAQ 与联系方式
大多数问题只需一次 /setup 操作就能自行解决。本页的前半部分会带你完成自助诊断流程；后半部分是 FAQ。如果两者都无法解决问题，页面底部的联系表单会直接路由到 BWS 开发者支持渠道。
首先 — 自助诊断流程
Open /setup → ℹ️ About in your chat.
└─ Copy that text. It's everything support needs to triage.
Then ask yourself, in order:
1. Does the bot reply to /setup at all?
├─ No → bot was kicked or demoted from admin → re-promote and retry
└─ Yes → continue.
2. Did /setup → 📊 Reports → ⚡ Generate report now produce something
within 3 minutes?
├─ No DM, no post → check next question.
├─ DM "no posts found" → filter too narrow or no on-topic posts;
/setup → 🎯 Filters to see
the literal X API query.
├─ DM "credit exhausted" → /setup → 💳 Buy Credits → 💰 Buy.
├─ Post landed but image looks wrong → re-fire; if persistent,
contact support with the chat ID.
└─ Post landed correctly → you're fine.
3. Are scheduled reports arriving?
├─ No → /setup top screen shows the cron. Compare to actual UTC time.
The bot's first scheduled fire happens AFTER the next cron tick,
not immediately after setup.
└─ Yes → all good.如果这些都没能帮你找到解决方法，请跳过 FAQ，直接查看下方的联系方式链接。
FAQ
设置与安装
问：我把机器人添加进来后，它没有任何反应。 请确认它已被提升为管理员，而不只是「成员」。Telegram → 群组设置 → 管理员。重新提升是即时生效的；机器人无需重新安装。
问：我可以把机器人移动到另一个群组吗？ 可以——将它添加到新群组，并在那里运行 /setup。两个群组是相互独立的（不同的群组 ID = 不同的设置、计划、分数）。两个群组之间没有数据迁移功能。
问：机器人默认在主聊天区发布报告，但我的群组有话题功能——我可以重定向吗？ 在你想要的论坛话题内，发送：
/set_topic Reports此后的报告都会路由到该话题。使用 /set_topic clear 可重置。
问：我该如何卸载？
- 先停止报告：
/setup→ ⏰ 计划 → ✕ 禁用计划。 - 移除机器人：Telegram → 群组 → 管理员 → 踢出
@BWS_X_Bot。 - 设置会保留在数据库中。将机器人重新添加到同一个群组 ID 会恢复一切。如需彻底删除，请联系支持。
报告与筛选
问：为什么我的数字和第三方追踪工具不一样？ X Bot 直接从官方 X API 拉取数据。大多数第三方追踪工具依赖抓取或推算——我们测量到的差异可达 20–50%。X API 的数字才是权威真相。
问：排行榜上出现了我没有预料到会被追踪的用户。 筛选条件是加法逻辑。如果一个群组追踪 $YOUR_TOKEN cashtag，那么任何发布该 cashtag 的人都会被计入排名，而不仅仅是你列出的那些账号。若要同时要求账号和 cashtag 两个条件，请通过 /set_x_filtering 使用 from:@x cashtags:$YOUR_TOKEN 的形式（命名筛选器中「所有条件皆需满足」的语义）。
问：报告显示「0 posts」——现在该怎么办？ 按可能性从高到低排列，有三种可能：
- 筛选条件过窄 —
/setup→ 🎯 筛选条件 会显示实际的 X API 查询语句。常见的拼写错误：$BTC（末尾多了一个空格）与$BTC。 - 时间段过窄 — 如果你设置了自定义时间段，窗口之外的帖子不会被计入。
/setup→ 📊 报告 → 🗑 清除时间段 会恢复为滚动 24 小时。 - 被追踪的账号在 24 小时内确实没有发布任何主题相关内容 — 可以增加 cashtag 或关键词作为兜底信号来源。
问：我可以追踪一个受保护 / 私密的 X 账号吗？ 不可以——X API 只返回公开帖子。
问：我可以将特定用户从群组排行榜中排除吗（例如垃圾账号）？ 可以：/setup → 🎯 筛选条件 → 🙈 忽略 → ➕ 添加。列出的账号会在抓取后被从结果中剔除。
问：为什么我的群组每天会触发多次报告？ 要么是你设置了多次触发的 cron（cron(0 14,22 ? * * *)），要么是你在同一个计划下运行了多个命名筛选器。每个命名筛选器都会生成自己的报告。
问：「最佳推文」的选择结果感觉怪怪的。 AI 选择器会挑选出互动量最高、且近期没有被选过的帖子。如果结果持续感觉不对，请联系支持——该提示词是可调整的。
X 帖子自动转发
问：转发一次性推送了一个 6 条帖子的 thread。我只想要第一条。 这是因为 X API 的 exclude=replies 只会过滤对其他用户的回复；自我回复（连续帖子）会绕过该过滤。/setup → 📡 X 帖子自动转发 → @账号 → 关闭 ☐ 连续帖子（Thread）。此后机器人只会保留每个 thread 的第一条。
问：转发在当天中途停止了。 请检查单个转发的界面——如果显示 Today: 10/10 forwarded，说明你已达到每日上限。点击 ✏️ 上限 进行调高。上限会在 UTC 午夜自动重置。
问：转发显示 ⏸ 已暂停，但我并没有暂停它。 机器人会在 Telegram 出现群组丢失错误时（被踢出 / 被拉黑 / 群组升级）自动暂停，并停止轮询计划。/setup → 📡 X 帖子自动转发 会显示该行，以便你在重新添加机器人后可以处理。
账单与积分
问：「积分」具体是什么？ 1 积分 = X API 返回的 1 条帖子。FREE 群组每月获得 100 条免费积分；PRO 群组通过 Stripe（订阅）或 ETH（积分包）计费。
问：我在哪里可以看到我的积分余额？/setup → 💳 购买积分。会显示已用 / 剩余 / 重置日期。
问：我刚付了款，但我的余额 / 套餐没有更新。
- Stripe 路径（信用卡订阅）：webhook 通常会在几秒内激活 PRO。如果 5 分钟以上后你在
/setup→ 💳 购买积分 中仍未看到PRO ✓，请携带 Stripe 收据和群组 ID 联系支持。 - ETH 路径（积分包）：链上确认可能需要 1–3 分钟。如果 10 分钟后积分仍未显示，请携带交易哈希和群组 ID 联系支持。
问：我可以在同一个群组上同时拥有 Stripe 订阅 AND ETH credits 吗？ 可以——两者可以叠加。一个已订阅的 PRO·credits 群组会保留其现有的 ETH 余额，按次抓取计费会先扣减 ETH credits，然后才会动用订阅的每月额度。实际效果是：如果你有 5000 个 ETH credits 并订阅了套餐，前 5000 次抓取完全不会触及 Stripe；之后的抓取会使用订阅的每月 1000 条额度；再往后则按 $0.02/条 计费。ETH 余额永不过期。
唯一的限制：一个已经在 PRO·sub 上的群组，无法通过同一购买流程再添加一个新的 ETH 积分包（购买命令会阻止此操作）。如果你想切换回仅使用积分计费，请先取消订阅。
问：当我的 PRO·credits 余额归零时会发生什么？ 该 license 会自动降级为 FREE。机器人会继续在每月 100 条的 FREE 上限内抓取，直到该额度也耗尽。此后下一次 /setup → 💳 → 💰 购买 会重新提供两条路径。
问：积分余额是按群组计算还是按用户计算？ 按群组计算。每个 Telegram 群组都有各自的积分和 license。
公开仪表盘
问：我的项目没有出现在 xbot.ninja 上。 必须在当月同时满足以下三项门槛：
- 最高用户分数 ≥ 300
- 已追踪帖子数 ≥ 5
- 活跃用户数 ≥ 2
第一个月通常是瓶颈所在。直接 URL https://xbot.ninja/?chatId=<your-id> 始终可以正常访问。
问：我该如何查找我的群组 ID？/setup → ℹ️ 关于。以负号开头的长整数。
问：我可以自定义公开的 xbot.ninja 卡片吗？/setup → 🎨 自定义。设置名称、描述、Logo、URL。卡片会在下一次报告周期刷新。
X API 相关问题
问：为什么有些帖子的时间比我预期的更早？ 机器人使用 tweets/search/all（全量归档接口）。当你设置了时间段后，机器人可以抓取该窗口内任意时间点的帖子。默认是滚动 24 小时，但自定义时间段可以回溯到更早的日期。
问：有时候一条帖子要过 5 分钟以上才出现在转发中。 X 帖子自动转发每 5 分钟轮询一次。延迟最多为一个轮询周期（平均约 2.5 分钟 / 最坏情况约 5 分钟），再加上少量 X API 和 Telegram 投递延迟。
问：X API 返回了一个错误——运营者会看到什么？ 内部错误计数器会累加，指定的管理员会收到私信（可在 /setup → 👥 管理员 中配置由谁接收）。常见的 4xx 错误码：401/403（运营方凭据问题）、402（积分已耗尽）、429（限流——机器人会以退避策略重试）。
提交支持请求时应包含的内容
请复制并粘贴以下模板：
Project: <your project name>
Chat ID: <from /setup → ℹ️ About>
Plan: FREE / PRO·credits / PRO·sub
What's wrong: <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke: <approx UTC time>
Recent change: <any new filter / schedule / payment in the last 24 h>仅群组 ID 一项，就能为支持团队提供 80% 的排查信息——请务必附上。
预期响应时间
- 紧急：机器人全平台离线、计费故障 → 欧美工作时段重叠期间 1 个工作小时内响应
- 高：单个群组的报告无法送达 → 当日内响应
- 一般：功能咨询、配置帮助 → 1–2 个工作日内响应
常用链接
- Telegram 机器人： @BWS_X_Bot
- 公开仪表盘： xbot.ninja
- 文档： /docs/
- GitHub issues： blockchain-web-services/bws-api-telegram-xbot
- 直接支持： bws.ninja — 联系表单会路由到 BWS 开发者支持团队
在联系支持之前，请先完成故障排查中的自助诊断流程——大多数问题会在前两项检查中就得到解决。