Notilens Clawhub Plugin

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

Security Scan

The skill is internally consistent: it implements a NotiLens notifier, only requests the NotiLens token/secret it needs, and posts events to the NotiLens webhook endpoint described in its docs.

Purpose & Capability

Name/description match the code and exports. The skill only requests NOTILENS_TOKEN and NOTILENS_SECRET which are appropriate for sending notifications to NotiLens; no unrelated credentials or binaries are required.

Instruction Scope

SKILL.md describes callable functions that align with the code exports. The instructions do not ask the agent to read unrelated files, credentials, or system state, nor to send data to endpoints other than the NotiLens webhook.

Install Mechanism

No install spec; this is a code plugin packaged with its source file. Nothing is downloaded at install time and there are no external installers or archives referenced.

Credentials

Only two environment values are required (NOTILENS_TOKEN, NOTILENS_SECRET) and they are justified by the plugin's purpose. The code only accesses these two env vars.

Persistence & Privilege

The skill is not always-enabled (always:false). It requires network access to deliver events (declared). The default ability for the agent to invoke the skill autonomously is allowed by platform default — this is expected for a notification plugin but users should be aware the agent can call it when permitted.

Assessment

This plugin appears to do exactly what it claims: post events to NotiLens using a topic token and secret. Before installing, confirm you trust notilens.com and treat BOTH values as sensitive: the token is used in the webhook URL and the secret is sent in a header. Limit the token's scope where possible, rotate it periodically, and test in a non-production environment first. Also review your agent's policies for when it can call networked plugins (autonomous invocation) so events aren't sent unexpectedly.

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.