核心用法
Pocket Alert 是一个面向自动化工作流的跨平台推送通知服务，通过 CLI 工具与 OpenClaw 深度集成。用户可借助该技能将服务器监控、CI/CD 流水线、定时任务等场景的实时状态即时推送到 iOS 和 Android 设备。
主要功能模块：
- 消息推送：支持基础标题+内容推送，可定向发送至特定应用、特定设备或全部设备
- 资源管理：提供消息历史、应用、设备、Webhook、API 密钥的完整 CRUD 操作
- Webhook 集成：支持模板变量解析，可对接 GitHub/GitLab 等外部系统的回调事件
- 配置灵活：支持自定义 API 端点，满足自托管部署需求
典型使用场景：
- 服务器异常监控（NGINX 宕机、磁盘空间不足等即时告警）
- CI/CD 部署状态通知（构建成功/失败、版本发布）
- 定时任务执行报告（cron 任务完成状态、系统健康检查）
显著优点
1. 跨平台原生推送：同时覆盖 iOS 和 Android，无需分别为双端配置不同服务
2. CLI 优先设计：命令行工具轻量、脚本友好，易于嵌入 shell 脚本和自动化流水线
3. 粒度可控：支持按应用、按设备、全局广播三级推送策略，适应不同通知密度需求
4. Webhook 模板化：通过 %variable% 语法实现动态内容注入，减少重复配置
5. 自托管支持：可配置自定义 base_url，满足数据合规或私有部署场景
潜在缺点与局限性
1. 生态依赖单一：需依赖 pocketalert.app 第三方 SaaS 服务（或自建），存在服务商稳定性风险
2. 无官方 SDK：仅有 CLI 工具，如需在复杂应用内深度集成需自行封装
3. 消息历史有限：messages list 命令的存在暗示历史消息可能受限于服务端保留策略
4. 认证方式单一：仅支持 API Key 认证，缺乏 OAuth2 等更精细的权限控制机制
5. 网络可达性要求：推送服务依赖公网或内网可达的 API 端点，离线/隔离环境受限
适合人群
- DevOps/SRE 工程师：需要低成本、快速搭建服务器监控告警通道
- 自动化开发者：使用 OpenClaw 编排工作流，需移动端实时状态感知
- 小型团队/独立开发者：不愿维护复杂推送基础设施，追求即开即用
- 自托管偏好者：有数据主权要求，希望将推送服务部署在私有环境
常规风险
- API 密钥泄露风险：CLI 配置存储于
~/.pocketalert/config.json，需确保文件权限受控（建议chmod 600） - 消息内容暴露：推送内容可能经过第三方服务商网络，敏感信息建议脱敏或使用自托管实例
- 服务连续性风险：若 pocketalert.app 服务中断，自动化告警链路将失效，关键场景建议配置降级方案（如邮件/短信备份）
- 速率限制未知：官方文档未明确 API 调用频率限制，高并发场景需实测验证
- 设备令牌漂移：移动端应用卸载重装或系统更新可能导致 device-tid 变化，需设计设备管理容错机制