Troubleshooting

The most common issues and how to fix them — most in under a minute.

The bot isn’t responding

• Dashboard → Overview: is the agent online? If not, click Restart.
• Stuck on “typing…” for a long time? Long tasks can take minutes. To cancel: /stop.
• A very long conversation can confuse the agent — /new starts fresh (long-term memory stays intact).
• Still nothing? Run Diagnostics in the dashboard and check the Logs.

“API key rejected” or credit errors

• Check that the key has credit on the provider’s console (Anthropic or OpenAI). A key with no credit means a silent agent.
• Key revoked or rotated? Update it in the dashboard → Model & features and restart.

“No messages found” when linking Telegram

• You need to send /start to your bot (the one you just created) — not to BotFather.
• Send the message and click “Detect my Telegram” right after.

Someone else tried to message the bot and nothing happened

That’s the expected behavior: the agent only responds to the Telegram account linked at creation. Everyone else is deliberately ignored.

Voice messages aren’t being understood

• Is the transcription service (Step 5) configured? Without it, incoming audio never gets converted to text.
• Groq’s free tier is generous but can expire or hit its limit — check at console.groq.com.

A scheduled task stopped running

A task that fails 10 times in a row is automatically disabled. Check the reason with /cron status(or in the Activity tab) and ask by conversation: “reactivate task X.”

I deleted my agent by mistake — can I recover it?

No. Deletion is permanent and destroys the server, disk, and memory. That’s why it requires double confirmation — and why the memory export exists.