Skip to main content

Personal troubleshooting

The app or Engine does not start​

  1. Confirm you installed the package for the correct platform and architecture.
  2. Restart using the platform's normal app or host command; do not launch internal server files directly.
  3. On a CLI-managed installation, run:
clawuno status
clawuno doctor --check
clawuno doctor --report
  1. Keep the generated diagnostic archive. Review it before sharing because logs can contain filenames, hostnames or service endpoints.

On Windows Desktop, first quit and reopen the app. If the UI opens but the Engine does not, keep %LOCALAPPDATA%\Clawuno and %USERPROFILE%\clawuno intact and collect the Desktop and Engine diagnostics before reinstalling.

The starting screen appears temporarily​

Wait while the Engine is busy. A slow backup or other host operation can delay requests without meaning the process has stopped. Do not repeatedly terminate the app while an operation is still progressing.

Sign-in fails​

Confirm the URL belongs to the intended installation and that browser cookies are allowed. On servers, use the same public origin consistently; switching between IP addresses and hostnames creates separate cookie origins.

If an administrator forgot the password, use operating-system access to create a single-use reset URL valid for 15 minutes:

  • macOS: ~/clawuno/bin/clawuno admin reset-token --new --email ADMIN_EMAIL
  • Windows Desktop: quit Clawuno, open PowerShell as the Windows user who installed it, and run:
$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 "ADMIN_EMAIL"
Remove-Item Env:DATA_ROOT

Open the printed URL on the same trusted computer and set a new password. The command does not reveal the old password. Never post the reset token in Chat or a public support ticket.

A model test fails​

Check the provider, endpoint, model ID and credential. Confirm the host can reach that endpoint. Cloud-provider rate limits and account permissions are separate from Clawuno health.

Office preview or Engine Browser is unavailable​

Open System Settings → Health and inspect managed runtime status. Use the provided repair action for the current generation. Opening a document or Browser tab does not download a missing runtime on demand.

Ask for help​

Include the exact Clawuno version, platform, install type, time of failure, action that failed, and the diagnostic report. Do not send API keys, passwords, setup tokens or complete private documents.