跳到主要内容
版本:0.8.5

个人版故障排查

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 诊断信息。

macOS 0.8.4.1 及更早版本在更新或下次启动时,可能提示 Cannot inspect process,此后 Engine 一直没有启动,重新打开 App 也一样。请先通过菜单栏图标退出 Clawuno,再从官网下载页获取当前 DMG,覆盖安装现有 App。0.8.5 及更高版本会在首次启动时完成被中断的更新,并保留 ~/clawuno 中的数据。请勿删除 ~/clawuno,也不要重置 App 偏好设置。

从 macOS 0.8.4.1 或更早版本更新时,如果提示“未能安全完成本机 Engine 的更新准备,尚未安装更新”,说明本次更新没有安装,当前版本会继续运行,数据不受影响。请再次选择 Clawuno → Check for Updates,通常再试一次即可成功。如果多次失败,请按上文用当前 DMG 覆盖安装。

偶尔出现启动画面​

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

页面卡住或内容没有更新​

在桌面 App 中重新载入页面:macOS 选择 显示 → 重新载入页面(⌘R);Windows 选择 视图 → 重新载入页面(Ctrl+R 或 F5)。只刷新当前窗口,并停留在原来的页面。焦点在浏览器标签页内时,快捷键不会刷新 Clawuno 页面,请改用菜单。

刷新会丢弃尚未发送的输入和尚未保存的文件修改,请先保存。如果 Engine 暂时无法连接,当前页面会保留并显示连接提示,待 Engine 恢复后再刷新即可。启动画面和连接页面上不能使用该命令,连接页面有自己的 重试。

无法登录​

确认网址属于目标安装,并允许浏览器保存 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 和设置页面。缓存不可用时,打开的工作区仍可显示能够读取的对话。无法确认的记录不会出现在列表和统计中,其余数据照常显示,系统设置的系统缓存中会提示有记录需要处理。缓存仍在准备时,统计显示为准备中,而不是 0。

管理员可进入 系统设置 → 系统健康 → 系统缓存 检查或重建。此操作不修改原始对话或权限。提示持续存在时,请保留数据并收集诊断信息;反复重建无法修复损坏的源文件。损坏的历史记录不会阻断无关的新任务;执行上限依据当前运行任务,不依赖历史状态或缓存完整性。损坏的对话本身仍可能无法使用。无法安全分配运行资源时,会明确提示任务未启动,而不是连接中断。

联系支持时提供什么​

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