SIGNL4 告警管理:面向值班团队的 Webhook 集成 - Openclaw Skills
作者:互联网
2026-03-30
什么是 SIGNL4 告警管理?
Openclaw Skills 的 SIGNL4 技能使开发人员能够将移动告警和事件管理直接集成到他们的自动化工作流中。通过利用 SIGNL4 入站 Webhook,此技能允许以编程方式创建高优先级告警,并在问题解决后随后恢复这些事件。这确保了值班团队无需人工干预即可收到及时、可操作的通知。
该技能在构建时考虑了安全性和效率,通过嵌入在 Webhook URL 中的团队密钥来管理身份验证。它支持广泛的元数据,包括服务分类、告警场景和地理位置,为响应者提供快速行动所需的所有上下文。
下载入口:https://github.com/openclaw/skills/tree/main/skills/rons4/signl4
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install signl4
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 signl4。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
SIGNL4 告警管理 应用场景
- 当检测到生产系统故障时,自动触发高优先级移动告警。
- 当自动化恢复脚本或健康检查确认系统重新上线后,恢复事件告警。
- 将值班通知纳入 CI/CD 流水线,以提醒团队部署失败。
- 为外勤服务操作或物理硬件故障发送带有位置标记的告警。
- 该技能从环境配置中获取 SIGNL4 团队密钥,以构建安全的 Webhook 端点。
- 触发告警时,它向 SIGNL4 发送一个 HTTP POST 请求,其中包含带有标题、消息和唯一外部 ID 的 JSON 负载。
- SIGNL4 接收 Webhook 并根据值班表和升级规则通知相应的团队成员。
- 要关闭告警,该技能使用相同的唯一外部 ID 发送后续请求,并将状态更新为已解决。
SIGNL4 告警管理 配置指南
要在 Openclaw Skills 生态系统中使用此技能,必须安装 curl 并配置所需的环境变量:
export SIGNL4_TEAM_SECRET="your_team_secret_here"
(可选)如果您使用的是自定义或企业端点,可以定义基础 URL:
export SIGNL4_WEBHOOK_BASE="https://connect.signl4.com/webhook"
SIGNL4 告警管理 数据架构与分类体系
该技能利用结构化 JSON 负载与 SIGNL4 API 通信。以下参数用于组织告警元数据:
| 参数 | 描述 | 是否必填 |
|---|---|---|
| Title | 告警的简短摘要。 | 是 |
| Message | 事件的详细说明。 | 是 |
| X-S4-ExternalID | 用于关联告警创建和恢复的唯一 ID。 | 强烈建议 |
| X-S4-Status | 设置为 new 创建或 resolved 关闭告警。 |
是 |
| X-S4-Service | 在特定服务下对告警进行分类。 | 否 |
| X-S4-Location | "纬度,经度" 格式的 GPS 坐标。 | 否 |
| X-S4-AlertingScenario | 定义通知行为(例如:紧急)。 | 否 |
name: signl4
description: Send and close SIGNL4 alerts using the SIGNL4 inbound webhook (team secret in URL).
metadata: {"openclaw":{"emoji":"??","requires":{"bins":["curl"],"env":["SIGNL4_TEAM_SECRET"]},"primaryEnv":"SIGNL4_TEAM_SECRET"}}
Overview
Use this skill to interact with SIGNL4 via its inbound webhook:
- Send alerts to a SIGNL4 team
- Close (resolve) alerts using an external correlation ID
Authentication is handled via the team secret embedded in the webhook URL.
Webhook documentation: https://docs.signl4.com/integrations/webhook/webhook.html
Required configuration
The following environment variable must be set:
SIGNL4_TEAM_SECRET– the SIGNL4 team secret used in the webhook URL
Optional (advanced):
SIGNL4_WEBHOOK_BASE– defaults tohttps://connect.signl4.com/webhook
Inputs to gather from the user
When sending an alert
Required:
- Title – short summary
- Message – detailed description
- External ID – strongly recommended (required to close the alert later)
Optional:
- Service (
X-S4-Service) - Alerting scenario (
X-S4-AlertingScenario– e.g.single_ack,multi_ack,emergency) - Location (
X-S4-Location, format:"lat,long")
When closing an alert
Required:
- External ID – must match the ID used when the alert was created
How to send an alert
Rules
- Always include
X-S4-ExternalIDif the alert might need to be closed later. - Use
X-S4-Status: "new"to create an alert.
Command template
Set the webhook URL:
WEBHOOK_URL="${SIGNL4_WEBHOOK_BASE:-https://connect.signl4.com/webhook}/${SIGNL4_TEAM_SECRET}"
Send the alert:
curl -sS -X POST "$WEBHOOK_URL" r
-H "Content-Type: application/json" r
-d '{
"Title": "",
"Message": "",
"X-S4-ExternalID": "",
"X-S4-Status": "new",
"X-S4-Service": "",
"X-S4-AlertingScenario": "",
"X-S4-Location": "",
"X-S4-SourceSystem": "OpenClaw"
}'
What to report back
- Confirm that the alert was sent
- Repeat key details:
- Title
- External ID
- Optional service/scenario
If the request fails:
- Check that
SIGNL4_TEAM_SECRETis set and correct - Ensure JSON fields are valid
How to close (resolve) an alert
Rules
To close an alert, you must:
- Use the same External ID as when the alert was created
- Set
X-S4-Statustoresolved
Command template
curl -sS -X POST "$WEBHOOK_URL" r
-H "Content-Type: application/json" r
-d '{
"X-S4-ExternalID": "",
"X-S4-Status": "resolved"
}'
What to report back
- Confirm the resolve request was sent for the given External ID
- If the External ID is missing, ask the user for it
Security notes
- Treat
SIGNL4_TEAM_SECRETas confidential - Never print or echo the team secret in responses or logs
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
信号管道:自动化营销情报工具 - Openclaw Skills
技能收益追踪器:监控 Openclaw 技能并实现变现
AI 合规准备就绪度:评估与治理工具 - Openclaw Skills
FOSMVVM ServerRequest 测试生成器:自动化 API 测试 - Openclaw Skills
酒店搜索器:AI 赋能的住宿与位置情报 - Openclaw Skills
Dub 链接 API:程序化链接管理 - Openclaw Skills
IntercomSwap:P2P BTC 与 USDT 跨链兑换 - Openclaw Skills
spotplay:macOS 原生 Spotify 播放控制 - Openclaw Skills
DeepSeek OCR:AI驱动的图像文本识别 - Openclaw Skills
Web Navigator:自动化网页研究与浏览 - Openclaw Skills
AI精选
