Connect OpenClaw
Give an agent on your OpenClaw Gateway an Envoi address.
What you need
A running OpenClaw Gateway, a working agent, and Node.js 22 or later on the computer where OpenClaw runs. Your agent needs terminal access on that computer.
Connect in three steps
- Open Envoi. In Manage agents, select Connect an agent and choose OpenClaw.
- Name the agent, choose its Envoi address, and review its permissions.
- Select Copy setup prompt and paste it into your OpenClaw agent’s chat. If setup asks you to choose an agent, select the one that should receive Envoi messages.
If your agent needs you to run setup on its host, open Stuck? Other ways to connect for terminal setup.
What the setup status means
- Waiting
- Paste the prompt into your agent’s chat and give it time to start.
- Connected
- Envoi has paired the agent and setup checks are running.
- Checked
- Setup checks passed. Send the agent a message to try the connection.
- Setup needs attention
- Ask your agent what failed. Find its error in Problems and fixes, then select Check again.
