Fix It

Troubleshooting Center

Pick the problem that matches what you are seeing. Each card tells you the first safe step.

Copy carefully. Capital letters, spaces, and invisible password/token input can matter.

🤖

My agent is not responding

Office meaning: The worker is not at their desk.

First safe step: Try /status in Telegram. If that fails, check if the VPS is reachable.

Go to Telegram Guide →
💬

Telegram bot is not replying

Office meaning: The receptionist is not answering the phone.

First safe step: Check if you are talking to the correct bot. Verify the bot token has not changed.

Go to Telegram Guide →
🖥

I cannot connect through Termius

Office meaning: The staff entrance key is not working.

First safe step: Check your SSH credentials, your Tailscale private connection, and whether the VPS rented cloud computer is online.

Go to Termius Guide →
🔒

Tailscale says offline

Office meaning: The private hallway is closed.

First safe step: Restart Tailscale on your device and check the admin panel for the VPS status.

Go to Tailscale Guide →
🏢

VPS is unreachable

Office meaning: Headquarters is locked or the power is out.

First safe step: Remember: the VPS is the rented cloud computer, not an app. Check your provider's status page. Try pinging the server. Verify your network.

Go to VPS Guide →
🎫

My API key stopped working

Office meaning: The access badge expired or was revoked.

First safe step: Log into your AI provider account and check if the key is active. Generate a new one if needed and update your config.

Go to Glossary →
⚠

My agent gives bad answers

Office meaning: The worker is confused or reading the wrong rulebook.

First safe step: Try /reset to clear the conversation. Check if the correct model is set in the config.

Go to Reset Guide →
💥

I changed something and broke it

Office meaning: The rulebook was edited incorrectly.

First safe step: Do not delete anything. Revert the last change if you can. Check logs for the exact error.

Go to Emergency Guide →
❓

I do not know what is wrong

Office meaning: Something is off but the alarm has not sounded yet.

First safe step: Run /status, then /report. Gather information before making changes.

Go to Support Checklist →