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.