MatrixSwarm Relay Protocol v1.1
Modular Telegram + Discord Alerts from File-Based AI Agents
MatrixSwarm is a fully decentralized, file-native swarm operating system.
It doesn’t run servers. It doesn’t use containers. It breathes through folders and messages.
In Relay Protocol v1.1, we taught MatrixSwarm how to speak — and listen — through Telegram and Discord using a fully modular system of factory-injected alert relays.
This isn’t just notification spam. It’s logic-aware, agent-triggered dispatching powered by .msg drops — and it’s customizable per node.
✨ What's New in Relay Protocol v1.1
| Feature | Description |
|---|---|
| 🔌 Factory-Only Injection | All logic now injected via config["factories"] — no cluttered configs |
| 🛡 Reserved Key Filtering |
bot_token, chat_id, etc. no longer parsed as factories |
| 📦 Modular Alert Dispatcher |
alert.subscriber factory works with both Telegram & Discord |
| 🗃 Inbox Auto-Creation | Agents build their own folder trees: /incoming/alarm_listener/level
|
| 🧵 Named Reflex Threads | Every alert listener thread is named & traceable (agent_reflex) |
| ⏱ Synchronized Launch | Reflex threads launch only after agent.running = True
|
| 🧪 Verified in Combat | Messages landed in live Discord + Telegram channels |
| 🖼 Codex Evidence Logged | Timestamped .ots + screenshots for historical verification |
📦 The Agent Tree
Telegram Agent Example
"config": {
"role": "alarm_listener",
"factories": {
"alert.subscriber": {
"bot_token": "your_bot_token_here",
"chat_id": "your_chat_id_here",
"levels": ["critical", "warning"]
}
}
}
How It Works
An agent (like alarm-streamer-1) detects a critical event
It writes a .msg file to /comm/telegram-relay-1/incoming/alarm_listener/critical/
The alert.subscriber factory scans the folder
It parses the payload and sends it via Telegram or Discord API
The message lands in your target channel — no socket, no server, no dependency
Example Alert
"📡 Telegram Swarm Alert
universal_id: oracle-1
level: critical
cause: LLM memory overload"
Delivered straight from a swarm agent in /pod/ to a human on Telegram.
Want to build your own swarm agent with Telegram output?
git clone https://github.com/matrixswarm/matrixswarm
cd matrixswarm
python3 bootloader.py
Then wire up your agent_tree.json, add a factory, and drop a .msg.
Matrix will take care of the rest.
🔗 Follow the Swarm
GitHub: github.com/matrixswarm/matrixswarm
Dev.to: @matrixswarm
Discord: MatrixSwarm Agent
Codex Entry: “The Swarm Speaks”
X/Twitter: @matrixswarm
📜 Fork It Clause
MatrixSwarm is open.
Fork it.
Or Fork U.
(Spawn the Swarm.)
📜 MatrixSwarm Codex — Breath, Death, Memory
Top comments (0)