Troubleshooting · index · quick fixes

Common errors (quick fixes)

This is a living index. Each entry is meant to be short: symptom → likely cause → fastest fix.

Start here

Before guessing: tail logs while reproducing the issue.

moltbot logs --follow

Logs cheatsheet →

Top issues

Telegram not receiving messages

Bot privacy, group mention mode, wrong chat id.

Fix →

Cron job didn’t fire

Gateway stopped, machine slept, timezone mismatch.

Sanity check →

"It works locally but not on VPS"

Bind/ports, firewall, token requirements.

Gateway →

Add new issues

When you see a recurring error in Telegram groups, we add it here as a dedicated page (so users can bookmark it).