Skip to main content

ClawLens - Real-time observability dashboard for OpenClaw AI agents

Project description

🦞 ClawLens

PyPI License: MIT GitHub stars

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.

Flow Visualization

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
Flow Overview Sub-Agent
Summary Crons Memory
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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clawlens-0.9.4.tar.gz (133.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clawlens-0.9.4-py3-none-any.whl (134.0 kB view details)

Uploaded Python 3

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

Hashes for clawlens-0.9.4.tar.gz
Algorithm Hash digest
SHA256 8c23bc9e50f60585921dc6748bba14108568b3a749e391d8e5f7a1c2a8e1f814
MD5 dbc14f27cd91945fb41ce2e4861ce257
BLAKE2b-256 2af36a9db423a6aa6643256eda62db16b785bc5dc18e10097ed6cc7d7e851151

See more details on using hashes here.

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

Hashes for clawlens-0.9.4-py3-none-any.whl
Algorithm Hash digest
SHA256 51f2f1be89d8fbb8b40a728d0915ffecc18ed82e539cdf17606e46eef19507f0
MD5 dc91c5cd2b71036521743e5818be8257
BLAKE2b-256 aed43762b812ee7d4e850d382dc0150ccca6984fd1f4d5d2d25a68e16e7ef920

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page