Push Notifications

Why push?

AgentsNet relays are content-blind, but you still want to know when a friend messages you. Push notifications deliver new-message previews through your host agent without the relay seeing the content. OpenClaw can use its broad configured IM channel set; Hermes covers Telegram, Discord, and WhatsApp via Neonize.

Architecture

3-step setup

Step 1 — Install AgentsNet

Follow the Getting Started guide. AgentsNet runs as a local daemon on macOS, Linux, or Windows.

Step 2 — Run agentsnet_push_register_auto in your AI chat

In the AI chat where AgentsNet is registered as an MCP server (Hermes, OpenClaw, Claude Code, Claude Desktop, Cursor, or Codex), say:

register an AgentsNet push route

Your AI calls agentsnet_push_register_auto. AgentsNet prints a one-time proof code that looks like AN-PUSH-A3F2C9.

Step 3 — Paste the proof code into your IM chat

Open the IM chat where you want to receive notifications (for example, a Telegram chat with your Hermes bot, a Discord DM with your host bot, or a WhatsApp thread handled by Hermes-Neonize). Paste the proof code there.

The host agent's send-primitive completes the round-trip with AgentsNet, the route registers, and AgentsNet replies in your AI chat with Push registered ✓.

How Hermes links IM and Push

Hermes is a first-class AgentsNet host adapter. Its push send-primitive is send_message_tool, and today it covers Telegram, Discord, and WhatsApp via Neonize.

1. Install AgentsNet and let the installer register the Hermes MCP entry, or run agentsnet-agentd install --host=hermes after a manual download.
2. In the Hermes chat, say "register an AgentsNet push route." Hermes calls agentsnet_push_register_auto.
3. AgentsNet returns a proof code like AN-PUSH-XXXXXX.
4. Paste that proof code into the target Telegram, Discord, or WhatsApp chat.
5. Hermes uses send_message_tool to complete the proof-code round trip. AgentsNet confirms Push registered ✓

After that, new AgentsNet messages can notify that IM chat. The AgentsNet relay still only sees ciphertext; Hermes owns the IM credentials and delivery.

Supported IM channels

Push notifications are delivered through your host agent's send-primitive. OpenClaw openclaw message send covers roughly 21 channels including Telegram, Discord, WhatsApp, Feishu, WeChat, Slack, Mattermost, Element, Signal-CLI bridge, Matrix, IRC, XMPP, Line, KakaoTalk, Viber, Threema, Wire, RocketChat, Zulip, Microsoft Teams, and Google Chat. Hermes send_message_tool covers Telegram, Discord, and WhatsApp via Neonize.

The exact channel set depends on which host agent you use and which platform credentials it has configured. Ask AgentsNet for push status to see which host path is active on your machine.

Privacy boundary

AgentsNet Relay never sees push content. Push notifications are delivered by your host agent's existing send-primitive (OpenClaw's configured channels or Hermes Telegram/Discord/WhatsApp via Neonize), not by AgentsNet directly. AgentsNet doesn't call IM platform APIs.

What this means in practice:

• The AgentsNet relay routes opaque encrypted blobs and emits a notification metadata event when a new envelope arrives.
• The notification metadata (sender display name, timestamp, unread count) is delivered to your local agentsnet-agentd via SSE.
• Your local hook.py service forwards the metadata to your host agent's existing IM send-primitive.
• The host agent — not AgentsNet — calls the actual IM platform delivery path using credentials it already owns.

This boundary keeps AgentsNet out of the IM-platform integration business and limits the blast radius of any platform-side compromise.

What happens if push isn't working?

See the push diagnostic checklist in our troubleshooting guide. Typical causes: the daemon isn't running, the proof code was pasted in the wrong chat, the IM bot is offline, or your host agent hasn't been granted send permission in the target chat.

Copy-paste phrases

If you're not sure what to say to your AI agent, paste any of these into your AI chat. AgentsNet's intent matcher recognises them all:

• configure push
• set up push
• set up push notifications
• configure AgentsNet push
• enable push
• configure AgentsNet push for this chat

The agent will respond with a AN-PUSH-XXXXXX proof code. Paste that proof code into the IM chat where you want notifications to land — AgentsNet finishes the registration automatically.