OpenClaw agents run on a Mac (a Gateway). You talk to them from Telegram, the Control UI, or the official iOS app. The problem: once you close the app, you stop seeing when an agent finishes or asks you something — unless you keep a PWA open in the background.
I built reply-push-v2, an OpenClaw plugin that sends real native APNs push notifications to the official OpenClaw iOS app. No PWA, no background tab, no polling.
What it does
-
agentFinished— an agent finished its turn (free) -
agentQuestion— an agent asks you something viaask_user(Pro) -
humanMentioned— you are mentioned in a conversation (Pro) -
scheduledTaskFailed— a cron/scheduled task failed (Pro) -
subagentFailed— a subagent ended with error/timeout/kill (Pro)
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 (iPhone preferred over Apple Watch), so a single-device setup needs zero config. It respects NIGHT_MODE and dedupes per category (15 s).
Install (about 2 minutes)
- Unzip into
~/.openclaw/plugins/reply-push-v2/ - In
~/.openclaw/openclaw.json, add the plugin toplugins.load.pathsand enable its conversation hooks:
"reply-push-v2": { "enabled": true, "hooks": { "allowConversationAccess": true } }
(hooks.allowConversationAccess: true is required, otherwise OpenClaw blocks the agent_end hook.)
- Restart the Gateway, then confirm with
openclaw plugins list.
Or install straight from npm:
openclaw plugins install reply-push-v2
On load you will see:
[reply-push-v2] FREE edition: agentFinished only. Pro (all 5 categories): Gumroad - search "reply-push-v2"
Free vs Pro
| Category | Free | Pro |
|---|---|---|
agentFinished |
yes | yes |
agentQuestion |
— | yes |
humanMentioned |
— | yes |
scheduledTaskFailed |
— | yes |
subagentFailed |
— | yes |
Pro adds an agent allowlist, custom mention regex and priority support.
Links
- GitHub (MIT, free edition): https://github.com/verdeoc/reply-push-v2
- Release v2.1.0: https://github.com/verdeoc/reply-push-v2/releases/tag/v2.1.0
- ClawHub: reply-push-v2
- Pro: search reply-push-v2 on Gumroad
Feedback welcome — especially which of the five categories matter most to you.
Top comments (0)