messaging-gateway-troubleshooting

Diagnose Hermes messaging gateway webhook, authorization, delivery, and reply-loop failures.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill messaging-gateway-troubleshooting-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: messaging-gateway-troubleshooting
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/hermes/messaging-gateway-troubleshooting
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill messaging-gateway-troubleshooting-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Messaging platforms connected to Hermes sometimes stop delivering messages, ignore senders, or risk reply loops, and it is hard to tell whether the cause is transport, authorization, or adapter filtering. This Skill provides a structured diagnostic workflow to isolate the failing layer and verify fixes with real command output. ## Core Features & Use Cases - End-to-end path verification: Checks gateway service, platform server, webhook listener, health endpoints, and adapter logs before assuming config is wrong. - Platform-specific runbooks: Covers Telegram forum session scoping for /sessions and /resume, BlueBubbles/iMessage self-message loop guards, and memory-context injection probe handling. - Loop-prevention guidance: Recommends outbound-ID-based echo filtering instead of blanket isFromMe skips, plus IPv4/IPv6 localhost pitfalls on macOS. - Use Case: A user texts Hermes from their own iMessage identity and gets no reply; the Skill guides checking webhook registration, the outbound-ID loop-guard cache, and gateway logs to restore delivery without disabling loop protection. ## Quick Start Ask the assistant to troubleshoot why Telegram messages to Hermes are not getting replies and have it verify the gateway, webhook, and authorization path step by step.

Frequently Asked Questions about messaging-gateway-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Hermes gateway messages not arriving?

Verify the live path end to end: gateway service running, platform server up, webhook listener bound, health endpoint responding, and webhook registered on the platform. Then check gateway logs to confirm the adapter connected before assuming config is wrong.

Why does Hermes ignore my iMessage sent from my own Apple ID?

BlueBubbles marks messages from the Mac's own iMessage identity as isFromMe=true, and a blanket skip of those messages blocks the owner too. The fix is an outbound-ID-based loop guard that ignores only echoes matching Hermes-sent message IDs.

Why is /sessions empty in a new Telegram forum topic?

Telegram forum topics have distinct thread_id values under one parent chat, so exact-thread filtering hides sessions from sibling topics. A Telegram-only sibling-topic path requiring same parent chat and same owner restores visibility without weakening other authorization checks.

Does the BlueBubbles webhook work with localhost on macOS?

Not reliably. BlueBubbles, Electron, and Node may resolve localhost to IPv6 ::1, causing ECONNREFUSED while IPv4 health checks pass. Register the webhook as http://127.0.0.1:<port>/... unless Hermes also listens on IPv6.

Why does a Telegram photo message make Hermes hang?

A multimodal regression caused repeated TypeError failures in strip_think_blocks during interim commentary handling, looping until the iteration cap. Stop the turn, update Hermes, reapply local patches, restart the gateway, and verify with a real photo plus caption.