#openclaw#dashboard#authentication#setup

Dashboard Keeps Blocking You? Understand OpenClaw Authentication in 3 Minutes

2 min read

"Token? Pairing? I just wanted to open a webpage."

That reaction is completely fair. This article exists so you can stop being afraid of the login screen.

What You'll Learn

  • Understand the relationship between Gateway and the dashboard
  • Identify the three most common authentication situations
  • Learn how remote access is configured
  • Change the UI language on the side

Start the Gateway First

The dashboard is only a window. The real work happens in the Gateway. Without the Gateway, the web page is just a pretty empty shell.

openclaw gateway

Only continue after you see something like "Gateway running".

Open the Dashboard

http://127.0.0.1:18789/

If you configured basePath such as /openclaw:

http://127.0.0.1:18789/openclaw

Authentication: What Am I Supposed to Enter?

Case 1: You See pairing required

OpenClaw is basically asking, "Who are you? I do not know this device yet."

openclaw devices list
# Find the pending requestId
 
openclaw devices approve <requestId>
# Replace it with the real ID

Refresh the browser and you should be in.

Case 2: It Asks for a Token

The onboarding flow gave you a token earlier. This is where you paste it. Save it in Settings and you usually will not need to paste it again later.

💡 Tokens are stored in the UI settings. Passwords only live in memory and disappear when the session ends. That is intentional for security.

Case 3: Remote Access from a VPS or LAN

If your Gateway is not running locally but on a remote server:

  • You must use a token or device pairing
  • If you see unauthorized, first check gateway.bind and confirm the token was entered correctly

Want Another Language?

The Control UI supports multiple interface languages, including English, Traditional Chinese, and Simplified Chinese.

Open the Access section, choose a language, and the browser will remember it next time.

Next Up

Once you can log in, you are standing inside OpenClaw's main control room. Next, let's connect Telegram so you can call your assistant from your phone.

← Previous: Install and first launch | 👉 Connect Telegram and use your assistant on mobile