手机端无ai回复时，问题大概率出在消息网关未运行、一步api配置错误、通知权限受限、第三方平台权限缺失或ssl证书验证失败。需依次验证gateway状态、api base url与密钥、手机通知设置、飞书/微信机器人权限，并排查ssl证书问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功启动 Hermes Agent 并完成微信或飞书等消息通道接入，但手机端始终无法收到 AI 的任何回复，则问题大概率出在消息网关未正常转发、模型服务未正确对接或客户端通知机制被系统拦截。以下是解决此问题的步骤：
一、验证消息网关是否持续运行
Hermes 依赖本地运行的 gateway 进程接收并分发消息；若该进程意外退出或未启动，手机端将完全收不到响应。
1、在终端中执行 hermes gateway status，确认输出显示 “running” 状态；
2、若显示 “not running” 或报错，执行 hermes gateway start 尝试手动启动；
3、启动后立即运行 hermes gateway logs --tail=20，检查最近日志中是否存在 “connected to weixin” 或 “listening on port XXXX” 类提示；
4、若日志中频繁出现 “Connection refused” 或 “timeout”，说明网关无法连通后端服务，需进入第二步排查。
二、确认一步 API 配置已生效且可通信
Hermes 本身无内置模型，所有 AI 回复均来自外部 API；若配置缺失、密钥失效或 Base URL 错误，会导致请求静默失败，手机端无任何反馈。
1、执行 hermes setup --show，核对输出中的 provider 是否为 “Custom endpoint (OpenAI compatible)”；
2、检查 base_url 字段是否严格等于 https://yibuapi.com/v1（注意末尾无斜杠、无空格）；
3、检查 api_key 是否以 sk- 开头且长度完整（共 48 位字符）；
4、手动测试 API 连通性：运行 curl -H "Authorization: Bearer YOUR_API_KEY" https://yibuapi.com/v1/models（将 YOUR_API_KEY 替换为实际值），确认返回 HTTP 200 及 JSON 列表。
三、检查手机端通知权限与后台保活状态
即使消息已由 Hermes 处理完毕，若手机系统阻止应用推送通知或强制杀掉后台进程，用户仍无法感知回复。
1、华为/荣耀设备：进入 设置 > 通知和状态栏 > 应用通知管理 > Hermes Agent，确保“允许通知”、“锁屏通知”、“横幅通知”全部开启；
2、iOS 设备：进入 设置 > 通知 > Hermes Agent，启用“允许通知”，并确认“声音”“标记”“横幅”均未关闭；
3、Android 全系：进入 设置 > 应用 > Hermes Agent > 电池 > 电池优化，将该应用设为“不优化”；
4、在 iOS 上，打开 设置 > 通用 > 后台 App 刷新，确保 Hermes Agent 开关为开启状态。
四、排查飞书/微信客户端侧配置异常
部分通道需在第三方平台侧完成机器人权限配置，若缺失关键权限（如“发送消息”“读取群消息”），Hermes 虽能接收事件，但无法执行回复动作。
1、飞书机器人：登录 飞书管理后台 > 工作台 > 机器人 > 编辑对应机器人 > 权限管理，确认已勾选“发送消息”和“接收消息”；
2、微信扫码登录后：在终端中运行 hermes weixin list，确认输出中账户状态为 “active” 且 “last_seen” 时间距当前不超过 5 分钟；
3、若使用微信网页版协议，检查手机微信是否弹出“登录其他设备”提示并完成授权；未完成则 Hermes 无法获取会话密钥；
4、飞书端若长期无响应，进入 飞书开发者后台 > 事件订阅，确认订阅地址 URL 响应码为 200，且加密验证已通过。
五、检查 SSL 证书验证失败导致连接中断
部分企业网络或代理环境会替换 HTTPS 证书，导致 Hermes 与一步 API 或飞书网关建立 TLS 连接时因证书链不可信而静默断连，表现为无错误日志、无响应。
1、在终端中执行 curl -v https://yibuapi.com/v1/models，观察输出末尾是否含 “SSL certificate problem: unable to get local issuer certificate”；
2、若存在该提示，临时绕过验证（仅用于诊断）：设置环境变量 export NODE_TLS_REJECT_UNAUTHORIZED=0；
3、重新启动 gateway：执行 hermes gateway restart；
4、若此时手机端恢复响应，即可确认根因为 SSL 证书验证失败，需联系网络管理员添加根证书或部署可信代理。
