使用电报机器人操作 MoviePilot 时，最容易让人走弯路的不是“记不住命令”，而是把不同版本、不同聊天场景和不同权限下的行为混为一谈。有人在群里发了私聊时有效的命令，却认定机器人坏了；有人照着旧教程输入命令，结果当前版本根本没有对应功能。本文不罗列一份可能过时的命令清单，而是从常见误区与避坑角度，带你用一套可验证的流程定位问题。
先纠正一个误区：MoviePilot命令不一定人人相同
电报机器人MoviePilot命令的可用范围，可能受到 MoviePilot 版本、启用的功能或插件、机器人配置，以及当前用户权限影响。不同部署环境的命令菜单也可能不同。因此，网上看到的命令示例只能作为线索，不能直接视为你当前实例的标准答案。特别是涉及搜索、订阅、管理或下载操作的命令，具体名称和参数应以你自己的机器人帮助信息及部署配置为准。
建议先在与机器人私聊时发送 /start，再尝试 /help 或电报界面中的命令菜单。若帮助信息列出了命令，按它给出的拼写、参数顺序和提示操作；若没有列出某项功能，不要反复换着写法猜测，更应检查对应功能是否启用、当前账号是否有权限，以及使用的教程是否适用于你的版本。
避坑一：群聊里的命令，可能并没有真正发给机器人
许多人在私聊测试成功后，把同一条命令复制到群组，随后遇到电报机器人没反应。这里首先要排除的不是 MoviePilot 故障，而是消息路由问题：群里可能有多个机器人，命令需要明确指定目标机器人；机器人也可能受群组隐私模式、群成员权限或群组绑定设置影响，无法读取普通文本。
用最小测试区分“没收到”和“不会执行”
- 先在机器人私聊窗口发送一个帮助或启动类命令，确认机器人是否能回复。
- 再到目标群组，按电报客户端提供的命令提示选择机器人对应的命令，或按照实际提示指明机器人。
- 如果私聊正常、群聊无响应，重点检查机器人是否已加入该群、群内权限和隐私设置，而不是先修改 MoviePilot 的媒体目录或下载器配置。
- 如果私聊和群聊都没有回复，再检查机器人令牌、服务运行状态及日志。
这套对照测试能把问题快速分成两类：消息没有到达机器人，或消息到达后没有被 MoviePilot 正确处理。两类问题的排查位置不同，盲目重启全部服务往往只会掩盖线索。
避坑二：命令菜单不等于功能已经配置完成
电报里的命令菜单主要帮助用户查看和发送命令，它不一定能证明后端功能已完整配置。菜单里能看到某个入口，不代表 MoviePilot 已经配置好媒体源、下载器、通知渠道或所需权限；反过来，菜单没有显示某个命令，也不一定代表所有相关功能都不可用，仍需以当前版本的帮助信息和实际配置为准。
遇到命令提示权限不足、参数错误或执行失败时，先保留机器人返回的原文，再核对三件事：第一，命令是否来自当前版本的帮助信息；第二，参数是否按提示填写，是否遗漏必填项；第三，当前 Telegram 用户是否被配置为允许操作的用户。不要为了“让它能用”就把机器人随意设为群管理员，或扩大整套服务的访问权限；只授予完成任务所必需的权限，并优先在私聊中测试管理操作。
避坑三：照抄示例时，别忽略配置和参数上下文
命令示例经常省略环境前提。例如，某个搜索或订阅操作可能依赖已配置的媒体来源，某个通知动作可能依赖消息目标已绑定。命令格式即使完全正确，前置服务不可用时也可能失败。实用做法是把问题拆成“命令识别、权限验证、功能配置、外部服务”四层，逐层核实，而不是连续尝试不同参数。
一份更稳妥的命令检查清单
- 核版本：确认所参考的说明与当前 MoviePilot 版本和启用组件相符。
- 核拼写：检查斜杠、命令名称、空格和参数，不要把示例中的说明文字也一起复制。
- 核场景：区分私聊、群聊和不同群组；先在私聊完成基础验证。
- 核身份：确认当前 Telegram 账号属于允许操作的用户，且机器人有必要的聊天权限。
- 核依赖：检查命令所需的服务或功能是否已配置，而不仅是机器人是否在线。
- 核日志：在发送命令的同一时间查看 MoviePilot 日志，确认请求有没有进入服务以及失败发生在哪一环。
电报机器人没反应时，按顺序排查更省时间
“电报机器人没反应”不等于一定是命令写错。先发送基础帮助命令并观察是否有任何回复；然后检查机器人服务是否运行、Telegram 网络连接和令牌配置是否正常。若基础命令有响应，只有某一个操作失败，问题更可能与该操作的参数、权限或依赖配置有关。若所有命令都无响应，再结合服务日志检查消息是否被接收、是否出现认证错误或连接异常。
排查时记录发送时间、聊天类型、命令原文和机器人返回内容，比只说“它不工作”更有用。分享日志或截图前，应遮盖机器人令牌、个人标识及可能包含隐私的消息内容，避免把凭据公开到论坛或群聊。
关于隐私：机器人会保存你发的消息吗？
“电报机器人会储存你的消息吗”没有适用于所有 MoviePilot 部署的统一答案。消息可能经过 Telegram、机器人服务以及具体部署者的日志或存储设置；实际保留范围取决于系统实现和管理配置。不要把机器人私聊等同于绝对不留痕，也不要向机器人发送密码、令牌、家庭住址等不必要的敏感信息。若你是部署者，应查看日志级别、日志保留策略和相关存储配置；若你是使用者，应向机器人管理者确认数据处理方式。
“电报机器人怎么用”与自动对话：先分清自动回复和MoviePilot任务
如果你想了解电报机器人怎么用，最稳妥的起点是私聊启动、查看帮助、选择菜单中确实存在的操作，再根据提示逐项测试。至于“电报机器人怎么添加自动对话”，它通常涉及电报平台的机器人命令设置、机器人服务逻辑或额外的自动化组件，并非仅在 MoviePilot 中输入一条命令就必然完成。先明确你想实现的是关键词自动回复、任务结果通知，还是定时推送，再查对应组件的配置说明；不要把自动回复规则与 MoviePilot 的媒体处理命令混为一谈。
最后的避坑原则：少猜命令，多做对照
使用 MoviePilot Telegram 机器人时，推荐按照“私聊验证基础响应—查看当前帮助—确认账号权限—检查功能依赖—对照日志”的顺序操作。不要把旧教程里的命令当作永久标准，不要因为群聊无响应就直接授予过高权限，也不要把命令菜单出现误认为后端配置已经完成。把场景、版本和错误信息说清楚，往往比记住更多命令更能解决问题。