NotiLens is a real-time notification engine that delivers instant task lifecycle events, error alerts, and performance metrics from your AI agents directly to your phone.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notilens
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install notilens using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is NotiLens?
NotiLens provides a powerful observability bridge for your automated workflows and AI processes. By integrating this capability into your Openclaw Skills environment, you gain immediate visibility into the execution status of your agents without the need for manual log polling. The skill allows any script or agent to push critical updates—such as task starts, progress checkpoints, or fatal errors—directly to your mobile device or team dashboard.
This skill is essential for developers who need to monitor long-running background tasks or maintain high-reliability systems. NotiLens simplifies the complexity of tracking distributed agent activities by providing a unified webhook interface that supports rich metadata, severity levels, and human-in-the-loop interaction prompts.
NotiLens Use Cases
- Receiving instant push notifications when an Openclaw Skills agent completes a long-running data processing job.
- Monitoring autonomous scripts for infinite loops and receiving urgent alerts when a task repeats unexpectedly.
- Implementing human-in-the-loop workflows where an agent pauses and sends a notification for manual approval before proceeding.
- Tracking performance metrics such as token usage, duration, and error counts across multiple agent runs.
- Getting immediate alerts for database connection failures or API rate limit hits in production environments.
How NotiLens Works
- Initialize a unique run_id at the start of a task to correlate all subsequent events to a specific execution run.
- Dispatch a task.started event to the NotiLens webhook to signal the beginning of the workflow and notify stakeholders.
- Send periodic task.progress or task.checkpoint updates to maintain visibility during lengthy operations.
- Capture and report non-fatal errors or pauses using warning or urgent event types to ensure rapid response to issues.
- Emit a terminal task.completed or task.failed event containing a meta object with final performance metrics to close the lifecycle.
NotiLens Setup
To get started with NotiLens for your Openclaw Skills, obtain your token and secret from your topic settings at the NotiLens website. Then, configure your environment variables:
export NOTILENS_TOKEN=your_topic_token
export NOTILENS_SECRET=your_topic_secret
Ensure that curl is available in your environment as it is used to transmit the JSON payloads to the NotiLens API.
NotiLens Data Schema & Taxonomy
NotiLens utilizes a structured JSON payload for every event. The data is organized around the following primary fields:
| Field | Type | Description |
|---|---|---|
| event | string | The canonical event name (e.g., task.started, input.required) |
| type | string | Severity level: info, success, warning, or urgent |
| agent | string | Identifier for the specific Openclaw Skills agent or script |
| meta | object | Key-value pairs for metrics like duration, retry counts, or token usage |
| run_id | string | A unique identifier for grouping events from the same execution |
| is_actionable | boolean | Flag indicating if the notification requires human interaction |
NotiLens Advanced Features
- Custom Metric Tracking: Pass numeric values in the meta object to generate analytics and performance charts.
- Loop Detection: Use the task.loop event type to trigger alerts when repetitive patterns are detected in agent logic.
- Rich Media Support: Include image_url or download_url in notifications to send screenshots or generated reports directly to your device.
- Actionable Notifications: Deep-link to specific dashboards or approval pages using the open_url field for seamless human-in-the-loop integration.
- Global Run Correlation: Generate run_ids formatted as
run_{unix_ms}_{random_hex4}to maintain a clear audit trail across distributed Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
AI Subtitles Generator
An automated tool for generating and burning AI-powered subtitles into video files using cloud GPU acceleration.
Polla Central Kurdish Proofreader
An academic-grade proofreading skill for Central Kurdish that enforces professional linguistic standards through a strict five-pillar auditing process.
Video Generator Free Models
A high-performance AI skill that transforms text prompts into high-definition 1080p videos using free cloud-based models.
Speechmatics
Transcribe audio files like podcasts, meetings, and voice notes into text, JSON, or subtitles via the Speechmatics API.
Word Document Manipulation with python-docx
A robust technical skill for automating Word document generation and template manipulation using python-docx while solving common XML run issues.
TTS Audio Mastering
A professional-grade workflow for refining synthetic text-to-speech audio into production-ready assets through cleanup, normalization, and timing alignment.
Featured*
