配置项

插件的配置 schema 由插件包内的 openclaw.plugin.json 定义，常用字段见下表。

常用配置

配置	说明
retentionDays	通知数据保留天数；不设置则永久保存。
ignoredApps	要忽略的 app 包名列表。
relay.heartbeatSec	插件与 Relay 的心跳间隔。
relay.reconnectBackoffMs	Relay 重连退避时间。
autoUpdate.enabled	是否启用插件自动更新检查。
autoUpdate.checkIntervalHours	自动更新检查间隔。
autoUpdate.channel	更新频道，支持 latest 和 beta。
asr.mode	录音转写方式，支持 api、local、yoooclaw。
asr.api.*	云端 ASR 参数。
asr.local.*	本地 Whisper 参数。

设置示例（OpenClaw）

openclaw config set plugins.entries.phone-notifications.config.retentionDays 30
openclaw config set plugins.entries.phone-notifications.config.ignoredApps '["com.android.systemui"]'

relay.*、asr.api.*、asr.local.* 这几组配置在 schema 里都是 additionalProperties: false，写入未知字段会导致宿主端 schema 校验直接失败，排查配置不生效时先检查有没有拼错字段名。

相关环境变量

除了 openclaw config set 写入 openclaw.json，插件还会读取以下环境变量，调试环境隔离、多 key 场景时常用：

环境变量	说明
YOOOCLAW_API_KEY	覆盖 credentials.json 里的 apiKey，优先级最高。
PHONE_NOTIFICATIONS_STATE_DIR	覆盖插件状态目录。
PHONE_NOTIFICATIONS_CONFIG_PATH	覆盖宿主配置文件路径。
PHONE_NOTIFICATIONS_CLAW_PROFILE	指定 CLI profile。
PHONE_NOTIFICATIONS_LANG	插件运行时输出（CLI 输出、错误信息、skill 回复）使用的语言，支持 zh-CN / zh-TW / en-US，等价安装器的 --lang。
OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD / OPENCLAW_GATEWAY_PORT	宿主 gateway 鉴权透传及端口（QClaw 场景对应 QCLAW_* 变体）；*_PORT 同时也是 doctor 的 local-gateway checker 探测本地 gateway 时使用的端口（默认 127.0.0.1:18789）。
PHONE_NOTIFICATIONS_GATEWAY_BASE_URL / OPENCLAW_GATEWAY_BASE_URL / QCLAW_GATEWAY_BASE_URL	覆盖 doctor 的 local-gateway checker 探测的本地 gateway 完整 base URL（按此顺序优先取值），不设置时按 *_PORT 拼一个 127.0.0.1 地址。
OPENCLAW_HOST_DEVELOPMENT / _TEST / _PRODUCTION	覆盖对应环境下 Relay / 灯效 API 的域名，一般只在自建/内网环境下需要。

PHONE_NOTIFICATIONS_ENV 环境变量已不再生效：早期版本读它来覆盖当前环境，但 launchd/systemd 托管的进程每次重启都会重新注入一份「托管环境快照」，导致这个变量悄悄盖掉 ntf env switch 刚写的结果。现在只认 ntf env switch 写入状态目录下的 .env 文件，环境变量不再是来源之一——如果你以前靠设这个变量切环境，请改用 openclaw ntf env switch <env>。

宿主状态目录的自动探测还依赖 JVSCLAW_STATE_DIR/JVSCLAW_HOME/JVSCLAW_CONFIG_PATH、OPENCLAW_STATE_DIR/OPENCLAW_ROOT/OPENCLAW_HOME、QCLAW_STATE_DIR/QCLAW_HOME、ECLAW_STATE_DIR/ECLAW_HOME/ECLAW_CONFIG_PATH 等变量，通常由宿主自动设置，手动改写前确认清楚当前跑在哪种宿主下。