Send Signalgrid Live Activities and Ongoing Notifications from OpenClaw
The Signalgrid OpenClaw Activity skill allows OpenClaw agents to start, update, and finish Live Activities on iOS and ongoing notifications on Android using the Signalgrid API.
This integration is useful for:
- deployment progress notifications
- backup status updates
- CI/CD job monitoring
- long running automation tasks
- workflow progress updates
Installation
Install the Signalgrid OpenClaw activity skill:
clawdhub --workdir ~/.openclaw install signalgrid-activityEnsure your OpenClaw Tool Profile is set to full.
Config → Tools → Tool Profile
Environment Configuration
Configure the required environment variables in OpenClaw:
Config → Environment → Environment Variables Overrides → Add Entry
SIGNALGRID_CLIENT_KEY=your_client_key_here
SIGNALGRID_CHANNEL=your_channel_name_hereStart Live Activity
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type start \
--title "OpenClaw" \
--body "Starting…" \
--severity info \
--steps 1 \
--progress 10 \
--progress_legend "true" \
--start_text "Activity Start" \
--end_text "Activity End"Update Live Activity
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type update \
--token "MX2L2K" \
--title "OpenClaw" \
--body "Step 3/6" \
--severity warning \
--steps 1 \
--progress 50 \
--progress_legend "true" \
--start_text "Activity Start" \
--end_text "Activity End"End Live Activity
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type end \
--token "MX2L2K" \
--title "OpenClaw" \
--body "Done" \
--severity success \
--steps 1 \
--progress 100 \
--progress_legend "true" \
--start_text "Activity Start" \
--end_text "Activity End" \
--dismissal_delay 60Parameters
Parameter
Description
titleActivity title. Defaults to
No Title.bodyActivity body text. Defaults to
No Body.typeActivity phase:
start, update, or end.severityMapped to
crit, warn, success, or info.start_textLabel for the start state. Defaults to
Activity Start.end_textLabel for the end state. Defaults to
Activity End.stepsOptional progress steps for the activity progress bar.
progressCurrent progress value.
progress_legendShow progress legend. Defaults to
true.tokenUsed for matching update and end messages with the original activity.
dismissal_delayDelay in seconds before the activity disappears after completion.
Usage Notes
For update and end messages, the following parameters should be reused from the start message unless intentionally changed:
- title
- body
- severity
- steps
- progress_legend
- start_text
- end_text
If these parameters are omitted, the appearance of the activity may change.