跳到主要内容
版本:0.8.4

个人版故障排查

App 或 Engine 无法启动​

  1. 确认安装包与操作系统和 CPU 架构一致。
  2. 使用当前平台正常的 App 或宿主命令重启,不要直接运行内部 server 文件。
  3. macOS 使用安装目录中的 CLI:
~/clawuno/bin/clawuno status
~/clawuno/bin/clawuno doctor --check
~/clawuno/bin/clawuno doctor --report
  1. 保存生成的诊断包。Linux Docker 则收集状态和近期日志;其宿主管理器没有 doctor,也不会生成上述诊断包:
sudo clawuno status
sudo clawuno logs

命名实例需要在每条 Linux 命令上增加 --instance NAME。分享所有诊断信息前先检查内容,因为日志可能含有文件名、主机名或服务地址。

Windows Desktop 应先正常退出并重新打开 App。如果界面能打开但 Engine 无法启动,请保持 %LOCALAPPDATA%\Clawuno 和 %USERPROFILE%\clawuno 不变,并在重新安装之前收集 Desktop 与 Engine 诊断信息。

偶尔出现启动画面​

Engine 执行耗时操作时先等待。备份等宿主操作可能暂时延迟请求,但不代表进程已经停止。不要在操作仍有进展时反复强制退出 App。

无法登录​

确认网址属于目标安装,并允许浏览器保存 Cookie。服务器部署应始终使用同一个公开 origin;IP 地址和域名会形成不同的 Cookie origin。

管理员忘记密码时,使用操作系统权限生成一个 15 分钟有效、只能使用一次的重置网址:

  • macOS:~/clawuno/bin/clawuno admin reset-token --new --email 管理员邮箱
  • Windows Desktop:退出 Clawuno,以安装 Clawuno 的 Windows 用户打开 PowerShell,然后运行:
$engine = "$env:LOCALAPPDATA\ClawunoDesktop\current\engine"
$env:DATA_ROOT = "$env:USERPROFILE\clawuno\data"
& "$engine\runtime\node.exe" "$engine\bin\admin-cli.js" reset-token --new --email "管理员邮箱"
Remove-Item Env:DATA_ROOT

在同一台可信电脑上打开输出的网址并设置新密码。命令不会显示旧密码。不要把重置 token 发进 Chat 或公开支持工单。

模型测试失败​

检查服务商、Endpoint、模型 ID 和凭据,并确认宿主机可以访问该 Endpoint。云模型的限流、账号权限和 Clawuno 本身是否健康是不同问题。

Office 预览或 Engine Browser 不可用​

进入 系统设置 → 系统健康 查看受管 Runtime 状态,使用当前 generation 提供的修复入口。打开文件或 Browser 标签时不会临时下载缺失的大型 Runtime。

系统缓存正在准备或提示数据不完整​

缓存在后台静默准备,不在聊天列表显示缓存提示,也不阻止进入 Clawuno 和设置页面。缓存不可用时,打开的工作区仍可显示能够读取的对话。系统设置中的「数据不完整」提示表示部分记录无法确认,统计暂不可用不代表历史记录为零。

管理员可进入 系统设置 → 系统健康 → 系统缓存 检查或重建。此操作不修改原始对话或权限。提示持续存在时,请保留数据并收集诊断信息;反复重建无法修复损坏的源文件。若无法安全确认已有任务的运行状态,新任务仍可能暂不可用。

联系支持时提供什么​

提供准确版本、平台、安装类型、失败时间、失败操作和诊断报告。不要发送 API Key、密码、一次性设置 Token 或完整私人文档。