Getting Started
Updating xCloud
How xCloud detects and installs desktop updates.
xCloud checks for desktop updates shortly after the app opens.
The check is silent. It does not interrupt your current work.
Update Flow
- xCloud opens.
- After a few seconds, it checks for a new version.
- If an update exists, the sidebar shows an Update pill.
- Click Update to download and install.
- xCloud relaunches after installation.
During download, the pill shows progress.
Supported Desktop Builds
xCloud Desktop is currently available for:
- macOS Apple Silicon.
- macOS Intel.
Remote engines can run on other machines capable of running OpenClaw, but the desktop control app is macOS-only for now.
Publishing A New Update
For maintainers, the update system depends on the Tauri updater configuration and the release artifacts published for the current platform.
A production release should include:
- The macOS app bundle.
- The updater artifact.
- The updater signature.
- A version higher than the installed version.
- A valid updater endpoint.
If any of those are missing, users will not see the update pill.
Troubleshooting
| Problem | Fix |
|---|---|
| Update button never appears | Confirm the release version is newer than the installed app |
| Download starts then fails | Check network and updater artifact availability |
| Install fails | Confirm the artifact signature matches the updater metadata |
| App relaunches but version did not change | Confirm the correct build was uploaded |