choose your connection.

* Supported when your compatible server, runtime, and connection setup make it available.

† With Dashboard: a compatible Hermes Dashboard, its own sign-in and an explicitly associated profile. API Server chat works independently of this optional administration connection.

cozyagents.

QR pairing, plus gateway-scoped push, Live Activities, rooms, routines and phone tools for its own conversations, not direct ones. CozyAgents v0.9.6 brings its own bundled gateway.

• A computer your phone can reach once Home Network Access is on. Supported systems and release status.
• A fresh install answers only on this computer. You choose Home Network Access when you pair a phone, in the console or with cozy pair; once it is on, the gateway serves plain HTTP on your home network.

1. Run the installer on the computer.

   macOS · Linux

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

   Windows PowerShell

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

2. It ends by printing a pairing QR. For a fresh one:

   cozyagents pair

3. In CozyChat: Choose a connection → CozyAgents → Scan QR code. Or type the address and code. Send a message.

• Check an install with cozy status; cozy repair mends it.

push and live activities.

Optional, and outside your network. Your gateway encrypts the preview → CozyLabs relay (push.cozylabs.ai) forwards it → Apple delivers it → your iPhone decrypts it.

1. Pair, then allow notifications (CozyChat Settings → Notifications); declined before? iOS Settings → CozyChat → Notifications.
2. Look for Push ready or Push ready for N of M gateways; the count shows gateways still missing.

• Ordinary notification bodies use AES-256-GCM. The relay has no key and stores no bodies; it sees your APNs device token, an opaque registration identifier and delivery metadata. Your gateway still reads chat content to run your agent.
• Best effort; the gateway must stay awake and online. No duplicate alert while the app is open on a live connection.
• The Bot Chat Live Activity shows a CozyAgents run when CozyChat's Live Activity setting (on by default) and iOS allow it. Remote updates need the relay.
• Live Activity updates are not encrypted with the ordinary notification envelope: the relay and Apple see phase, tool count, a short generic status and an approval identifier, never your prompt, draft, tool arguments, results or replies. The relay stores no payloads.
• Alerts and Live Activities turn off separately: in iOS settings, and with CozyChat's toggle, which also asks the gateway to drop their registrations. Turning off alerts keeps the relay registration; forgetting your last gateway asks the relay to delete it.
• Direct OpenClaw: none. Direct Hermes: through the shared-v1 companion below. Data and retention.

direct hermes.

Connect an existing Hermes API Server directly.

• SSH, from the phone: choose Hermes Agent, then the computer's address and account password.
• Or run this on the computer and scan its QR:

  curl -fsSL https://cozylabs.ai/hermes/connect.sh | sh -s link

• Or enter the API Server's HTTPS address and key.
• Pairing over your home network through a CozyChat plugin for Hermes is coming.

• Before saving, CozyChat checks Sessions, Runs, run event streaming and durable request retry. A server whose data directory is not writable is rejected.
• Chat and history stay in Hermes. When the API advertises them: routines, model choice, conversation controls, recovery and local JSON export.
• SSH additionally carries document attachments to the computer.
• Dashboard adds administration, profile files, transcription and local Hermes rooms. An SSH-installed shared-v1 companion adds encrypted push, room live feed, phone approvals and Live Activities.
• No phone-tool enrollment or per-device API-key revocation.

hermes administration.

Settings → Hermes administration: connect a compatible Hermes Dashboard over trusted HTTPS, sign in, and associate its profile. Dashboard authentication is separate from your API Server key.

models

Provider credentials (masked), custom OpenAI-compatible endpoints, profile defaults, reasoning, compression, fallback, delegation, auxiliary models. No clearing a secret, deleting an endpoint or generic reset.

profiles

Create, rename, delete; description, personality, MEMORY.md, USER.md, memory provider. Hermes's global active profile stays put. Renaming or deleting the associated profile means reconnecting.

skills, MCP

Browse, create and edit local skills; supported Hub skills; MCP servers and OAuth sign-in. Toolset writes affect CLI/Discord settings, not the API Server tools used by direct chat. No deleting a local skill.

history

Archived and hidden conversations, restore, server search, server-generated JSON export.

routines

Targets, scripts, working directories, skills/toolsets, context, models, execution history. Profile timezone only; failure delivery is edit-only.

profile files

Up to 10 MB from the permitted host location: browse, upload, download, preview, share. Uploads never overwrite or attach to chats.

voice input

Record or import, transcribe, review, insert. Needs configured transcription; no realtime or background voice.

• Most changes apply to future runs; some need a host restart, which CozyChat does not do.
• Validated: Hermes v2026.9.14 / Dashboard 0.21.3 on macOS with a deterministic local model. Not yet qualified: real-provider vision and transcription, external routine delivery, remote Hub/MCP/OAuth/OIDC, other deployments.

direct openclaw.

Connect an existing OpenClaw Gateway directly.

1. Choose OpenClaw on the connection screen.
2. Enter the reachable Gateway address and its owner's credential.
3. If the owner requires device approval, wait for it, then Retry.

• This path speaks to OpenClaw directly. A CozyAgents QR code or setup code does not apply.
• Qualified against OpenClaw protocol v4. Chat and history stay in OpenClaw, with rename, pin, archive and a model per conversation. No files, attachments, media, voice, rooms, routines, push or device management.

if it does not connect.

unreachable

CozyAgents: same trusted network, the computer's address in the QR. Direct: an address the phone can reach.

code expired

Run cozyagents pair for a fresh one. Direct Hermes and OpenClaw do not use this code.

push unavailable

Registration failed (see the detail in CozyChat). Run cozy repair, reconnect, then Turn on notifications.

no reply

CozyAgents: cozy status and its next action. Direct: the server's status, credential and capabilities. Then support, with status output and no secrets.