The latest articles on DEV Community by Verdeoc (@verdeoc). https://dev.to/verdeoc https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4160359%2F959c04e7-eca1-4360-a701-1ead0055cefd.png https://dev.to/verdeoc en Verdeoc Sat, 03 Oct 2026 19:02:43 +0000 https://dev.to/verdeoc/native-ios-push-notifications-for-your-openclaw-agents-no-pwa-5b4i https://dev.to/verdeoc/native-ios-push-notifications-for-your-openclaw-agents-no-pwa-5b4i <p>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.</p> <p>I built <strong>reply-push-v2</strong>, an OpenClaw plugin that sends real native APNs push notifications to the <strong>official OpenClaw iOS app</strong>. No PWA, no background tab, no polling.</p> <h2> What it does </h2> <ul> <li> <code>agentFinished</code> — an agent finished its turn (<strong>free</strong>)</li> <li> <code>agentQuestion</code> — an agent asks you something via <code>ask_user</code> (Pro)</li> <li> <code>humanMentioned</code> — you are mentioned in a conversation (Pro)</li> <li> <code>scheduledTaskFailed</code> — a cron/scheduled task failed (Pro)</li> <li> <code>subagentFailed</code> — a subagent ended with error/timeout/kill (Pro)</li> </ul> <h2> Why native </h2> <p>Your Gateway holds no APNs keys: notifications go through the hosted OpenClaw push relay (<code>ios-push-relay.openclaw.ai</code>). The plugin auto-detects your paired iPhone node (iPhone preferred over Apple Watch), so a single-device setup needs <strong>zero config</strong>. It respects <code>NIGHT_MODE</code> and dedupes per category (15 s).</p> <h2> Install (about 2 minutes) </h2> <ol> <li>Unzip into <code>~/.openclaw/plugins/reply-push-v2/</code> </li> <li>In <code>~/.openclaw/openclaw.json</code>, add the plugin to <code>plugins.load.paths</code> and enable its conversation hooks: </li> </ol> <div class="highlight js-code-highlight"> <pre class="highlight json"><code><span class="w"> </span><span class="nl">"reply-push-v2"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"enabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w"> </span><span class="nl">"hooks"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nl">"allowConversationAccess"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="p">}</span><span class="w"> </span></code></pre> </div> <p>(<code>hooks.allowConversationAccess: true</code> is required, otherwise OpenClaw blocks the <code>agent_end</code> hook.)</p> <ol> <li>Restart the Gateway, then confirm with <code>openclaw plugins list</code>.</li> </ol> <p>Or install straight from npm:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>openclaw plugins <span class="nb">install </span>reply-push-v2 </code></pre> </div> <p>On load you will see:<br> <code>[reply-push-v2] FREE edition: agentFinished only. Pro (all 5 categories): Gumroad - search "reply-push-v2"</code></p> <h2> Free vs Pro </h2> <div class="table-wrapper-paragraph"><table> <thead> <tr> <th>Category</th> <th>Free</th> <th>Pro</th> </tr> </thead> <tbody> <tr> <td><code>agentFinished</code></td> <td>yes</td> <td>yes</td> </tr> <tr> <td><code>agentQuestion</code></td> <td>—</td> <td>yes</td> </tr> <tr> <td><code>humanMentioned</code></td> <td>—</td> <td>yes</td> </tr> <tr> <td><code>scheduledTaskFailed</code></td> <td>—</td> <td>yes</td> </tr> <tr> <td><code>subagentFailed</code></td> <td>—</td> <td>yes</td> </tr> </tbody> </table></div> <p>Pro adds an agent allowlist, custom mention regex and priority support.</p> <h2> Links </h2> <ul> <li>GitHub (MIT, free edition): <a href="https://github.com/verdeoc/reply-push-v2" rel="noopener noreferrer">https://github.com/verdeoc/reply-push-v2</a> </li> <li>Release v2.1.0: <a href="https://github.com/verdeoc/reply-push-v2/releases/tag/v2.1.0" rel="noopener noreferrer">https://github.com/verdeoc/reply-push-v2/releases/tag/v2.1.0</a> </li> <li>ClawHub: reply-push-v2</li> <li>Pro: search <strong>reply-push-v2</strong> on Gumroad</li> </ul> <p>Feedback welcome — especially which of the five categories matter most to you.</p> ai opensource productivity webdev