diff --git a/CHANGELOG.md b/CHANGELOG.md
index 594b07dc8..16b3c53c1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@
 - Primary session key is fixed to `main` (or `global` for global scope).
 
 ### Fixes
+- Doctor migrates legacy Clawdis config/service installs and normalizes sandbox Docker names.
 - Presence beacons keep node lists fresh; Instances view stays accurate.
 - Block streaming/chunking reliability (Telegram/Discord ordering, fewer duplicates).
 - WhatsApp GIF playback for MP4-based GIFs.
diff --git a/docs/doctor.md b/docs/doctor.md
index 377e03adc..12b80252e 100644
--- a/docs/doctor.md
+++ b/docs/doctor.md
@@ -12,6 +12,7 @@ read_when:
 - Runs a health check and offers to restart the gateway if it looks unhealthy.
 - Prints a skills status summary (eligible/missing/blocked).
 - Detects deprecated config keys and offers to migrate them.
+- Detects legacy Clawdis services (launchd/systemd/schtasks) and offers to migrate them.
 
 ## Legacy config migrations
 When the config contains deprecated keys, other commands will refuse to run and ask you to run `clawdbot doctor`.
@@ -34,3 +35,8 @@ If you want to review changes before writing, open the config file first:
 ```bash
 cat ~/.clawdbot/clawdbot.json
 ```
+
+## Legacy service migrations
+Doctor checks for older Clawdis gateway services (launchd/systemd/schtasks).
+If found, it offers to remove them and install the Clawdbot service using the current gateway port.
+Remote mode skips the install step, and Nix mode only reports what it finds.