🦞 ClawLens

Full observability for your .claw agent. Watch your agent think, track costs, debug crons, and browse memory — all in one dashboard.

One command. Zero config. Auto-detects everything.

pip install clawlens && clawlens

Opens at http://localhost:8900 and you're done.

What You Get

• Flow — Live animated diagram showing messages flowing through channels, brain, tools, and back
• Overview — Health checks, activity heatmap, session counts, model info
• Usage — Token and cost tracking with daily/weekly/monthly breakdowns
• Sessions — Active agent sessions with model, tokens, last activity
• Crons — Scheduled jobs with status, next run, duration
• Logs — Color-coded real-time log streaming
• Memory — Browse SOUL.md, MEMORY.md, AGENTS.md, daily notes
• Transcripts — Chat-bubble UI for reading session histories

Screenshots

Flow	Overview	Sub-Agent

Summary	Crons	Memory

Install

pip (recommended):

pip install clawlens
clawlens

One-liner:

curl -sSL https://raw.githubusercontent.com/0xChitlin/clawlens/main/install.sh | bash

From source:

git clone https://github.com/0xChitlin/clawlens.git
cd clawlens && pip install flask && python3 dashboard.py

Configuration

Most people don't need any config. ClawLens auto-detects your workspace, logs, sessions, and crons.

If you do need to customize:

clawlens --port 9000              # Custom port (default: 8900)
clawlens --host 127.0.0.1         # Bind to localhost only
clawlens --workspace ~/mybot      # Custom workspace path
clawlens --name "Alice"           # Your name in Flow visualization

All options: clawlens --help

Requirements

• Python 3.8+
• Flask (installed automatically via pip)
• OpenClaw running on the same machine
• Linux or macOS

Cloud Deployment

See the Cloud Testing Guide for SSH tunnels, reverse proxy, and Docker.

License

MIT

🦞 Full observability for your .claw agent
_{Built by @vivekchand · clawlens.com · Part of the OpenClaw ecosystem}