# Troubleshooting and reports

## Download or installation

Open the browser's Downloads panel to check progress. Resume an interrupted transfer if the browser offers it. If the link expires, return to [Computer downloads](https://clawdad.earth/portal/setup) for a fresh link. A missing download may also mean the browser blocked it; allow the requested file download for clawdad.earth and its clawdad-cloud.frg.earth delivery service.

Compare the saved filename and size with **File details** in the portal. To check the SHA-256 after download:

On Mac, run this in Terminal, replacing the quoted path with the actual file:

```sh
shasum -a 256 "/path/to/ClawDad-installer.dmg"
```

On Windows, use PowerShell:

```powershell
Get-FileHash -Algorithm SHA256 "C:\path\to\ClawDad-installer.exe"
```

The full result must match the portal's SHA-256 exactly, ignoring letter case. A mismatch or incomplete file requires another download. The operating system also checks the installer/app's platform signature. Preserve security protections and report an unexpected publisher, damaged-file warning, or signature warning to Cody.

## No phone build or invitation

Check [phone access](https://clawdad.earth/docs/phone). Portal admission, a computer build, and an external phone invitation are separate. A TestFlight message about unavailable builds needs a store/build check; reinstalling the desktop app will not create an invitation.

## Account unavailable

Open Codex or Claude Code directly on the computer. Finish its sign-in if necessary and confirm it works in the intended project. Return to ClawDad to connect/select that account. Include the exact error and provider in a report if it remains unavailable. Keep current conversations and drafts.

## Phone disconnected

Check that the intended host is awake, online, and running ClawDad. Reopen the phone app and check its selected computer. If pairing is required, display and scan a fresh pairing QR. Avoid sharing the QR or deleting account/session data as a troubleshooting shortcut.

## Folder or permission issue

Choose the intended project folder again if the operating system asks for access. Confirm that an external drive is mounted. For Remote Assist, check the host's screen and control permissions. Camera access belongs to the phone's pairing scanner; screen/control access belongs to the computer.

## Send a useful report

Open [Report an issue](https://clawdad.earth/portal/reports/new) and include:

- The computer and phone models, operating systems, ClawDad versions and build numbers.
- Which host/phone pairing you used and which provider/account type was selected.
- The steps immediately before the problem, what you expected, and what happened.
- The approximate time, whether it repeats, and the exact visible error.
- A screenshot or diagnostics excerpt with private data removed.

Use **Copy Diagnostics** in the computer app when available. Review the copied text before attaching it. Remove passwords, tokens, update codes, pairing codes, personal email addresses, private folder paths, customer data, and conversation content. Include only the relevant excerpt. Private reports stay associated with your portal account.

## Keep a versioned guide copy

[Download the setup README](https://clawdad.earth/docs/setup/README.md) and save it with a date if you already have a copy. Your notes are yours to keep. The guide's review date describes its instructions; the portal and installed apps provide the current release versions and availability.