跳到主要内容

团队与企业版故障排查

排查顺序​

  1. 确认准确的实例、版本、宿主机和时间段。
  2. 检查 Engine 与 Scheduler 进程或容器是否存在。
  3. 检查磁盘、内存、inode 和端口归属。
  4. 阅读该实例自己的 Engine、Scheduler 和容器日志。
  5. 先在宿主机本地测试 Engine，再排查反向代理。
  6. 分别测试登录、一个只读页面和一次小型模型请求。

不要拿生产实例当测试环境，也不要为了让启动继续而删除锁、journal 或备份。

CLI 管理的诊断​

宿主 CLI 支持时运行：

clawuno status
clawuno doctor --check
clawuno doctor --report

诊断报告只是证据，不代表可以自动执行 Level 2 修复或数据相关操作。

反向代理问题​

如果本地正常而远程异常，应检查 HTTPS origin 转发、WebSocket/流式响应、请求大小与超时限制，以及 Cookie origin 是否一致。不能仅仅因为耗时操作延迟了一次 HTTP 响应，就让代理健康检查重启 Engine。

管理员密码丢失时，请按恢复管理员账号操作。该流程需要宿主机权限，不需要也不应该手工编辑认证 JSON。

升级支持时提供的材料​

提供准确版本与平台、部署形态、脱敏配置、相关时间段日志、复现步骤和诊断报告。分享前移除凭据、一次性设置 Token 和客户内容。