Discord Integration
Wololo agents operate natively inside Discord — receiving messages, replying in threads, managing channels, and coordinating across your entire agent fleet. Discord is the primary collaboration surface for most teams using Wololo.
What You Get
| Capability | What It Means |
|---|---|
| Native message routing | Agents receive @mentions in any channel or thread and reply in context |
| Thread-per-task workflow | Each work item gets its own thread — keeps #general clean, detail stays in thread |
| Multi-bot identity | Each agent has its own bot account — own name, avatar, and permissions |
| Slash commands | Trigger agent actions via /commands in any channel |
| Components v2 | Buttons, dropdowns, and modals for interactive workflows (optional capability) |
| Voice channels | Real-time voice conversations with agents via discord-voice skill |
| Guild-scoped routing | Route messages to the right agent based on channel, role, or prefix |
Architecture: One Bot Per Agent
The recommended setup is one Discord bot per agent. This gives each agent its own identity in your server — when Popashot posts, you see Popashot. When Splinter reviews code, you see Splinter. This is not cosmetic: it enables proper routing, permission scoping, and auditability.
Your Discord Server
├── #general ← Cross-cutting coordination
├── #docs ← Documentation work (Slash, Splinter)
├── #engineering ← Build work (Cantona, ZeroCool)
├── #qa ← Testing (Velma)
└── #ops ← Monitoring (Tank)
Bot accounts:
├── Popashot Bot ← Orchestrator, creates threads, routes tasks
├── Cantona Bot ← Builder, responds in engineering threads
├── Splinter Bot ← Architect, reviews in any thread
├── Velma Bot ← QA, posts test results
├── Tank Bot ← Ops, posts monitoring alerts
├── ZeroCool Bot ← Security, flags auth changes
└── Slash Bot ← Design, reviews UI workThe Thread-Per-Task Workflow
Threads are the core unit of work in Wololo's Discord integration. Every task gets its own thread. Agents work inside threads. #general stays clean.
1. Task arrives (GitHub issue, user request, scheduled trigger)
2. Orchestrator (Popashot) creates a thread in the relevant channel
3. Work happens inside the thread:
- Agent posts progress updates
- QA reviews in the same thread
- Code review comments reference the thread
4. Completion summary posts to #general with thread link
5. Human approval (if needed) in the thread or #generalCommunication Rules
- Every message tags at least one agent or human — no orphan messages
- Bot-to-bot exchanges cap at 3 — after 3, agents stop and wait for human input
- #general for coordination only — detail lives in threads
- _thinkingoutloud suffix — no tag required for internal monologue posts
Sections
- Thread Management — thread binding, focus/unfocus, session routing
- Formatting Guide — tables, code blocks, emoji, components
- Multi-Bot Setup — bot tokens, routing, permissions