个人版故障排查
App 或 Engine 无法启动
- 确认安装包与操作系统和 CPU 架构一致。
- 使用当前平台正常的 App 或宿主命令重启，不要直接运行内部 server 文件。
- 对 CLI 管理的安装运行：
clawuno status
clawuno doctor --check
clawuno doctor --report
- 保存生成的诊断包。分享前先检查内容，因为日志可能含有文件名、主机名或服务地址。
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。
联系支持时提供什么
提供准确版本、平台、安装类型、失败时间、失败操作和诊断报告。不要发送 API Key、密码、一次性设置 Token 或完整私人文档。