Diagnostic Tools
Your bot’s detail page includes three diagnostic actions — Restart, Doctor, and Reconfigure. These tools help you troubleshoot and resolve common issues without needing to contact support.
You’ll find them in the action bar at the top of your bot’s page in the dashboard.
Restart
Restarts your bot’s service. No settings are changed — it simply stops and starts the process.
When to use it:
- Your bot is unresponsive or not replying to messages
- Your bot seems stuck or behaving unexpectedly
- After a prolonged period of inactivity where the bot has gone silent
Restart does not affect your bot’s memory, identity, or configuration. It’s safe to use at any time.
Doctor
Runs a health check on your bot and returns a diagnostic report. It scans for issues across several areas:
- Configuration — ensures your bot’s settings are valid
- Service status — confirms the bot process is actually running
- Authentication — checks that tokens and credentials are healthy
- Channel connectivity — verifies the connection to Telegram is working
- Memory system — confirms your bot’s memory and search features are functional
When to use it:
- Something feels off but you’re not sure what’s wrong
- Before reaching out for support — the diagnostic report helps pinpoint the issue
- After a Restart didn’t fix the problem
Doctor is completely read-only. It won’t change anything on your bot — it only reports what it finds.
Reconfigure
Re-applies your current settings to the bot. This includes your AI model selection, allowed contacts list, and any other configuration you’ve set through the platform.
When to use it:
- Settings changes you made in the dashboard aren’t taking effect
- You suspect your bot’s configuration has drifted from what the platform shows
- After updating your AI model or allowed contacts and the bot isn’t reflecting the change
Reconfigure re-applies your existing settings — it does not reset them to defaults. Your bot’s identity, memory, and conversation history are all preserved.
Common Scenarios
Not sure which tool to reach for? Here’s a quick reference:
| Symptom | Recommended Action |
|---|---|
| Bot not responding at all | Restart |
| Bot responding but behaving oddly | Doctor, then Reconfigure |
| Settings changes not taking effect | Reconfigure |
| Not sure what’s wrong | Doctor |
| Bot crashed or went offline | Restart |
| Bot can’t seem to reach Telegram | Doctor, then Restart |
Suggested Troubleshooting Order
When something goes wrong, we recommend this general approach:
- Run Doctor to get a diagnostic report and understand what’s happening
- Try Restart if the bot appears to be stuck or unresponsive
- Run Reconfigure if settings seem out of sync
- If none of the above resolve the issue, reach out to us with the Doctor report — it helps us help you faster