discord-command-control

name	discord-command-control
category	productivity
description	Operate and troubleshoot the Discord-based agent control system. Use when managing Discord channels, setting up commands, troubleshooting integrations, or configuring platform delivery.

Discord Command Control

Manage the Discord integration for agent control and communication.

Current Setup

• Connected to Discord platform via gateway
• Free response channels: 1488962442460528853, 1488962442460528854
• Auto-thread creation enabled
• Reactions enabled

Commands

Agent responds to:

• @mention messages (requires mention per config)
• Thread-based conversations
• Direct channel commands in free response channels

Troubleshooting

Agent Not Responding

1. Check gateway status: systemctl --user status hermes-gateway
2. Check logs: cat /root/.hermes/gateway.log
3. Restart if needed: systemctl --user restart hermes-gateway

Platform Connection Issues

• Verify Discord bot token in .env
• Check gateway_state.json for connection status
• Review discord_threads.json for active threads

Message Delivery

• Messages go through gateway → platform → Discord
• Check delivery.py for routing issues
• Verify channel IDs in config

Workflow

1. User sends message in Discord
2. Gateway receives via webhook
3. Agent processes and responds
4. Response delivered back to Discord channel/thread

Pitfalls

• Rate limits on free tier (8 RPM)
• Token changes break connection
• Channel ID changes require config update
• Auto-threads can accumulate