手机通知插件

@yoooclaw/phone-notifications 是 OpenClaw / QClaw 插件，负责手机通知接收与本地存储、通知查询/摘要/统计、定时监控、长录音同步与 ASR 转写、硬件灯效控制与规则评估，以及 Relay Tunnel 连通。

功能概览

• 手机通知接收与本地 JSON 存储，支持 Gateway Native 和 HTTP 备选接入。
• 通知查询、摘要、统计、按日期同步给记忆系统。
• 定时通知监控任务，适合 Agent 周期性处理重点消息。
• 硬件灯效控制与灯效规则管理，支持通知触发后的异步评估。
• 长录音同步、音频下载、ASR 转写和 Markdown 转写稿落盘。
• Relay Tunnel 状态检查与远程连通能力。

安装

OpenClaw CLI 安装

适用于有全局 openclaw 命令的标准 OpenClaw 环境：

openclaw plugins install @yoooclaw/phone-notifications
openclaw plugins update @yoooclaw/phone-notifications

验证：

openclaw ntf --help
openclaw ntf --version

如果已有其他插件占用了 ntf 命令，可使用别名：

openclaw phone-notifications --help

一键脚本安装

推荐给 QClaw，也可作为 OpenClaw 备选方式。脚本会从 CDN 下载插件包，自动探测宿主状态目录，写入插件注册配置，并在失败时回滚。

macOS / Linux：

curl -fsSL https://artifact.yoooclaw.com/plugin/install.sh | bash

Windows PowerShell：

& ([scriptblock]::Create((irm https://artifact.yoooclaw.com/plugin/install.ps1)))

常用选项：

选项	说明
--version <ver>	安装指定版本，不传则自动获取最新版本。
--tgz-url <url|path>	使用指定插件包地址或本地包。
--target-dir <path>	指定安装目录。
--state-dir <path>	指定 OpenClaw / QClaw 状态目录。
--config-path <path>	指定宿主配置文件路径。
--api-key <key>	安装时写入灯控等能力使用的 API Key。
--retention-days <n>	设置通知数据保留天数；不传则永久保存。

示例：

curl -fsSL https://artifact.yoooclaw.com/plugin/install.sh | bash -s -- --version 1.11.17-beta.8
curl -fsSL https://artifact.yoooclaw.com/plugin/install.sh | bash -s -- --api-key ock_xxx

QClaw 通常没有全局 openclaw 命令。插件安装后如果没有立即生效，请重启 QClaw 桌面应用；如需执行 OpenClaw 子命令，请使用 QClaw 自带 wrapper。

下一步

• 工作方式与存储 —— 两种接入模式与本地数据布局。
• 命令参考 —— openclaw ntf 常用命令。
• 配置项 —— 保留天数、忽略 app、Relay、ASR 等。