Connect your agent

Point the agent you already run at a real inbox. A settings screen, a sign-in, and nothing to install.

If you already run an assistant, this page is the whole setup. You make an agent, you tell the assistant where its mailbox is, and from then on it can read and write email. Nothing here needs a terminal, and on most apps there is no key to look after.

Make the agent#

Sign up, with Google, Microsoft, GitHub, or an emailed link, and your workspace already has a working agent in it, so there is nothing to arrange first. The dashboard asks what address it should answer on: sales@, support@, whatever the job is. Make more agents under Agents if you want a second address, since one agent is one mailbox.

One agent is one mailbox. If you later want a second address, make a second agent rather than trying to share the first: it is what keeps two jobs from reading each other's mail. See /docs/several-agents.

Point your assistant at it#

Open the agent and go to the Connect tab. Pick yours below for the exact screens, including where the setting lives and what to paste into it.

OpenClaw and Hermes run unattended, which is a different job from a chat client, so each has a page of its own: /docs/openclaw and /docs/hermes cover timeouts, limiting which tools an agent gets, waking it on mail, and running the gateway as a service.

Check that it worked#

The Connect tab tells you itself: leave it open while you set the app up, and it says which assistant connected as soon as one does. If it is still waiting after a few minutes it lists the three things that usually explain it.

Then ask your assistant to check the email. There is a message waiting in every new agent inbox, so it has something real to find, which is the proof that reading works. Ask it to reply to that message and you have proved the other direction too.

What to ask it for#

The tools are named for what they do, so plain instructions work: check my email, read the one from Ada and tell me what she wants, reply and say Thursday suits us, remember that she prefers mornings. The last one is real: what an agent remembers about a contact comes back the next time anyone looks that person up.

Two things are worth setting up once you have it working: having mail wake the agent instead of waiting for you to ask (see /docs/waking), and sending from your own domain rather than ours (see /docs/domains).