常见问题
故障排查与解决方案。
1常见问题速查
回复为空或混乱
可能原因：认证错误或模型选择错误。
解决：重新运行 hermes model 确认配置。
网关启动但无人能发消息
可能原因：Bot Token 或权限配置不完整。
解决：重新运行 hermes gateway setup。
--continue 找不到旧会话
可能原因：切换了配置文件或会话未保存。
解决：检查 hermes sessions list。
模型不可用或异常回退
可能原因：路由或回退设置过于激进。
解决：先关闭路由，保持基础提供商稳定。
hermes: command not found
解决：重新加载 shell：source ~/.bashrc 或检查 PATH。
API key not set
解决：运行 hermes model 配置提供商，或手动设置：hermes config set OPENROUTER_API_KEY your_key
2故障排查流程
1. hermes doctor
→
2. hermes model
→
3. hermes setup
→
4. hermes sessions
建议先确保基础对话正常工作，再添加网关、定时任务、技能、语音或路由等功能。