Notilens Clawhub Plugin

Send real-time alerts to NotiLens from any script, app, or AI agent — task lifecycle events, errors, completions, and metric tracking.

NotiLens Plugin for OpenClaw

This is a code plugin — all functions are callable directly by the agent at runtime. No curl needed.

Get your NOTILENS_TOKEN and NOTILENS_SECRET from your topic settings at https://www.notilens.com.

Available Functions

notify(name, event, message, options?)

Send a notification. Title is auto-generated from name + event. Options: type, image_url, open_url, download_url, tags, meta.

track(name, event, message, type?, meta?)

Track any custom event (e.g. order.placed, deploy.started). Title is auto-generated.

taskStarted(name, taskId, message?, meta?)

Fire task.started when execution begins.

taskProgress(name, taskId, message, meta?)

Fire task.progress at meaningful checkpoints.

taskCompleted(name, taskId, message, meta?)

Fire task.completed when a task finishes successfully. Include total_duration_ms, active_ms, and custom metrics in meta.

taskFailed(name, taskId, message, meta?)

Fire task.failed when a task fails. Automatically sets is_actionable: true.

taskError(name, taskId, message, meta?)

Fire task.error for non-fatal errors (task continues).

taskRetry(name, taskId, retryCount, meta?)

Fire task.retry when retrying. Pass the current retry number (1-based).

taskLoop(name, taskId, message, loopCount, meta?)

Fire task.loop when the same step is repeating. Pass the current loop count.

inputRequired(name, message, openUrl?, meta?)

Fire input.required when a human decision is needed. Automatically sets is_actionable: true.

Recommended meta Fields

Key	Description
run_id	Unique run ID — format run_{unix_ms}_{hex4}
total_duration_ms	Wall-clock time from task start to now
active_ms	Active time (excludes pauses/waits)
retry_count	Number of retries so far
error_count	Number of non-fatal errors
loop_count	Number of loop iterations
last_error	Last error message string

Configuration

NOTILENS_TOKEN=your_topic_token
NOTILENS_SECRET=your_topic_secret

Both are found in your topic settings at https://www.notilens.com.