Bot is not responding
- Check Logs: Run
docker-compose logs -fto see if there are any errors. - Check API Keys: Ensure your
.envfile has valid API keys for the selected provider. - Check Telegram Token: Verify your
TELEGRAM_BOT_TOKENis correct.
”Unauthorized access attempt” in logs
This means someone is trying to use your bot, but they are not in theUSERS_WHITELIST.
- Fix: Add their ID to the whitelist in
.envif you want to grant them access. - Ignore: If it’s a stranger, the bot is correctly blocking them.
Bot doesn’t reply in groups
- Privacy Mode: By default, bots in groups only see messages that mention them (
@botname) or are replies to them. - Whitelist: Ensure the group ID is added to
GROUPS_WHITELIST. - Direct Messages Only: Check if
ANSWER_DIRECT_MESSAGES_ONLYis set toTrue. If so, the bot might be ignoring group messages intentionally.
Docker container keeps restarting
- Database Error: If you switched databases (e.g., from Local to Redis), ensure the new service is running.
- Port Conflict: Check if another service is using the same ports.

