CozyLabs
join the beta

connect the app you have.

CozyChat 1.0 for iPhone and iPad.

choose a connection.

Direct Hermes
Guided SSH setup for a computer, or API setup for a reachable compatible server. Relay-backed notifications, room live feed, phone approvals and Live Activities need the companion plugin installed through SSH and reporting shared-v1.
Direct OpenClaw
A qualified OpenClaw Gateway address and credential. The shipped, limited direct mode; no CozyAgents QR code.
CozyAgents
Install it on a computer, then pair with its QR code. It brings its own bundled gateway.

Compare them in the connection guide. Starting fresh? CozyAgents.

pair cozyagents.

  1. Run the installer on the computer. CozyAgents v0.9.6 brings its own bundled gateway.

    macOS · Linux 

    curl -fsSL https://cozylabs.ai/agents.sh | bash

    Windows PowerShell 

    irm https://cozylabs.ai/agents.ps1 | iex

  2. For a fresh QR and code, run cozyagents pair.
  3. In CozyChat, choose CozyAgents, then scan or type the code.
  • Supported systems and setup: install guide.
  • Photos: CozyChat prepares the one you pick on your device and strips location metadata before upload.
  • Push and Live Activities: a CozyAgents gateway, or a direct Hermes companion installed through SSH and reporting shared-v1, use the CozyLabs relay. Direct OpenClaw has no app push.

troubleshooting.

pairing fails
Run cozy status. Make a fresh code with cozyagents pair. Use an address the device can reach, not loopback. For a changed self-signed identity, verify the server before accepting it.
direct fails
Check the HTTPS address and credential with the operator, and the server version against the connection guide. Direct OpenClaw does not accept CozyAgents setup codes.
nothing arrives
CozyAgents: are the gateway and its runner online? Direct: is the server reachable? Push: are CozyChat notifications allowed in iOS Settings, and can the gateway or SSH-installed shared-v1 companion reach its relay?
forget
Forgetting a CozyAgents connection removes its local credential, trust record and notification key, and requests device revocation. Forgetting any connection removes its local record.

contact.

Email [email protected] with your CozyChat and iOS versions, connection mode and symptom. Leave out credentials and chat content. Data handling: privacy policy.