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#

KeyDescriptionrun_idUnique run ID — format run_{unix_ms}_{hex4}``total_duration_msWall-clock time from task start to nowactive_msActive time (excludes pauses/waits)retry_countNumber of retries so farerror_countNumber of non-fatal errorsloop_countNumber of loop iterationslast_errorLast error message string

Configuration#

text

NOTILENS_TOKEN=your_topic_token
NOTILENS_SECRET=your_topic_secret

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