Signalgrid Live Activities

Send Live Activities & Ongoing Notifications to your phone through the Signalgrid API.

When to use

Use this skill whenever the user asks to:
 
  o  start an ongoing notification
  o  update progress of an ongoing notification
  o  show a live activity / live progress
  o  keep a notification updated while something runs (deploy, backup, import, CI job, etc.)
  o  end/finish an ongoing notification

Start 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 60

Parameters

Name	Type	Description
title	string	Activity title. Defaults to No Title.
body	string	Activity body text. Defaults to No Body.
type	enum	Activity phase. Common values: start, update, end. Defaults to start.
severity	string	Mapped to crit, warn, success, info (see Notes).
start_text	string	Optional. Label for the start state. Defaults to Activity Start.
end_text	string	Optional. Label for the end state. Defaults to Activity End.
steps	number	Optional. For the progressbar-prensentation if set to 5, the progressbar has 5 steps. Defaults to 5.
progress	number	Current progress value. Defaults to 10.
progress_legend	boolean	Optional. Show progress legend. Defaults to true (passed as a string).
token	string	Optional. only used with update & end messages. is for matching the activity.
dismissal_delay	string	Optional. The delay a activity is shown after end message is sent. Only on end messages

Usage

In update & end messages the following parameters need to be taken from start message and retransmitted if not defined otherwise:

  o  title
  o  body
  o  severity
  o  steps
  o  progress_legend
  o  start_text
  o  end_text
 
Otherwise the activity will change its appearance. It is allowed for flexibility, but not needed most of the time.

Notes

• Requires a Signalgrid account: https://web.signalgrid.co/  
   
• Install the skill:

clawdhub --workdir ~/.openclaw install signalgrid-activity

• And ensure your OpenClaw Tool Profile is set to full ( Config -> Tools -> Tool Profile )
   
• Configure environment variables ( Config -> Environment -> Environment Variables Overrides + Add Entry):

SIGNALGRID_CLIENT_KEY=your_client_key_here
SIGNALGRID_CHANNEL=your_channel_name_here

 

• Signalgrid notifications do not require a phone number or message target.