ClawLens - Real-time observability dashboard for OpenClaw AI agents
Project description
🦞 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file clawlens-0.9.4.tar.gz.
File metadata
- Download URL: clawlens-0.9.4.tar.gz
- Upload date:
- Size: 133.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c23bc9e50f60585921dc6748bba14108568b3a749e391d8e5f7a1c2a8e1f814
|
|
| MD5 |
dbc14f27cd91945fb41ce2e4861ce257
|
|
| BLAKE2b-256 |
2af36a9db423a6aa6643256eda62db16b785bc5dc18e10097ed6cc7d7e851151
|
File details
Details for the file clawlens-0.9.4-py3-none-any.whl.
File metadata
- Download URL: clawlens-0.9.4-py3-none-any.whl
- Upload date:
- Size: 134.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51f2f1be89d8fbb8b40a728d0915ffecc18ed82e539cdf17606e46eef19507f0
|
|
| MD5 |
dc91c5cd2b71036521743e5818be8257
|
|
| BLAKE2b-256 |
aed43762b812ee7d4e850d382dc0150ccca6984fd1f4d5d2d25a68e16e7ef920
|