If you just installed or updated OpenClaw and find yourself stuck with a "gateway token missing" or "unauthorized gateway token" error, you are in the right place. This is one of the most common issues people are hitting with the latest versions of the framework, but fixing it takes literally two commands.
In this quick troubleshooting guide, I will explain why it happens and how to immediately restore access to your TUI or dashboard.
Over 75% of users who install the 2026 version of OpenClaw encounter this security block on their first launch.
What Causes the Unauthorized Token Error in OpenClaw?
Recent versions of OpenClaw have introduced token authentication on the gateway by default. This is a security measure to ensure that nobody from the outside can access your local AI agents.
However, during a fresh installation, this token is not always generated automatically. When you try to run the openclaw tui command or open the web dashboard, the client cannot find the credentials to authenticate with the gateway, throwing an unauthorized token or gateway token mismatch error.
Looking for more OpenClaw guides?
For more details, you can read our 2026 guide on installing OpenClaw with Ollama or explore how to configure the gateway.
How to Generate the Gateway Token
The solution is straightforward: we need to tell OpenClaw to generate a new security token.
Open your terminal (or press Ctrl+C if you are stuck on the TUI error screen) and run this command:
openclaw gateway token generateThe system will ask for confirmation. Press Enter or type Yes. OpenClaw will create a new cryptographic token and automatically save it to your openclaw.json configuration file.
Restarting the Gateway
Generating the token is not enough because the background gateway process is still running with the old settings. You need to restart it to force it to read the new configuration.
Run:
openclaw gateway restartWait a few seconds until the terminal confirms that the service has restarted successfully. This step is crucial whenever you modify access keys or tokens.
Verifying the Connection
Now you can try launching the interface again:
openclaw tuiIf everything worked, the interface will open immediately, and you can get back to managing your local AI agents. If you are using the web dashboard, simply refresh the page.
I ran into this exact error on my Mac Mini M4 while testing the new release, and these two commands solved it on the first try every time.
FAQ (Frequently Asked Questions)
What is the unauthorized gateway token error?
It is a 2026 OpenClaw security block that prevents unauthorized access when the session token is missing or mismatched.
How do I generate a new token for OpenClaw?
Simply run the command openclaw gateway token generate in your local terminal.
Do I need to restart OpenClaw after generating the token?
Yes, it is mandatory to use openclaw gateway restart so the background service can load the new credentials.
Written by Matteo Giardino, CTO & AI Engineer.