- description
- Send Live-Activities & Ongoing-Notifications to your iOS / Android phones using
- homepage
- https://web.signalgrid.co
- metadata
- clawdbot
- emoji
- 📲
- primaryEnv
- SIGNALGRID_CLIENT_KEY
- requires
- bins
- env
- 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 60Parameters
| 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.