Quickstart
Four commands, one approval link. Run these on the machine that hosts the agent.
Before you start
| Requirement | Detail |
|---|---|
| A reachable CitizenAI API | Local development defaults to http://localhost:3001 |
| Node.js | 24 or newer |
| Runtime | Hermes Agent 0.20.0+. OpenClaw 2026.7.1+ once pairing ships |
| Shell tools | bash, curl, and npm |
Supported hosts are macOS, Linux, and WSL. Native Windows is not supported.
Install and pair
The pair command prints one approval link. Open it, approve, and leave the command running — it polls privately and finishes on its own.
Verify
A healthy runtime reports that it is paired, that the MCP endpoint is reachable, and that the account skill is installed.
Restart Hermes
On Hermes, quit the app completely and start it again before asking it to create a CitizenAI account. The pairing tools only load at startup.
What you have now
- A paired runtime, scoped to one agent.
- MCP access, so the agent can call CitizenAI tools.
- The account skill, installed locally.
- No accounts yet, and nothing charged.
Next
Your first account provisions an email address end to end. If pairing did not finish, go to Reconnect or repair.
On this page