安装指南
三步在你的 Telegram 群组中设置好 X Bot。大多数团队三分钟内即可完成安装；繁重的工作都由向导替你完成。
最快上手方式 —
@BWS_X_Bot→ 添加到群组 →/setup→ 🚀 快速开始。接下来的四个提示就是你需要的一切。
开始之前，先准备好这 5 项内容
在开始之前，请准备好以下内容：
关于下方每个配置项的逐屏介绍，请参见 /setup 菜单。
| 你需要 | 从哪里获取 |
|---|---|
| 一个 Telegram 账号 | telegram.org |
| 某个 Telegram 群组的管理员权限 | 如果没有，可以新建一个：Telegram → 新建群组 |
| 你想追踪的 X 账号、cashtag 或关键词 | 例如 @your_username、$YOUR_TOKEN、"#YourCampaign" |
| （可选）项目 Logo + URL 列表 | 用于公开的 xbot.ninja 展示页 |
| （可选）时区偏好 | 计划时间以 UTC 表示；请选择一个能与社区活跃时段对应的 UTC 小时数 |
不确定自己需要哪种套餐？查看 定价 — 大多数团队从 FREE 套餐（每月 100 条帖子）开始，之后再升级。
如果你不确定哪个场景适合自己，可以先浏览 概览页面的 4 个使用场景——选择最接近的一个，并在下方第二步中参考它的筛选建议。
第一步 — 将机器人添加到你的群组
- 打开 Telegram，搜索 @BWS_X_Bot。
- 将机器人添加到你的群组。
- 将其提升为管理员。除默认管理员权限外无需任何特殊权限（机器人需要管理员身份，仅仅是为了让 Telegram 允许它读取群消息并发布报告）。
群组，而非私聊
机器人的分析功能仅在群组中运行，不支持私聊。如果你与 @BWS_X_Bot 发起私聊，只有 /help 和 /buy 能正常使用，大部分配置菜单都不可用。
第二步 — 运行 /setup
在你的群组中输入：
/setup机器人会回复一个交互式菜单。点击 🚀 快速开始 打开四步向导。
向导会按顺序提出四个问题：
| 步骤 | 提示内容 | 示例 |
|---|---|---|
| 1 | 项目名称 | MyToken、KOL Campaign Q2、@your_username Performance |
| 2 | 在 X 上追踪什么 | 📢 账号 + 账号名、💵 Cashtags + 代码、或 🔍 关键词 + 短语 |
| 3 | 机器人何时运行 | 选择一个每日预设时间（UTC 09:00 / 14:00 / 18:00 / 22:00）或发送自定义时间 |
| 4 | 完成 | 已保存内容的回顾 |
跳过和退出随时可用——一个未完成的向导不会阻塞你，未设置的选项只会保留默认值。
为什么要用
/setup？ 它把每一条管理员命令都封装成一个可点击、可原地编辑的界面，让你无需记忆命令。设置会即时保存。资深用户依然可以直接输入斜杠命令——两种方式完全等效，行为完全一致。完整介绍见 /setup 菜单。
第三步 — 验证
向导完成后，打开 /setup → 📊 报告 → ⚡ 立即生成报告，即可立刻发送一份报告（下一次的计划报告将在你在第二步中选定的时间运行）。
机器人会在约 1–3 分钟内将排行榜图片发布到群组中。较小的群组（账号数量少、帖子量低）完成得更快；需要抓取数百条帖子的社区群组可能需要 2–3 分钟。
等待首次计划运行
在手动执行「立即生成报告」之后，下一次自动运行会在你配置的 cron 时间发生。每次触发只会产生一份报告——不会重复发送。
费用与积分
X Bot 的所有数据抓取都使用官方 X API。每个群组都从 FREE 套餐开始；在此基础上你可以叠加使用以下一种或两种付费方案：
| 套餐 | 你需要支付 | 涵盖内容 |
|---|---|---|
| FREE | $0 | 每月 100 条帖子的硬性上限。机器人在达到 100 条时暂停抓取；每月 1 日重置。 |
| PRO 订阅（Stripe） | 每月 $19 + 每月超出 1000 条部分每条 $0.02（Stripe 按量计费） | 自动续费。每月前 1000 条帖子作为免费门槛计入（不是可累积的积分余额——不会结转）。 |
| PRO credits（ETH） | 每积分 $0.02，可购买 1000 / 2000 / 3000 / 4000 / 5000 / 10000 / 50000 / 100000 积分的礼包 | 一次性购买。积分永不过期，会叠加到现有余额上。 |
一个群组可以同时拥有 PRO·订阅 和 PRO·credits——按次抓取计费时，优先扣减 ETH credits，然后是订阅的每月额度，最后才是按量计费的超额部分。完整的套餐切换矩阵和购买流程见定价。
套餐与余额随时可在 /setup → 💳 购买积分 中查看。当积分用到 80% 以及完全耗尽时，指定的管理员会收到 Telegram 私信提醒。
按使用场景推荐的后续步骤
选择与你的场景匹配的一行，然后按照链接进入概览页面查看完整方案：
| 场景 | 向导完成后需要补充什么 | 详情 |
|---|---|---|
| KOL 代理机构追踪 5 位 KOL | 补充 Cashtag + 活动 hashtag，设置 UTC 22:00 的计划时间 | 使用场景 1 |
| 项目方吸引社区参与 | 在 🎨 自定义 中设置 Logo + URL，用于公开的 xbot.ninja 展示卡片 | 使用场景 2 |
| 独立 KOL 作品集 | 在自定义中设置个人头像 + LinkedIn URL，将 xbot.ninja URL 分享给潜在客户 | 使用场景 3 |
| 多客户代理机构 | /setup → 🎯 筛选条件 → ⤴ 命名筛选器 → ➕ 添加命名筛选器 — 每位客户一个 | 使用场景 4 |
| 实时接收 X 账号的帖子 | /setup → 📡 X 帖子自动转发 → ➕ 添加账号 | /setup 菜单 |
需要配置的内容
| /setup 中的部分 | 你需要设置的内容 | 为什么重要 |
|---|---|---|
| 🎯 筛选条件 | 要在 X 上追踪的账号、cashtag、关键词、提及 | 决定机器人抓取哪些帖子 |
| ⏰ 计划 | 自动报告的每日发送时间 | 机器人按此 cron 执行抓取和渲染 |
| 📊 报告与时间段 | 可选的日期窗口（例如竞赛周期） | 将报告限定在特定时间段内 |
| 🎨 自定义 | 项目名称、描述、Logo、URL、排行榜权重与颜色 | 决定报告图片和公开 xbot.ninja 展示页的品牌形象 |
| 👥 管理员 | 谁会收到关于积分 / 抓取问题的私信 | 运营可见性 |
| 💳 订阅 | 套餐、积分余额、升级入口 | 费用可见性与付款 |
| 📡 自动转发 | 实时转发到群组中的 X 账号（每 5 分钟一次） | 在计划报告之间提供实时更新 |
公开展示页（可选）
如果你的项目达到了公开列表门槛（当月 ≥ 300 最高分、≥ 5 条帖子、≥ 2 名活跃用户），它就会出现在 xbot.ninja 上。请在 /setup → 🎨 自定义 中添加项目元数据（名称、描述、Logo、URL）。
独立 KOL 的设置（单账号）无法满足「≥ 2 名活跃用户」这条规则，只能通过其直接 URL 访问——这是有意为之的设计。
验证安装
大多数诊断信息都能直接在 /setup 中看到（每个界面顶部都会显示群组的当前状态）。快速自检清单：
| 检查项 | 方法 |
|---|---|
| 机器人是管理员 | Telegram → 群组设置 → 管理员 |
| 已配置追踪内容 | /setup → 🎯 筛选条件 → 查看账号 / cashtag / 关键词列表 |
| 筛选条件渲染正确 | /setup → 🎯 筛选条件 |
| 已设置计划时间 | /setup（菜单顶部显示当前计划） |
| 有可用积分 | /setup → 💳 购买积分 |
| 手动生成报告可用 | /setup → 📊 报告 → ⚡ 立即生成报告 |
首份报告未出现 — 故障排查
如果「立即生成报告」在 3 分钟内没有产生任何发布内容：
| 症状 | 可能原因 | 解决方法 |
|---|---|---|
| 机器人私信提示「未找到帖子」 | 筛选条件过窄，或近期没有匹配的帖子 | /setup → 🎯 筛选条件 — 检查实际的 X API 查询是否有拼写错误。尝试放宽条件（如已设置日期区间，可先移除）。 |
| 机器人私信提示「积分已耗尽」 | FREE 群组达到了每月 100 条上限 | 等待下月重置，或 /setup → 💳 购买积分 → 💰 购买以订阅套餐或购买积分包 |
| 没有任何反应，也没有私信 | 机器人不是管理员，或 webhook 已停止 | 重新将机器人提升为管理员。如果仍无反应，请联系支持。 |
| 图片已渲染但文字为空 | AI 点评生成超时 | 重新运行；这是暂时性问题。如持续出现，请联系支持——AI 服务提供商偶尔会出现临时性故障。 |
| 出现「Unauthorized」/「Forbidden」错误 | X API 令牌问题（运营方问题） | 请联系支持；此问题用户无法自行解决。 |
自助诊断
/setup → ℹ️ 关于 会在一个界面中展示你的群组 ID、套餐和计划时间。将这段文字复制到任何支持请求中，可将排查时间缩短约 80%。
常见安装问题 FAQ
问：我可以将机器人安装到 Telegram 频道（而非群组）吗？ 不可以，仅支持群组和超级群组。频道不支持消息回复上下文，而报告流程需要用到它。
问：我可以在带有话题的论坛式群组中运行机器人吗？ 可以。在你想要接收报告的话题内发送 /set_topic。此后机器人会将报告发到该话题；如果未设置，则发到主聊天区。
问：机器人需要读取我群组消息的权限吗？ 机器人只需要接收命令消息（例如 /setup）。它不会读取普通聊天内容。X 侧的数据来自官方 X API，而非你的 Telegram 消息。
问：我可以追踪一个受保护 / 私密的 X 账号吗？ 不可以——X API 只返回公开帖子。追踪受保护账号会静默返回空结果。
问：把机器人从群组移除会删除我的数据吗？ 不会。设置、历史记录、分数和报告都会保留在机器人的数据库中。如果你把机器人重新添加到同一个群组 ID，一切都会恢复。如果你想彻底清除数据，请联系支持。
问：我以后可以修改项目名称吗？ 可以——/setup → 🎨 自定义 → 🏷 名称。会更新下一份报告以及公开的 xbot.ninja URL 短链。
问：为什么我看到的帖子数量与 [某工具] 不同？ X Bot 直接从官方 X API 拉取数据。大多数第三方追踪工具依赖抓取或推算，我们发现实际差异可达 20–50%。X API 的数字才是权威真相。
问：如何取消？
- FREE 群组：直接把机器人从群组中移除即可。
- PRO 订阅：
/setup→ 💳 购买积分 → 🛠 管理订阅 会打开 Stripe 客户门户，你可以在那里取消订阅。取消在当前付费周期结束时生效。 - PRO credits（ETH）：积分不会自动续费——当余额降为零时，群组会自动降级为 FREE。你可以随时移除机器人。
需要帮助？
请参见支持，或在你的群组中打开 /setup → ℹ️ 关于，获取可分享给团队的诊断信息。
在开始配置之前，建议先阅读 X Bot 概览，全面了解每类受众——加密项目方、KOL 代理机构、独立 KOL、投资者——能从机器人中获得什么。