Mac install

Install CARAPACE on your Mac.

The Mac app is the guided path for OpenClaw. The setup flow layers CARAPACE on top, keeps old workspace memory intact, and pairs your phone privately over Tailscale.

Recommended: paste-one-prompt setup
Recommended path
1Download the DMG and open CARAPACE.
2Choose OpenClaw in the setup wizard.
3Sign in to Tailscale, choose provider auth, then scan the QR in the iPhone app.
CARAPACE Mac setup wizard
1

Run the Mac wizard

CARAPACE installs and configures OpenClaw plus Tailscale-secured phone pairing.

mac install
Open Carapace-2.0.13.dmg
Drag CARAPACE to Applications
Launch CARAPACE and follow the setup wizard
2

Pair your iPhone

The wizard creates a QR for your private OpenClaw gateway. Scan it in CARAPACE while both devices are on your Tailscale network.

3

Provider setup

OpenClaw can use ChatGPT OAuth, Gemini keys, or advanced custom provider configuration.

4

What gets preserved

The installer is designed to be non-destructive. Existing OpenClaw state, workspace memory, Tailscale setup, provider auth, and Projects are not wiped by normal reruns.

5

If something goes wrong

Open CARAPACE from the menu bar, show the QR again, or rerun setup. The path refreshes CARAPACE support files, quiets legacy heartbeat noise, and keeps Projects from doing an automatic memory import unless you explicitly ask.