配置项
插件的配置 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）
bash
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_ENV | 覆盖当前环境（development/test/production），效果等价于 ntf env switch。 |
PHONE_NOTIFICATIONS_STATE_DIR | 覆盖插件状态目录。 |
PHONE_NOTIFICATIONS_CONFIG_PATH | 覆盖宿主配置文件路径。 |
PHONE_NOTIFICATIONS_CLAW_PROFILE | 指定 CLI profile。 |
OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD / OPENCLAW_GATEWAY_PORT | 宿主 gateway 鉴权透传（QClaw 场景对应 QCLAW_* 变体）。 |
OPENCLAW_HOST_DEVELOPMENT / _TEST / _PRODUCTION | 覆盖对应环境下 Relay / 灯效 API 的域名，一般只在自建/内网环境下需要。 |
宿主状态目录的自动探测还依赖 JVSCLAW_STATE_DIR/JVSCLAW_HOME/JVSCLAW_CONFIG_PATH、OPENCLAW_STATE_DIR/OPENCLAW_ROOT/OPENCLAW_HOME、QCLAW_STATE_DIR/QCLAW_HOME 等变量，通常由宿主自动设置，手动改写前确认清楚当前跑在哪种宿主下。