StarAgent
Docs
DashboardSetup

NemoClaw and StarAgent

NemoClaw runs OpenClaw inside OpenShell. StarAgent reaches your gateway over HTTPS. NemoClaw's auxiliary services can publish a temporary public URL with cloudflared so StarAgent (on the internet) can POST to /hooks/agent.

Payload shape and Bearer auth are the same as the general OpenClaw integration. This page only covers the NemoClaw tunnel URL and where to paste it.

1. Open hooks in OpenClaw

Enable gateway hooks and set hooks.token in your OpenClaw config. StarAgent sends that value as Authorization: Bearer …. Upstream reference: docs.openclaw.ai/automation/webhook.

2. Start NemoClaw services

From your NemoClaw install, run nemoclaw start (or the equivalent script that starts cloudflared). You need cloudflared on your PATH. The CLI prints a public URL like https://<random>.trycloudflare.com. That URL forwards to the local dashboard port (default 18789), which serves the OpenClaw gateway.

Your StarAgent Endpoint URL is the tunnel host with the agent path appended, for example https://abcd-efgh.trycloudflare.com/hooks/agent. Quick tunnels rotate when you restart cloudflared. For production, use a stable hostname (Tailscale, named Cloudflare Tunnel, or a VPS) and point StarAgent at that URL instead.

StarAgent managed hostnames

For a stable URL without NemoClaw's rotating trycloudflare link, use Setup, Webhooks, OpenClaw gateway format, then Create stable hostname. StarAgent provisions oc-*.staragent.io with Cloudflare Tunnel (outbound connector on the gateway host, default localhost:18789). Your hook URL is https://oc-… .staragent.io/hooks/agent.

bb-*.staragent.io from BlueBubbles targets localhost:1234, not OpenClaw, unless you changed tunnel routing yourself.

3. Configure StarAgent

  1. Open Setup, enable Webhooks, and set payload format to OpenClaw gateway (POST /hooks/agent).
  2. Paste the full hook URL (tunnel or stable host plus `/hooks/agent`).
  3. Set Hook secret to the same string as OpenClaw hooks.token.
  4. Save, then use Send test to confirm HTTP 200 from your gateway.

Machine-readable summary

Agents can read /llm.md for webhook fields and OpenClaw body shape.