常见问题
服务无法启动
- 检查端口是否被占用：在终端执行
qodercli status查看服务状态。 - 强制停止后重启：先执行
qodercli stop --force，再执行qodercli start --open。
Waker 无响应
- 确认服务正在运行（浏览器能正常访问 Web Console）。
- 打开「设置」→「网络设置」，点击连通性测试检查模型 API 是否可达。
- 确认 Waker 的 Identity 配置不为空。
WakerFlow 运行卡住
- 在运行记录 Tab 中查看各节点状态。
- 检查是否有
askUser节点等待用户输入。 - 确认目标 Waker 是否存在且可用。
MCP 工具探测失败
- 确认 MCP 服务器进程正在运行。
- 检查传输方式和地址配置是否正确。
- 对需要认证的服务器，确认 OAuth 授权已完成。
网络诊断
在「设置」→「网络设置」中：- 查看各服务端点的连接状态和延迟。
- 点击「测试连接」执行连通性测试。
- 检查代理配置是否正确。
| 问题 | 可能原因 | 解决方式 |
|---|---|---|
| 模型 API 超时 | 代理未配置或配置错误 | 在网络设置中正确填写代理地址 |
| SSL 证书错误 | 系统时间不正确 | 校准系统时间 |
| DNS 解析失败 | 网络环境受限 | 检查 DNS 设置或使用代理 |
| 连接被拒绝 | 服务端口被占用 | 更换端口或释放被占用的端口 |