常见问题排查

排查 OpenHuman 时，不要同时改很多变量。先确认桌面端能启动，再确认 Core 连接，再确认模型，再看记忆和集成。

启动问题

先看官方安装来源是否正确，系统权限是否放行，杀毒或安全软件是否拦截。Windows 用户尤其要确认 PowerShell 执行策略、路径空格和管理员权限。

模型问题

如果模型无响应，先用最简单的问题测试 API Key、Base URL、模型名和网络。再测试流式输出、工具调用和长上下文。不要在模型连接不稳定时调试记忆系统。

记忆问题

如果记忆没有写入，检查 Vault 路径、文件权限、工作区位置和后台任务状态。先用一个测试 Vault 复现，避免污染主知识库。

集成问题

OAuth 失败通常与回调域名、浏览器登录态、组织策略或网络连通性有关。每次只测试一个集成，并记录授权范围和撤销入口。