跳到主要内容

故障排除

本指南帮助您诊断和解决 OpenHuman 的常见问题。

应用问题​

应用无法启动​

  1. 检查系统要求（Node.js >= 18.0.0，4GB+ RAM）
  2. 检查可用磁盘空间（需要 2GB+）
  3. 重启应用
  4. 检查日志 ./logs/openhuman.log

性能缓慢​

  1. 关闭其他应用以释放内存
  2. 减少已连接集成的数量
  3. 检查网络连接是否稳定
  4. 尝试切换到更快的模型

内存使用过高​

  1. 在设置中降低同步频率
  2. 限制索引数据源的数量
  3. 启用本地 AI 以减少云 API 调用

连接问题​

无法连接到服务器​

  1. 检查您的互联网连接
  2. 验证 API 端点是否可访问： 
    curl -I https://api.tinyhumans.ai/health
  3. 检查防火墙是否阻止连接
  4. 尝试使用其他网络

OAuth 登录失败​

详见登录故障排除获取详细的 OAuth 故障排除步骤。

数据问题​

数据未同步​

  1. 检查设置中是否启用了自动获取
  2. 验证集成凭证是否有效
  3. 检查同步间隔设置
  4. 尝试手动同步

搜索不工作​

  1. 如果使用自托管搜索，请检查 SearXNG 设置
  2. 验证网络连接
  3. 尝试重新生成搜索索引

安装问题​

npm 安装失败​

# 清除 npm 缓存
npm cache clean --force

# 重新安装
rm -rf node_modules package-lock.json
npm install

权限被拒绝​

在 Linux/Mac 上，您可能需要：

sudo npm install -g openhuman-sdk

获取帮助​

如果您继续遇到问题：

  1. 查看常见问题页面
  2. 搜索现有 GitHub 问题
  3. 在 Discord 上提问

下一步​