FoneClaw Discord 连接失败：私聊绑定、任务状态与结果恢复
按连接、私聊配对、排队、手机执行和结果发送逐步排查 FoneClaw Discord 问题。了解机器人令牌、十分钟绑定、审批检查，以及如何补发结果而不重复执行任务。
- FoneClaw 的 Discord 入口是机器人文字私聊，不是语音通话。先分清连接失败、消息未进入、请求排队、手机动作受阻和结果发送失败，再决定下一步。
- 创建机器人后启用 Message Content Intent，通过 OAuth2 安装到服务器，将机器人令牌保存到 FoneClaw。配对开始后十分钟内私聊发送 hello，首个发送消息的 Discord 账号会被绑定。
- 用 /status 查看运行与排队数量，再到手机检查实际权限、工具启用和审批状态。连接成功不代表动作完成，保存结果应到待办、日历等目标位置核对。
- /retry 只把已保存结果加入发送队列，不重新运行手机任务；/stop 停止当前和排队请求，但不撤销已完成操作。没有收到回复时，先查手机结果，避免重复写入。
先找出失败发生在哪一步
遇到 FoneClaw Discord 连接失败，先不要重新发送原来的手机任务。我们提供的是 Discord 机器人文字私聊入口：消息进入 FoneClaw 后，由配置模型理解，再按实际工具、权限和审批策略处理。连接、接收请求、排队、执行和返回结果，是不同步骤。
如果手机已经保存了待办或创建了日历事项，只是 Discord 没收到回复，再发一遍原请求可能产生重复记录。先保留原消息、时间和错误提示，再按下面的症状定位。
| 看到的现象 | 先检查哪一步 | 下一步 |
|---|---|---|
| 保存连接时报令牌无效 | 机器人身份验证 | 核对对应机器人的令牌，不重新提交手机任务 |
| 提示消息内容配置错误 | Message Content Intent | 在开发者门户启用后重试连接 |
| 没有完成账号绑定 | 私聊配对 | 检查账号、机器人和十分钟窗口 |
| 请求排队或队列已满 | 任务队列 | 查看 /status，不连续追加相同请求 |
| 手机提示等待审批或缺少权限 | 动作执行 | 到手机处理对应要求，确认任务实际状态 |
| 手机有结果，Discord 没回复 | 结果发送 | 检查可恢复结果，再考虑 /retry |
如果问题其实是 Discord 语音频道中听不到声音、蓝牙音频或麦克风异常，应查看Discord 手机麦克风测试：语音活动、蓝牙没声音与 Android 排查。这些音频设置不是机器人文字连接的修复步骤。
核对机器人令牌与消息内容配置
先对照受支持的设置顺序，确认没有把不同机器人的信息混在一起。Discord 官方机器人设置说明介绍了开发者门户、机器人令牌和 OAuth2 安装；FoneClaw 的连接需要按下面顺序完成。
- 在 Discord 开发者门户创建应用与机器人，确认正在编辑准备连接的那个机器人。
- 启用 Message Content Intent。名称相近的其他选项不能代替它。
- 通过 OAuth2 将机器人安装到服务器，确认安装对象正确。
- 复制该机器人的令牌，粘贴到 FoneClaw 的 Discord 连接设置并保存。
- 按连接页面提示进入配对，再从准备绑定的 Discord 账号打开机器人私聊。
Discord 的 Gateway 与消息内容说明将 Message Content 列为特权意图，需要在开发者门户配置。若平台要求相应审核，应按平台流程处理，不通过增加无关权限绕过要求。安装到服务器也不表示 FoneClaw 接受服务器频道中的任务；这个入口支持的是私聊。
| 连接提示 | 含义与处理 |
|---|---|
| 令牌无效 | Discord 未接受该令牌。核对是否来自正确机器人、是否完整，以及是否仍有效 |
| Message Content Intent 错误 | 启用指定意图并保存，再使用连接页面的重试操作 |
| 连接不可用 | 检查网络、机器人令牌和指定意图，先恢复连接再检查任务 |
这里的连接重试与私聊中的 /retry 不是一回事：前者处理连接，后者处理已保存结果的发送。不要看到“重试”就认为原手机任务会再次执行。
令牌属于秘密凭据，不应出现在截图、聊天求助或日志中。普通排查不需要为了尝试修复而反复重置令牌；若令牌已经泄露，应通过官方开发者门户重置，并更新 FoneClaw 中保存的值。提交诊断信息时只说明核对结果，不附令牌本身。
在十分钟内用正确账号私聊配对
保存令牌并开始配对后，在十分钟内向机器人私聊发送 hello。连接会绑定到首个发送消息的 Discord 账号，因此先确认当前登录的是你打算使用的账号，再发送消息。
有多个 Discord 账号、多人一起设置或多个机器人时，容易出现“消息已经发了，但配对没完成”的情况。要核对的不只是消息文字，还包括发送者、接收机器人以及是否处于配对窗口内。
- 先看账号：确认当前 Discord 账号，而不是只凭熟悉的显示名称判断。
- 再看会话：从正确机器人的资料进入私聊，不能在服务器频道里发送 hello 代替配对。
- 最后看时间：若窗口已过期，从 FoneClaw 重新开始配对，再按新提示发送消息。
如果发现进入了错误会话，停止在那里继续发送。回到 FoneClaw 的配对入口处理，并核对新的绑定结果。已经由错误账号完成绑定时，应先确认应用中的连接与绑定状态，不能仅靠另一个账号再发一句 hello 就假定原绑定被替换。
这一步的完成证据是 FoneClaw 显示相应连接与账号已配对，而不是机器人出现在服务器成员列表，也不是你自己的私聊消息已经显示。配对完成后，再用状态请求检查文字入口。
区分排队、审批与手机执行状态
在已绑定的机器人私聊中发送 /status，查看当前运行和排队的请求数量。它帮助判断队列是否在处理任务，但计数本身不是某个日历事项已经创建的证明。还要到手机查看原请求的具体状态。
| 当前状态 | 应该做什么 | 不能推断什么 |
|---|---|---|
| 有请求正在运行或排队 | 查看原任务并等待，避免追加副本 | 不能认定每个排队请求都已执行 |
| 队列已满 | 等待，或在确实需要停止这些请求时使用 /stop | 不是要求立即重复发送全部请求 |
| 队列正在停止 | 稍后再检查，不连续提交 | 不能把停止中视为已清理完毕 |
| 任务等待审批 | 到手机查看待批准动作并决定 | Discord 已配对不代表该动作已经获准 |
| 动作缺少权限或工具未启用 | 核对实际所需权限和支持范围 | 机器人令牌不能授予安卓动作权限 |
| 手机任务已有结果 | 检查保存位置，再核对 Discord 发送状态 | 没有机器人回复不代表执行失败 |
FoneClaw 中的模型配置、工具启用、安卓权限和审批策略分别生效。模型负责理解与规划，受支持工具负责动作；全局审批模式与单独工具设置决定实际审批行为，不是每项操作都必然弹窗。相关能力可在FoneClaw 功能介绍查看。
例如保存个人待办，要检查事项是否实际出现；没有明确日期时，应保持未安排日期。创建日历事项则要核对必要日期、时间、账号与目标日历。连接恢复只解决消息入口，不会替你补齐这些内容，也不会让不支持的动作自动可用。
若批准后仍没有预期结果，先查看任务是否被拒、仍等待或已经部分执行。不要默认放开全部权限、关闭所有电池限制或重置应用；先处理当前动作显示的具体阻碍。
先恢复结果发送，不重复手机动作
/retry 的作用是把已保存的结果加入发送队列，不是重新运行手机任务。适合使用它的情况，是已有可恢复的发送失败结果，需要尝试把这份结果送回 Discord。进入发送队列也不等于消息已经到达，之后仍需检查实际回复。
下面是一个建议的判断场景，不是实测记录：你通过 Discord 请求创建一项日历事项，手机已完成写入，但 Discord 没显示完成结果。此时应先打开目标日历，核对事项标题、日期、起止时间和保存位置。若记录正确，不要再次发送“创建这项日历事项”。
- 保留原请求和时间，查看手机中的任务结果。
- 打开目标日历，确认已有记录是不是本次创建的正确事项。
- 若存在可恢复的结果发送失败，在已绑定的私聊中使用 /retry。
- 查看命令响应与后续结果消息；不要把已排队发送视为已送达。
- 只有确认原动作没有完成、目标没有新增记录，且请求状态已澄清后，才考虑新的明确请求。
重发原创建请求会把问题从“结果没送到”变成“是否创建了两项”。即使后续发现重复，也要先辨认本次新增记录，再决定处理哪一项，避免删除原有安排。
没有可恢复结果，或连接已经变化
若 /retry 提示没有可恢复的发送失败，含义是当前没有可用于这一恢复操作的已保存失败结果。它不证明手机任务从未执行，也不证明目标记录不存在。继续查看手机任务和目标应用，而不是用原请求代替结果补发。
若提示请求已过期或连接已变化，先核对当前机器人、绑定账号和手机中的原任务结果。结果可能已经存在，但不再能沿当前连接恢复发送。没有核对这些状态前，不要重新配对后一次性重发旧任务。
/stop 停止请求，但不撤销已完成操作
/stop 停止当前和排队请求，不会删除已经创建的日历、撤回已经发送的内容或恢复已经改动的设置。停止后查看队列状态，再检查已发生的结果。FoneClaw 安全说明中的权限与审批边界也应与实际动作一起核对。
需要进一步区分手机任务、后续定时触发与云端运行时，可阅读如何停止 Android AI 智能体：区分手机任务、定时触发与云端运行，不要把一次私聊停止指令当成所有运行环境的总开关。
用小请求验证恢复，并保留诊断信息
恢复后先用不产生手机写入的 /status 检查状态回复。收到当前计数，说明这条状态请求有响应；它不等于所有安卓工具都能执行。若还需要验证普通请求，可以只要求准备一段简短文字，不发送、不保存、不创建日历，再核对手机任务和 Discord 返回内容。
建议按下面顺序收尾，避免为了验证连接而制造更多副作用：
- 确认令牌来源、Message Content Intent 和配对账号，且当前使用机器人私聊。
- 查看 /status，确认不是队列已满或仍在停止。
- 检查原任务的权限、审批和实际结果，不先提交新副本。
- 仅在有可恢复的失败结果时使用 /retry，并观察是否实际送达。
- 完成一个无写入的小请求后，再恢复需要保存或修改的任务。
仍有问题时，保留准确错误文字、发生时间、正在做的步骤、运行与排队数量、手机审批状态，以及目标记录是否已经存在。把“没有收到 Discord 回复”和“手机没有执行”分开描述，排查才不会走错方向。
截图或日志中移除机器人令牌、API 凭据、验证码、完整消息内容及无关联系人信息。提供足以识别失败阶段的内容即可；使用在线模型处理任务时，所提供上下文可能由对应服务处理，不能因为动作在手机侧发生就假定全部内容留在本机。
如果 Discord 入口已恢复，但手机任务仍失败，可继续看手机智能体失败调试与恢复：Android AI 助手根因分析与最小重试手册。若改用 Telegram 私聊入口，应按FoneClaw 连接 Telegram 机器人：BotFather 创建、私聊绑定与故障排查重新核对对应流程，不能复用 Discord 的令牌与配置。
最终要确认的不是一个笼统的“连接正常”，而是正确账号能进入请求、队列状态清楚、手机动作得到核对，以及结果确实返回。缺失哪一步，就处理哪一步。