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:
```bash
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:
```bash
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:
```bash
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:
``` bash
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.
标签
skill
ai