Troubleshooting

If nothing here helps, ask in the support server or open a GitHub issue.

Users

Commands do not appear or "unknown interaction"

• Type / and wait a moment for Discord to load commands.
• Make sure Mellow has Use Application Commands and Send Messages in the channel.
• Try the command in a DM to check whether it is server-specific.
• Global commands can take up to an hour to appear after the bot is first added.

"This interaction failed"

• Usually a transient Discord issue; wait a moment and retry.
• Restart your Discord client if it persists.

AI replies are generic, or always the same fixed text

• The same fixed text every time means the AI is unavailable or disabled. Try again later, or use a specific coping command such as /coping breathing.
• For more personalized replies, set your timezone and personality (/preferences set timezone: personality:) and enable context logging (/preferences set context_logging:true).

"Cooldown active" on a command

The reply shows when you can use it again. Coping and fun commands have short per-user cooldowns. Check-in reminders are separate and set with /preferences set checkin_interval: (minutes).

I cannot see my conversation history

• /context view shows what is stored. If context logging is off, nothing is kept.
• /context clear permanently deletes it - it cannot be recovered.

I want to delete my data

• /context clear - conversation history.
• /coping plan clear:true, /coping journal delete:<n> - individual records.
• For a full account deletion, contact the team (support server or [email protected]).

Crisis screening did not trigger

Screening only runs on /crisis, the "Check on this message" menu, DMs, and messages that mention or reply to Mellow, and only if you have crisis_detection on. It is also deliberately conservative.

Server admins

/guildsettings says I lack permission

You need the Manage Server permission.

Settings do not seem to take effect

• Run /guildsettings view to confirm what is stored.
• Run /guilddebug to check Mellow has the permissions it needs and the channels you set still exist.

Crisis alerts are not posting

• /guildsettings set crisis_alerts:true
• /guildsettings set mod_alert_channel:#your-channel
• Confirm Mellow can send messages in that channel.
• Only high and critical results post an alert.

Where are the moderation commands?

There are none. Mellow is not a moderation bot.

Self-hosting

See the

for database, migration, encryption, sharding, and HTTP API problems.

Owner diagnostics: /debug database, /debug ai, /debug version, /tools status, /tools logs. There is no /status, /health, or /metrics command; self-hosters use GET /healthz on the HTTP API.

Getting help

Include: the output of /version, what you did, what you expected, and what actually happened.

• Support server
• GitHub issues
• [email protected] (privacy, data deletion, security)