Help
Troubleshooting
Messages, causes and fixes for common problems.
Messages in quotes are the texts AETHON shows in English; in other languages they appear translated. Most problems come from the role hierarchy or missing permissions.
In your server#
| Symptom | Cause | Fix |
|---|---|---|
| Slash commands do not appear | AETHON was added without the applications.commands scope, or your role cannot use application commands in that channel. | Invite AETHON again with the Invite Bot button, which includes the scope, and check Use Application Commands in the channel permissions or in Server Settings → Integrations. |
| "This command is no longer available" | The command belongs to an earlier version. | Use /help to see AETHON's current commands. Restart Discord if the old list still appears. |
| Command descriptions appear in another language | Descriptions follow the server language, English by default. | Ask an administrator to choose the language with /settings language. Wait a few seconds; restart Discord if the previous descriptions remain. |
| "You are not an AETHON operator in this server." | Your account has no AETHON level. | An admin grants one with /permissions grant; under the default policy members with Manage Server are operators and Administrator members are admins. |
| "Requires AETHON level … (yours: …)" / "Your level (…) is too low for a … operation." | The command or the risk of the operation needs a higher level. | Ask an admin, or request it so that it goes through an approval. See the operator levels. |
| "AETHON is missing permissions: …" | AETHON's role lacks a permission the operation needs. | Give those permissions to AETHON's role or invite it again with all requested permissions. |
| "AETHON lacks … in #channel." | A channel overwrite denies the bot. | Allow the listed permissions for AETHON in that channel. |
| "Role … is above AETHON's highest role." / "That member is above AETHON in the role hierarchy." | Discord forbids bots from managing roles or members above them. | Move AETHON's role higher in Server Settings → Roles. |
| "Role … is managed by an integration." | Integration roles cannot be edited by bots. | Use a normal role. |
| "<#…> is protected." / "<@&…> is protected." | The resource was protected with /permissions protect. | Remove the protection with /permissions protect … remove:true if the change is intended. |
| "… operations are disabled by the server policy." / "… is disabled by the server policy." | The owner set the risk level or the tool to deny. | Review /permissions policy; the owner can change it with /permissions risk or /permissions tool. |
| "The … skill is disabled in this server." | The skill was turned off. | /settings skill. |
| No progress message appears | AETHON cannot post in the progress channel. | Check View Channel and Send Messages for AETHON there, or choose another channel in /setup panel. |
The agent#
| Message | Meaning | What to do |
|---|---|---|
| "The AI provider is not available right now." | The AI service could not be reached. | Try again later. Features that don't need AI keep working: /setup template, /audit security, /backup create. |
| "The AI credit budget is exhausted." / "A plan limit has been reached." | A monthly quota or limit was reached. | Check /usage; the limits are listed in Plans & usage. |
| "The plan failed deterministic validation and was not executed." | The plan broke a rule (missing resource, invalid argument, permission). | Read the validation report on the project and rephrase the request. |
| "The server changed since the preview; the plan is no longer valid." | A dry run no longer matches the server. | Run the request again. |
| "The previous approval no longer matches the current state; a new approval is needed." | A target changed after the approval. | Approve the new request. |
| "It is unknown whether the operation was applied. Check Discord before retrying." | A call timed out after it may have reached Discord. | Check the resource in Discord, then an admin uses /tasks force_retry if it is safe. |
| "The change could not be verified in Discord." | The check after the change failed; the project ends as PARTIAL. | Inspect the task, fix the cause and use /projects retry_failed. |
| "Planning was interrupted by a restart. Please submit the request again." | AETHON restarted while planning. | Submit the request again; execution itself resumes automatically. |
| "The requester cannot approve their own request." | The server requires a distinct approver. | Ask another admin (or the owner for CRITICAL operations). |
| "This feature requires AETHON Pro (…)." | Rollback, checkpoint restore and reports are PRO features. | See Plans & usage. |
A server can have at most 10 active projects; cancel or finish some before starting more. A FREE account gets AETHON in one server: other servers owned by the same user are marked limited and the agent refuses work there until the plan allows it.
Invitations#
| What you see | What to do |
|---|---|
| "Invitations are not available yet." | The invite link has not been published yet. Please check back later. |
| "Checking your server." | Discord sent you back before AETHON was visible in the server. Press Check again; if you closed the Discord window before choosing a server, start the invitation again. |
| "This link is no longer valid." | Each invitation link works once and expires after 15 minutes. Start a new invitation. |
| "No changes were made." | The invitation was cancelled in Discord, so AETHON was not added. Start it again when you are ready. |
| "We couldn’t verify it." | Discord could not confirm the invitation, or there were too many attempts. Wait a few minutes and invite again. |