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:
CODEBLOCK0
Update Live Activity:
CODEBLOCK1
End Live Activity:
CODEBLOCK2
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/
`` bash
clawdhub --workdir ~/.openclaw install signalgrid-activity
CODEBLOCK3
SIGNALGRID_CLIENT_KEY=your_client_key_here
SIGNALGRID_CHANNEL=your_channel_name_here
```
- - Signalgrid notifications do not require a phone number or
message target.
Signalgrid 实时活动
通过 Signalgrid API 向您的手机发送实时活动和持续通知。
使用场景
当用户要求执行以下操作时使用此技能：
o 启动持续通知
o 更新持续通知的进度
o 显示实时活动/实时进度
o 在某个任务运行期间（部署、备份、导入、CI 作业等）保持通知更新
o 结束/完成持续通知
启动实时活动：
bash
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type start \
--title OpenClaw \
--body 正在启动… \
--severity info \
--steps 1 \
--progress 10 \
--progress_legend true \
--start_text 活动开始 \
--end_text 活动结束 \
更新实时活动：
bash
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type update \
--token MX2L2K \
--title OpenClaw \
--body 步骤 3/6 \
--severity warning \
--steps 1 \
--progress 50 \
--progress_legend true \
--start_text 活动开始 \
--end_text 活动结束 \
结束实时活动：
bash
node {baseDir}/skills/signalgrid-activity/signalgrid-activity.js \
--type end \
--token MX2L2K \
--title OpenClaw \
--body 完成 \
--severity success \
--steps 1 \
--progress 100 \
--progress_legend true \
--start_text 活动开始 \
--end_text 活动结束 \
--dismissal_delay 60
参数
| 名称 | 类型 | 描述 |
|---|
| title | string | 活动标题。默认为 无标题。 |
| body |
string | 活动正文。默认为 无正文。 |
| type | enum | 活动阶段。常用值：start、update、end。默认为 start。 |
| severity | string | 映射到 crit、warn、success、info（参见备注）。 |
| start_text | string | 可选。开始状态的标签。默认为 活动开始。 |
| end_text | string | 可选。结束状态的标签。默认为 活动结束。 |
| steps | number | 可选。用于进度条显示，如果设置为 5，则进度条有 5 个步骤。默认为 5。 |
| progress | number | 当前进度值。默认为 10。 |
| progress_legend | boolean | 可选。显示进度图例。默认为 true（以字符串形式传递）。 |
| token | string | 可选。仅用于更新和结束消息，用于匹配活动。 |
| dismissal_delay | string | 可选。发送结束消息后活动显示的延迟时间。仅用于结束消息。 |
使用方法
在更新和结束消息中，以下参数需要从开始消息中获取，并在未另行定义时重新传递：
o title
o body
o severity
o steps
o progress_legend
o start_text
o end_text
否则活动将改变其外观。
出于灵活性允许这样做，但大多数情况下不需要。
备注
- - 需要 Signalgrid 账户：https://web.signalgrid.co/
bash
clawdhub --workdir ~/.openclaw install signalgrid-activity
- - 并确保您的 OpenClaw 工具配置文件 设置为 full（配置 -> 工具 -> 工具配置文件）
- - 配置环境变量（配置 -> 环境 -> 环境变量覆盖 + 添加条目）：
SIGNALGRIDCLIENTKEY=您的客户端密钥
SIGNALGRID_CHANNEL=您的频道名称
- - Signalgrid 通知不需要电话号码或消息目标。
