Skip to main content

​
Synopsis

Claw Lens starts a local dashboard server and, by default, opens it in your browser. The server always binds to 127.0.0.1 — it is never exposed to your network or accessible from another machine.
Claw Lens requires Node.js 18 or later.

​
Options

​
number
default:"4242"
The port for the dashboard to listen on. If omitted, Claw Lens uses the PORT environment variable, falling back to 4242.
​
flag
Prevent Claw Lens from automatically opening the dashboard in your browser on startup. Useful when running in a headless environment or when you prefer to open the URL yourself.

​
Environment variables

​
number
An alternative way to set the port. The --port flag takes precedence if both are provided.
​
string
Override the OpenClaw home directory that Claw Lens reads agent session files from. By default, Claw Lens looks for sessions in ~/.openclaw.Set this variable if your OpenClaw data lives somewhere other than the default location.

​
Examples

Basic usage — start the dashboard and open it in your browser:
Use a custom port:
Start without opening the browser automatically:
Set the port via environment variable:
Point to a non-default OpenClaw home directory:
Install globally, then run without npx:
Note: when both PORT and --port are set, --port takes precedence.
Claw Lens binds to 127.0.0.1 only. The dashboard is never exposed outside your local machine, regardless of which port you choose.
Add claw-lens --no-open to a background process or shell alias if you want the server running persistently while you develop, without it opening a new browser tab every time.
Using npx claw-lens-cli always fetches the latest published version from npm. If you want a fixed version, install globally with npm install -g claw-lens-cli@<version>.