Getting Started

Getting Started

This guide walks you through connecting LordClaw to your OpenClaw gateway.

Prerequisites

  • A running OpenClaw installation with at least one agent configured
  • The OpenClaw gateway running and accessible (default: ws://localhost:18789)

Connecting to the Gateway

When you first open LordClaw, you’ll see the onboarding flow:

  1. Welcome — brief introduction to the dashboard
  2. Connect — enter your gateway URL and optional auth token
  3. Features tour — optional walkthrough of what you can do (skippable)
  4. Done — you’re in

Gateway URL

The gateway URL depends on how you’re accessing the dashboard:

Access methodGateway URL
Same machine as OpenClawws://localhost:18789
Via Tailscale (remote)wss://<magic-dns>

If you’re accessing LordClaw from another device on your Tailscale network, use the wss:// protocol with your machine’s Tailscale magic DNS name when the gateway is exposed through Tailscale Serve.

Current setup recommendation:

  • Dashboard: https://<magic-dns>:4443http://127.0.0.1:3333
  • Gateway: https://<magic-dns> (443) → http://127.0.0.1:18789

See Remote Access via Tailscale for the copy-paste commands.

Auth Token

If your gateway has authentication enabled, enter the gateway token. This is stored in your browser’s localStorage — it never leaves your device.

Skipping Onboarding

You can skip onboarding at any step and come back to it later. Your progress is saved. To restart onboarding, go to Settings and click “Reset Onboarding.”

Interface Overview

Once connected, the dashboard has three main areas:

The left sidebar contains navigation to all sections. On desktop, you can:

  • Drag to reorder navigation items
  • Resize the sidebar width (180–400px range)
  • View live Claude/MiniMax/ZAI plan usage at the bottom

Bottom Navigation (mobile)

On mobile, a bottom navigation bar shows 5 items:

  • Home, Agents, and Chat are always visible
  • The remaining 2 slots dynamically show your most recently visited sections

The top header shows:

  • The gateway connection status (green dot = connected)
  • Gateway version number
  • A reload button (useful in PWA mode)

The header is hidden on individual chat pages to maximize screen space for conversations.