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.5.tar.gz (133.2 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.5-py3-none-any.whl (134.1 kB view details)

Uploaded Python 3

File details

Details for the file clawlens-0.9.5.tar.gz.

File metadata

  • Download URL: clawlens-0.9.5.tar.gz
  • Upload date:
  • Size: 133.2 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.5.tar.gz
Algorithm Hash digest
SHA256 677e84829a7dd0aa4f520d65d472116afd629becaa06370d0613fcd8c51f3d64
MD5 efd33e1e7fa6a373981b9d0eec4cd8e3
BLAKE2b-256 e25e095d96a9a670a809b67aa879edfc991ad166f4865e42fdb08cbefae77265

See more details on using hashes here.

File details

Details for the file clawlens-0.9.5-py3-none-any.whl.

File metadata

  • Download URL: clawlens-0.9.5-py3-none-any.whl
  • Upload date:
  • Size: 134.1 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 2e0696d05ffa62b6095a9759e7c525c7afb260679fee72b9c3b73409b5e17489
MD5 2984310a51b6f450878030046392eb18
BLAKE2b-256 7a64e546fdb676f6fc353821cba5b7361b7934d89fc966529ea28b5c31e76381

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