Checklist
Run
openclaw doctor first — it auto-detects the most common misconfigurations.Bot Not Responding
- Verify the daemon is running:
openclaw status - Check your bot token is correct in
config.yaml - Ensure the channel is enabled:
openclaw channels list - Check logs:
openclaw logs --channel telegram --tail 50
403 Forbidden from Telegram API
Your token may have been revoked. Regenerate it in @BotFather with /token and update config.yaml, then restart: openclaw restart
Messages Delivered but Agent Ignores Them
- Check that your Telegram user ID is in the allowlist (if you've set one)
- Ensure your message starts with a trigger phrase if
require_prefixis enabled
Webhook Errors
OpenClaw uses long-polling by default — no public webhook URL is required. If you've manually set a webhook, clear it:
openclaw channels fix telegramTelegram Setup
Starting fresh? Follow the step-by-step setup guide.