diff --git a/family/how-to/hermes-eagle-mac.md b/family/how-to/hermes-eagle-mac.md
index cc6ea3f9..70b2452b 100644
--- a/family/how-to/hermes-eagle-mac.md
+++ b/family/how-to/hermes-eagle-mac.md
@@ -227,7 +227,57 @@ Claude падает с "Failed to spawn process". Проверить логи:
 
 ---
 
-## Webhook и интеграция с zulip-router
+## План работ: миграция портов Eagle и Whale (2026-06-17)
+
+### Текущее состояние
+
+Eagle и Кит (Whale) — два отдельных gateway на одном Mac. Оба читают
+один `config.yaml` (`~/.hermes/`). Кит сидит на порту 8645, Eagle — на 8644
+(занял свободный, так как 8645 был занят).
+
+Нужно: Eagle → 8645, Кит → другой порт.
+
+### Шаг 1. Сменить порт Кита
+
+Файл: `~/.hermes/hermes-whale/config.yaml`
+
+Поменять порт webhook с 8645 на 8646:
+
+```yaml
+platforms:
+  webhook:
+    extra:
+      port: 8646  # было 8645
+```
+
+### Шаг 2. Убить второй gateway (PID 96351)
+
+Это дубль — запущен руками из того же конфига, сидит на 8644:
+
+```bash
+kill 96351
+```
+
+PID актуальный — проверить перед kill.
+
+### Шаг 3. Перезапустить Eagle на 8645
+
+Через Eagle Dashboard (или `launchctl kickstart ai.hermes.gateway` — только
+по явной команде).
+
+### Шаг 4. Проверить
+
+1. `curl -s http://127.0.0.1:8645` → 200 (Eagle жив)
+2. `curl -s -X POST http://127.0.0.1:8645/webhooks/eagle -d '{"message":"test"}'`
+   → 202 Accepted
+3. `@**Орёл**` в Zulip → Eagle отвечает
+4. Роутер шлёт на `host.docker.internal:8645/webhooks/eagle` — проверить логи
+
+---
+
+### Проблема (2026-06-17) — что было не так и что сделано
+
+Eagle не отвечал на `@**Орёл**`. Причины:
 
 Eagle использует webhook platform для приёма сообщений от zulip-router.
 Напрямую в Zulip через Events API Eagle **не подписан** — все сообщения