Skip to main content

​
Synopsis

claw-lens [options]
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

​
--port
number
default:"4242"
The port for the dashboard to listen on. If omitted, Claw Lens uses the PORT environment variable, falling back to 4242.
claw-lens --port 3000
​
--no-open
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.
claw-lens --no-open

​
Environment variables

​
PORT
number
An alternative way to set the port. The --port flag takes precedence if both are provided.
PORT=3000 claw-lens
​
OPENCLAW_HOME
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.
OPENCLAW_HOME=/path/to/openclaw claw-lens

​
Examples

Basic usage — start the dashboard and open it in your browser: 
npx claw-lens-cli
Use a custom port: 
npx claw-lens-cli --port 3000
Start without opening the browser automatically: 
npx claw-lens-cli --no-open
Set the port via environment variable: 
PORT=3000 npx claw-lens-cli
Point to a non-default OpenClaw home directory: 
OPENCLAW_HOME=/path/to/openclaw npx claw-lens-cli
Install globally, then run without npx: 
npm install -g claw-lens-cli
claw-lens
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>.