OpenHuman 常见问题与故障排查 — 安装配置报错怎么办

安装问题

安装后打不开

原因：系统版本过低、缺少运行依赖、安装包损坏。

解决：

Windows：检查 Windows 10+，安装最新 Visual C++ 运行库
macOS：检查 macOS 12+，在安全设置中允许打开
Linux：检查 kernel 5.x+，安装 WebKit2GTK
重新下载最新版本安装包

命令行安装脚本报错

原因：网络问题、缺少 curl/bash。

解决：确认已安装 curl 和 bash。如果网络受限，在 GitHub Releases 手动下载安装包。

界面显示英文

OpenHuman 自动检测系统语言。如果系统是中文但界面显示英文，在设置中手动切换语言。

连接问题

OAuth 授权页面打不开

原因：内置浏览器被防火墙阻止。

解决：在 OpenHuman 设置中复制授权链接，手动在外部浏览器打开。

集成连接后显示断开

原因：OAuth token 过期。某些服务（如 Gmail）的 token 有效期有限。

解决：断开后重新连接。OpenHuman 会自动刷新 token，但极少数情况需要手动重连。

同步问题

Auto-fetch 不工作

原因：软件在后台被系统休眠、内存不足被系统回收。

解决：在系统电源设置中阻止 OpenHuman 休眠。手动触发同步看是否正常。

Memory Tree 数据过多

原因：长时间使用积累了太多记忆。

解决：在设置中清理历史记忆，或调整 max_token_budget 降低每条记忆大小。

模型问题

模型无响应或超时

原因：模型 API 网络问题、Key 过期、本地模型未启动。

解决：检查网络连接。确认 API Key 未过期。如果使用 Ollama，确认 ollama serve 正在运行。

模型回答质量差

原因：使用了不合适的模型或配置参数不当。

解决：尝试更换模型（DeepSeek 或 Qwen 中文效果更好）。在 config.toml 中调高 temperature 获得更有创造力的回答。

性能问题

OpenHuman 占用内存过高

原因：多个第三方集成同时同步、Memory Tree 数据量大。

解决：减少连接的集成数。降低 Auto-fetch 频率。清理不必要的历史记忆。

吉祥物动画卡顿

原因：GPU 资源不足。

解决：在吉祥物设置中降低画质或关闭动画。笔记本用户建议插电使用。

其他问题

如何卸载 OpenHuman？

OpenHuman 是标准桌面应用：Windows 在设置中卸载；macOS 从 Applications 移到废纸篓；Linux 执行对应包管理器的卸载命令。

数据存在哪？

Memore Tree 数据：~/.openhuman/memory/（或系统对应路径）。配置文件：config.toml。日志：~/.openhuman/logs/。