核心用法
gateway-notify 通过 OpenAWS 内部 Hook 系统在网关启动时自动发送通知。用户运行 ./scripts/setup_gateway_notify.sh <channel> <address> 即可完成配置,支持 iMessage、WhatsApp、Telegram、Discord 等主流通讯渠道。脚本自动创建 Hook 目录、生成事件处理器并启用配置,最后重启网关生效。
显著优点
1. 即开即用:单条命令完成全流程配置,无需手动编辑配置文件
2. 多通道覆盖:原生支持邮件、即时通讯、社交平台的 CLI 推送
3. 事件驱动:基于 gateway:startup 事件触发,非轮询、零延迟
4. 状态完整:通知包含模型、时间、端口等关键网关运行信息
潜在缺点与局限性
- 依赖 OpenAWS 私有 Hook 系统,未开源实现细节
- 脚本需执行网关重启才能生效,生产环境可能中断服务
- 通知渠道依赖本地 CLI 工具(如
osascriptfor iMessage),跨平台兼容性存疑 - 无重试机制,若推送时网络异常可能导致通知丢失
- 配置明文存储于用户目录,多用户环境存在权限风险
适合人群
- 自建 OpenAWS 网关的个人开发者或小型团队
- 需要实时掌握网关健康状态的运维人员
- 使用 macOS/iMessage 生态的苹果用户(兼容性最佳)
常规风险
- 服务中断:首次配置必须重启网关
- 信息泄露:网关状态信息可能包含敏感端口/模型版本
- 渠道依赖:接收方地址错误将导致推送失败且无反馈
- 权限问题:Hook 脚本以网关运行用户身份执行,需注意文件权限