跳到主要内容
版本:0.8.4

团队与企业版故障排查

排查顺序​

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

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

CLI 管理的诊断​

宿主 CLI 支持时运行:

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

根据诊断报告定位问题。涉及账号或数据的修复,应先备份,再联系管理员或 Clawuno 支持确认处理方式。

反向代理问题​

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

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

升级支持时提供的材料​

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