description: Send Live-Activities & Ongoing-Notifications to your iOS / Android phones using Signalgrid. homepage: "https://web.signalgrid.co" metadata: clawdbot: emoji: 📲 primaryEnv: SIGNALGRID_CLIENT_KEY requires: bins: - node env: - SIGNALGRID_CLIENT_KEY - SIGNALGRID_CHANNEL name: signalgrid-activity

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

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.