Connect to a cloud desktop

Connecting the desktop app to a cloud desktop switches your agent backend from your local machine to the remote instance. Once connected, any agents you see, tasks you create, and conversations you have are all running on that cloud desktop.

Before you start

The cloud desktop must be in Online status before you can connect. If it shows a different status, wait for it to reach Online or manage its lifecycle from MultiClaw Cloud.

Connect to a cloud desktop

1. Open the MultiClaw desktop app.
2. Click Instances in the sidebar.
3. Click the cloud desktop you want to connect to.
4. On the detail page, click Connect.

The app authenticates automatically using a secure instance token — you don't need to enter any credentials. When the Connect button changes to Disconnect, the link is established.

Your agents, tasks, and conversation history now reflect what's on the cloud desktop.

Switch back to local mode

1. Open the Instances screen from the sidebar.
2. Click the cloud desktop you are connected to.
3. Click Disconnect on the detail page.

The app reconnects to the OpenClaw gateway running on your local machine. Switching modes does not delete any data — your cloud desktop and local setup each keep their own agents and history.

Automatic reconnection

The desktop app remembers which cloud desktop you last connected to. The next time you open the app, it reconnects automatically if that cloud desktop is running. If it's stopped, the app waits on the connection screen until the instance is available.