故障排查

更新后无法启动

重启，在启动菜单中选择上一个条目。如果没有出现启动菜单，开机时按住 Shift（或按 Esc）。进入系统后，把上一个部署设为默认：

sudo bootc rollback

然后报告这个问题，以便下次更新修复。

更新后出现故障

用同样的方法回滚，看问题是否消失，并在报告里写明：这说明问题是更新引起的。

智能体没有被识别

检查智能体服务是否在运行：

systemctl status agentd
agentctl ps

程序只有在通过网关调用模型后，才会被识别为 AI 智能体。如果它使用自己的密钥和端点，见自带密钥的程序。

模型调用失败

• 检查 Model Gateway 中是否至少配置了一个来源，以及密钥是否有效。
• 检查这个智能体是否已用完配额（agenttop）。
• 使用本地模型时，检查本地推理服务是否在运行。

桌面变卡

运行 agenttop，看哪些智能体占用的 CPU、内存和 I/O 最多，以及当前使用的是哪种调度策略。如果是调度策略运行异常，系统会自动回退到默认策略；请在报告中提及。

为报告收集信息

sudo bootc status > kleinia-report.txt
uname -r >> kleinia-report.txt
journalctl -b -p warning --no-pager >> kleinia-report.txt

分享前请通读这个文件，删除隐私内容：API 密钥、主机名、含有姓名的路径。