核心用法
ORef Native 是一个专为以色列本土前线指挥部(Pikud Ha-Oref)警报设计的 OpenClaw 原生技能。该技能通过每 5 秒轮询 ORef API,实时监测指定区域的导弹、飞机入侵、地面渗透等威胁警报,并通过 OpenClaw 内置功能直接触发 WhatsApp 消息推送和语音播报(TTS),无需依赖外部系统如 Home Assistant、wacli 或 Docker。
核心配置包括:通过环境变量设置 API 端点、监控区域列表(支持多区域逗号分隔)、WhatsApp 群组 JID 及个人号码,以及指定 openclaw 二进制路径。警报按类型分级路由:导弹(cat=1)、飞机(cat=2)、渗透(cat=10)、解除警报(cat=13)触发 WhatsApp+TTS 双通道;预警信息(cat=14)仅触发 TTS 避免信息过载。
部署方式灵活,支持 nohup 后台运行或 crontab 自启动,日志输出至 /var/log/oref_native.log。
显著优点
- 零外部依赖:彻底摆脱 Home Assistant、wacli 二进制、Docker 等复杂栈,单依赖 OpenClaw 核心,部署极简。
- 原生集成:直接使用
openclaw message和openclaw tts指令,与系统深度耦合,延迟极低。 - 精细化路由:按警报类别智能分流,避免预警信息轰炸群组,同时确保关键威胁多通道触达。
- 区域级定制:支持多区域逗号分隔配置,适配家庭、工作地等不同场景需求。
潜在缺点与局限性
- 地域局限性:专为以色列本土前线警报设计,API 与区域名称均为希伯来语,其他地区用户无法直接使用。
- 无高可用保障:单进程轮询模式,进程崩溃或服务器重启需依赖外部机制(如 systemd/cron)恢复。
- 网络依赖单一:完全依赖 ORef API 可用性,若官方服务中断则无冗余数据源。
- 权限与合规风险:需存储 WhatsApp 群组 JID 和个人号码,且轮询行为可能涉及对官方 API 的频繁请求,存在被封禁或速率限制隐患。
- 缺少可视化:无 Web UI 或状态面板,配置与日志均需命令行操作。
适合人群
- 居住在以色列或需关注以方亲友安全的 OpenClaw 用户
- 追求极简架构、厌恶 Home Assistant 等重量级方案的极客用户
- 需要毫秒级警报触达的紧急响应场景(如庇护所管理、社区安保协调)
常规风险
- 隐私泄露:WhatsApp JID 和个人号码明文存储于环境变量,若系统被入侵可直接获取。
- API 滥用:5 秒高频轮询可能对 ORef 服务器造成压力,存在 IP 被封或服务条款违规风险。
- 误报与漏报:API 延迟或解析错误可能导致警报延迟;依赖外部 API 数据准确性,无本地校验机制。
- 系统稳定性:Python 脚本长期运行可能出现内存泄漏或句柄耗尽,需定期监控日志与进程状态。