A reinstall should be controlled, not destructive. The safe order is backup, remove or disable the Telegram channel, uninstall, reinstall, then add the token back and verify the DM or group flow.
Quick answer
Create a backup, remove or disable Telegram cleanly, run the uninstaller, reinstall, then re-add the bot token and check the channel status before you start chatting again.
Command line steps
1. Create a restore point before you remove anything
This is the difference between a clean reinstall and a blind reset.
openclaw backup create
openclaw channels list
2. Remove the Telegram channel before reinstalling
The CLI supports channel removal directly. If you only want a temporary shutdown, disable the channel instead of deleting it.
openclaw channels remove --channel telegram --delete
# or disable it in config:
openclaw config set channels.telegram.enabled false
3. Uninstall, reinstall, and add the Telegram token back
After the reinstall, attach the token again and verify the gateway plus channel path.
openclaw uninstall --all --yes --non-interactive
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw channels add --channel telegram --token "$TELEGRAM_BOT_TOKEN"
openclaw gateway restart
openclaw channels status --probe
What to check if it still fails
- If you want a full rollback path, keep the backup until the new install passes a live Telegram test.
- If pairing codes or allowlists look stale after reinstall, rerun
openclaw doctor --fixand then recheck the Telegram config. - If you only needed to refresh the gateway service, a full reinstall was probably overkill. Try
openclaw gateway restartfirst next time.
Frequently asked questions
What will I learn from How to Uninstall and Reinstall OpenClaw Without Losing Your Telegram Setup?
Back up first, remove the Telegram channel cleanly, reinstall OpenClaw, then add the bot token back and verify pairing. The guidance is written for practical self-hosted OpenClaw environments, but commands and configuration can change between releases.
Should I back up OpenClaw before changing the configuration?
Yes. Back up the active configuration, credentials references, channel settings, and service definitions before repairs, upgrades, or model changes, then validate the gateway and important workflows after the change.
Can Milan help with OpenClaw setup or troubleshooting?
Yes. Milan provides OpenClaw setup, model and channel configuration, secure remote access, workflow automation, troubleshooting, and deployment support.
