discord-connect

Configure and troubleshoot Discord bot connections for the Hermes gateway.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Discord bot for Hermes involves many failure-prone steps — tokens, intents, OAuth2 scopes, guild installs, and channel discovery — and this Skill provides a guided path through setup plus diagnosis of the most common failure modes. ## Core Features & Use Cases - Guided Bot Setup: Walks through creating a Discord application, generating a bot token, enabling Message Content Intent, and building the OAuth2 invite URL with correct permissions. - Failure Diagnosis: Covers concrete failure patterns such as "integration requires code grant", silent bots, ✅-only reactions from unauthorized users, and empty channel discovery in channel_directory.json. - Voice and Gateway Troubleshooting: Resolves ffmpeg/opus voice playback issues, idle typing loops, and gateway restart procedures on macOS via launchctl. - Use Case: A user invites their Hermes bot to a Discord server but gets no replies; the Skill directs them to check DISCORD_ALLOWED_USERS, restart the gateway, and verify with a real @mention. ## Quick Start Help me connect my Hermes agent to Discord and verify the bot can send and receive messages in my server.

Frequently Asked Questions about discord-connect

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

FAQPage Schema
How do I set up a Discord bot for Hermes?

Create an application in the Discord Developer Portal, generate a bot token, enable the Message Content Intent, and invite the bot with an OAuth2 URL using the bot scope and permissions 3558496. Then set DISCORD_BOT_TOKEN via hermes config and restart the gateway.

Why is my Discord bot connected but not responding to messages?

A connected bot that stays silent usually lacks the Message Content Intent, which makes messages arrive as empty strings. Enable it under Bot → Privileged Gateway Intents in the Developer Portal, then restart the Hermes gateway.

Why does Discord show 'integration requires code grant' during install?

This error means the application has Bot → Authorization Flow → Requires OAuth2 Code Grant enabled. The owner must disable it in the Developer Portal and save, then reopen the invite URL to complete the guild install.

Why does the bot only react with a checkmark and no reply?

A ✅-only reaction means Hermes received the message but dropped it due to authorization. Check gateway logs for 'Unauthorized user' and add the sender's Discord ID to DISCORD_ALLOWED_USERS, then restart the gateway.

Does the Discord bot token go in config.yaml or an environment variable?

The token must be set as the DISCORD_BOT_TOKEN environment variable in .env, not only in config.yaml's discord.token field. The Discord adapter reads only the environment variable, so set it with hermes config set and restart the gateway.

How do I fix Discord voice playback failing with ffmpeg not found?

Install playback dependencies with brew install ffmpeg opus, verify the Hermes venv can load libopus via discord.opus.load_opus, then restart the gateway. The smoking-gun log line is 'Auto voice reply failed: ffmpeg was not found'.