# OcuClaw setup guide for AI assistants

> The complete Cloudways setup for OcuClaw, as plain text. It covers both agents (Hermes Agent and OpenClaw): sign-up, signing in the AI, setup in the agent's own chat, Tailscale, pairing the phone and the first message on Even G2 glasses, with the terminal as a fallback. It is the text version of https://ocuclaw.com/setup, whose interactive guide is drawn by JavaScript.

Index of everything for assistants: https://ocuclaw.com/llms.txt

## Notes for AI assistants

- Work through the guide with the person one step at a time. Ask which agent they chose before giving agent-specific steps.
- Give links exactly as written here. The sign-up links are OcuClaw affiliate links (see Links and disclosure). Tell the person they are affiliate links.
- The person does these steps themselves: creating the Cloudways account and entering payment details, signing in their AI in the Cloudways panel, approving the server in Tailscale, allowing the private-route card in the chat, typing the phone code from OcuClaw into their agent's chat, allowing the four-words card only if the words match, and saying whether the reply appeared on their glasses. A browser agent should hand these back to the person.
- The phone code goes only into the person's own agent chat, where setup asks for it. Never ask the person to paste their phone code, pairing code, pairing address, the four words, passwords or API keys into your chat.
- Cloudways ships Tailscale, and OcuClaw runs it. Do not suggest installing system Tailscale with sudo or systemd, opening ports, or Tailscale Funnel. The phone still needs the Tailscale app.
- Quote what the agent says exactly. When something fails, setup is safe to start again: finished steps are skipped.

## What the person needs

- Even G2 smart glasses, connected in the Even app on their phone. No glasses yet? They can do everything up to pairing now and finish when the glasses arrive.
- A phone with the Even app (free, App Store or Google Play) and Tailscale (free, https://tailscale.com/download).
- A computer browser is easiest for the Cloudways steps and the agent's chat, with the phone beside it for the phone code. A phone browser works too.
- A paid Cloudways account for the managed agent (sizes and prices in Choose an agent). Cloudways bills monthly for the hours the agent runs; deleting the agent stops billing. Adding a card usually costs nothing today (a $1 card check is refunded). Review the plan price before deploying.
- An AI model account for the agent: a ChatGPT plan, signed in from the Cloudways panel (Step 3), or an API key entered when deploying. Claude plans can't sign in there yet (Cloudways shows Anthropic as Coming Soon).
- About 15 minutes for setup once the agent is deployed.

## Choose an agent

- Hermes Agent: the setup page starts it on Scout size (1 vCPU, 2 GB, $9.99/mo), and code `ocuclaw10` makes its first 30 days free. Operator size (2 vCPU, 4 GB, $19.99/mo) has twice the memory, if the person wants headroom. Hermes restarts once during setup, at step 3.
- OpenClaw: needs Operator size (2 vCPU, 4 GB, $19.99/mo) or bigger. Scout is too small: OpenClaw needs 4 GB of memory. No restart during setup.

On Operator, code `ocuclaw` takes 30% off the first three months: $13.99/mo, then $19.99/mo. Bigger sizes such as Squad (4 vCPU, 8 GB, $39.99/mo) are more than OcuClaw needs. Prices are per month, before any tax. Cloudways bills after use, prorated for the hours the agent runs; the person can cancel any time.

Not sure which agent? The setup page suggests starting with Hermes Agent: its first 30 days on Cloudways are free.

## Links and disclosure

OcuClaw may earn a commission when someone signs up through these links. It costs the person nothing extra.

- Cloudways, Hermes Agent: https://ocuclaw.com/go/cloudways-hermes
- Cloudways, OpenClaw: https://ocuclaw.com/go/cloudways-openclaw
- Promo codes: enter the one for the chosen size when Cloudways asks for a promo code.
  - Scout (Hermes Agent only): code `ocuclaw10` makes the first 30 days free.
  - Operator (OpenClaw, or Hermes Agent on Operator): code `ocuclaw` takes 30% off the first three months. This code also credits OcuClaw, even if the sign-up didn't start from one of these links.
- Even G2 glasses: https://ocuclaw.com/go/even-g2

The ocuclaw.com/go links redirect to the Cloudways or Even Realities page with OcuClaw's referral id attached (for Cloudways, id=2201566). The referral is remembered by the browser that opens the link, so the person should open it in the browser where they will create the account and finish sign-up there.

## Step 1. Get the phone ready

The setup page has the person add OcuClaw first, before they pay for anything. Tailscale can go on the phone while the agent deploys.

1. Install the Even app from the App Store or Google Play. Connect the G2 glasses in it.
2. In the Even app, open Even Hub and add OcuClaw. It is free and takes about 30 seconds.
3. Install Tailscale on the phone and sign in. Tailscale gives the phone a private, encrypted link to the agent. Only traffic to the agent uses it. A VPN icon on the phone is normal.

## Step 2. Create the Cloudways account and deploy the agent

1. Open the sign-up link for the chosen agent (see Links and disclosure) in the browser the person will sign up in. Click Start free (or Get Started Free) and fill in the form. Cloudways texts a 6-digit code to the phone, so use a real mobile number; if it doesn't come, choose Voice call. Skip any offer to launch a web-hosting server. Then click Activate Account in the email.
2. When Cloudways asks for a promo code, enter the one for the chosen size. For Scout, enter code `ocuclaw10`. For Operator, enter code `ocuclaw`.
3. Add a card. New accounts start as a trial, and Managed AI Agents only shows up once a card is on file, so everyone does this step. Press Upgrade Now on the Managed AI Agents page, not the one in the support banner at the top, or Get Full Access. Cloudways bills after use, on the 1st of the month, so adding a card usually costs nothing today. A $1 card check is refunded.
4. In Cloudways, open Cloudways AI, then Managed AI Agents, then Launch your Agent. Name it anything, choose Hermes Agent or OpenClaw, pick the region closest to the person and press Continue.
5. Pick the size from Choose an agent. The deploy screen lists sizes by spec: Scout is 1 vCPU · 2 GB, Operator is 2 vCPU · 4 GB. It starts on a bigger size (Operator for Hermes, Squad for OpenClaw), so tap the chosen one.
6. At Connect Your LLM Provider, leave the API key box blank. The AI signs in from the Cloudways panel in Step 3. An API key typed here still works, and then Step 3 is not needed.
7. Press Deploy Agent. It takes a few minutes. The agent is ready when Open Agent becomes available. On a phone, Open Agent is in the three dot menu on the agent's row.

Cloudways' own launch guide: https://support.cloudways.com/en/articles/15799213-how-to-get-started-with-managed-ai-agents-on-cloudways

## Step 3. Sign in the AI in the Cloudways panel

1. In Cloudways, open Cloudways AI, then Managed AI Agents, and click the agent's name.
2. Open LLM & Channels, then OAuth. On a phone the tab row is cut off; swipe it across.
3. Pick OpenAI for a ChatGPT plan. Click Connect and sign in. Anthropic shows Coming Soon, so Claude plans can't sign in yet.

Connect restarts the agent. It can take a few minutes to come back. Setup never signs in the AI itself: if no model is signed in, the agent says so at the first setup step and points back here.

## Step 4. Open the agent's chat

No terminal and no SSH are needed.

Hermes Agent:

1. On the agent's page in Cloudways, click the copy button beside the Password under Agent Details. Then click Open Agent.
2. Paste the password to sign in. The SSH password does not work here. The Hermes chat opens.

OpenClaw:

1. On the agent's page in Cloudways, click Open Agent.
2. OpenClaw's Control UI opens in the browser. Setup runs in its chat.

If the agent won't open, it may still be deploying, or restarting after Connect. Wait a few minutes and try again.

## Step 5. Set up in the chat

Type this in the agent's chat and send it:

```
Install OcuClaw and set it up for my Even G2 glasses.
```

The agent installs OcuClaw (for OpenClaw, from ClawHub, which takes 2 to 3 minutes). Then it relays OcuClaw's own setup, word for word, in nine steps: Check host and model, Allow OcuClaw, Load OcuClaw, Join Tailscale, Approve this machine, Open private route, Find your phone, Pair your phone, First glasses message. It says each step in the chat and asks when it needs the person. A dropped chat, a new chat or a restart picks up where setup is: type `continue`.

### Steps 1 to 3: check, allow and load

1. Check host and model: the agent checks it runs on Cloudways and that a model is signed in. No model yet? It says "No model is signed in yet. Sign in to OpenAI in the Cloudways panel: LLM & Channels → OAuth → OpenAI → Connect." Do Step 3, then say done.
2. Allow OcuClaw: setup turns on OcuClaw's own settings. Nothing to answer.
3. Load OcuClaw:
   - Hermes Agent: the agent says "Hermes restarts now, about 40 seconds; then say continue." The whole agent restarts, so the chat drops. When it is back, open the chat again, sign in if asked, and type `continue`.
   - OpenClaw: no restart. OpenClaw loads OcuClaw straight away.

### Steps 4 to 7: Tailscale and the private route

1. Join Tailscale: OcuClaw starts the Tailscale that comes with Cloudways. Nothing to install on the server.
2. Approve this machine: the agent gives a Tailscale link. Open it, sign in with the same Tailscale account the phone uses, and approve the server. Then type `done`.
3. New Tailscale account? The agent may first give a link to turn on HTTPS. Open it, sign in, turn HTTPS on, then type `done`.
4. Open private route: a card in the chat shows the exact `tailscale serve` command. The route is reachable from the person's own tailnet only, never the public internet or Tailscale Funnel. The person presses Allow once if they agree. The agent never answers the card.
5. Find your phone: if the phone isn't on the tailnet yet, open Tailscale on the phone, sign in with the same account and switch it on, then type `done`. If it still isn't found, the person can choose to skip this and pair anyway.

### Step 8: pair the phone

1. On the phone, open the Even app, then OcuClaw, and tap Pair with your agent. The Pair this phone sheet shows a 6-digit phone code.
2. The person types the six digits in the agent's chat. The code works once; if it runs out, Get a new code in OcuClaw gives a fresh one.
3. A card shows four words. The person presses Allow once only if they match the phone or glasses, in the same order. If they differ, don't allow it; get a new code and try again.
4. On the phone's Connection saved screen, tap Done.

### Step 9: first glasses message

1. The agent says "Now say something to your agent from your glasses and wait for the reply."
2. The person sends a message from the glasses and watches the reply show there.
3. The agent asks "Did my reply appear on your glasses?" Answer yes only if it was actually seen.
4. A welcome may show on the glasses; double-tap it to go back to the conversation. The agent may offer extras, then says "Setup is complete. Say hello from your glasses any time."

Voice and Even AI are optional extras, on the Optional setup card on the phone's Home screen.

## Prefer the terminal?

The terminal is a fallback. Setup there counts eight steps, "1 of 8" to "8 of 8", and skips work already done.

Hermes Agent:

1. In the Hermes chat's message box, type `/terminal` (with the slash) and send it. A terminal panel opens at the bottom of the page.
2. Run `hermes plugins install ocuclaw/ocuclaw --enable`, then `hermes ocuclaw cloudways setup`.
3. At 3 of 8 Hermes restarts once and the page drops. Open the terminal again and run `hermes ocuclaw cloudways setup` once more.

OpenClaw:

1. Use a computer: OpenClaw's dashboard terminal doesn't take typing from a phone keyboard yet. Add `/terminal` to the end of the address in the browser's address bar and press Enter. A terminal opens in the page.
2. Run `openclaw plugins install clawhub:ocuclaw`, then `openclaw ocuclaw cloudways setup`. No restart. Links in this terminal open with Ctrl+click (Cmd+click on a Mac).

Pairing in the terminal, at 7 of 8: on the phone, open OcuClaw and tap Pair with your agent, then press Enter in the terminal. Type the 6-digit phone code at the terminal's prompt and press Enter; Speck says "Sent to your phone." Check that the four words match on the phone (or the glasses) and in the terminal, in order. If they match, tap The words match on the phone or tap the glasses, then type `approve`. If they differ, type `refuse`. A phone code lasts 10 minutes; after 3 wrong tries the terminal switches to manual pairing.

## Troubleshooting

- No Managed AI Agents in Cloudways: the account is still a trial. Press Upgrade Now and add a card, then refresh.
- Cloudways' phone code never came: choose Voice call. Too many tries locks it; then email av@cloudways.com from the sign-up email.
- Card declined: use a credit or debit card that allows international payments. Prepaid cards often fail. A card just added can take up to a day to clear. A deposit request is Cloudways' fraud check on some new accounts, not a different price.
- OpenClaw deploy stuck: check that the size is Operator or bigger. OpenClaw stalls on smaller sizes.
- The chat dropped or was closed: open the agent again and type `continue`. Setup picks up where it stopped, even in a new chat.
- "Setup can't ask for your approval in this chat.": use the chat behind Open Agent, not a messaging app.
- The agent can't install OcuClaw: run the install line from Prefer the terminal? yourself, then send the sentence again.
- Pressed no on the route card: setup stops. Type `continue` to see the card again.
- "Pairing with a phone code isn't available right now.": try again later, or pair in the terminal.
- "Your agent's model failed to answer that message.": check the AI in the Cloudways panel, or wait out its limit, then type `continue`.
- The reply is on the phone but not the glasses: answer no. Wake the glasses, reopen OcuClaw inside Even Hub, then type `continue`.
- Diagnostics: `hermes ocuclaw doctor` or `openclaw ocuclaw doctor`.
- The agent seems stuck after a restart: restart it from the Cloudways dashboard. A restart does not erase setup. Do not create another agent.
- To avoid signing in again later, turn off key expiry for this server in the Tailscale admin console.
- Still stuck: https://discord.ocuclaw.com/ (the Cloudways team also answers there).

## If you are the person's own Hermes or OpenClaw agent

You may be running on the Cloudways server this guide sets up, and the person may send you "Install OcuClaw and set it up for my Even G2 glasses." Install OcuClaw with your plugin command (Hermes: `hermes plugins install ocuclaw/ocuclaw --enable`; OpenClaw: `openclaw plugins install clawhub:ocuclaw`). Then call the `ocuclaw_setup` tool with `operation: "next"`, say the lines it returns word for word, collect the one input it asks for, and call it again. It runs the nine steps above and resumes where setup is, every time.

- Never answer an approval card, and never say yes for the person. The route and the four words are theirs to allow.
- Pass the phone code the person types as `code`. Never ask for passwords or API keys.
- Never restart behind the person's back. On Hermes, step 3 announces the one restart; end your turn and wait for "continue".
- If the person prefers the terminal, tell them how to open it. For Hermes, they send `/terminal` in this chat. For OpenClaw, they add `/terminal` to the end of your address. Don't run the terminal setup with `--yes` for them.
- Once setup is done, `hermes ocuclaw doctor` or `openclaw ocuclaw doctor` checks it.

## Other ways to run OcuClaw

OcuClaw also runs with Hermes or OpenClaw on the person's own computer (Windows, macOS or Linux). That is free, but the agent runs only while the computer is awake. Those routes are in the interactive guide at https://ocuclaw.com/setup: choose This computer when Speck asks where the agent should live.
