Native iOS push notifications for your OpenClaw agents (no PWA)

#ai #opensource #productivity #webdev

OpenClaw agents run on a Mac (a Gateway). You talk to them from Telegram, the Control UI, or the official iOS app. Once you close the app, you can miss agent events unless you keep a PWA open.

I built reply-push-v2, an OpenClaw plugin that sends native APNs push notifications to the official OpenClaw iOS app. No PWA, no background tab, no polling.

Free edition 2.1.1: agentFinished notifications.
Pro edition: agentQuestion, humanMentioned, scheduledTaskFailed, and subagentFailed, plus an optional agent allowlist and custom mention regex.

Compatibility

Package: 2.1.1
OpenClaw build target: 2026.9.6
Plugin API: >=2026.3.24-beta.2

Why native

Your Gateway holds no APNs keys: notifications go through the hosted OpenClaw push relay (ios-push-relay.openclaw.ai). The plugin auto-detects your paired iPhone node, so a single-device setup needs zero device configuration. It respects NIGHT_MODE and dedupes per category for 15 seconds.

Requirements

OpenClaw Gateway with plugin support
Official OpenClaw iOS app, paired and approved with the Gateway
iOS notifications enabled for the app
Reachability to ios-push-relay.openclaw.ai
iOS only; Android is not supported

Install (recommended)

Install the free package with npm:

openclaw plugins install reply-push-v2

Enable the plugin and its conversation hook in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "reply-push-v2": {
        "enabled": true,
        "hooks": { "allowConversationAccess": true }
      }
    }
  }
}

Restart the Gateway and verify:

openclaw plugins list

You should see the Free edition with agentFinished enabled. Ask your agent to complete a turn and check the iPhone lock screen.

Manual fallback

If npm installation is unavailable, unzip the package into ~/.openclaw/plugins/reply-push-v2/, add the same plugins.entries entry above, restart the Gateway, and run openclaw plugins list.

DEV Community