diff --git a/docs/ports.md b/docs/ports.md
new file mode 100644
index 0000000..0fdbadf
--- /dev/null
+++ b/docs/ports.md
@@ -0,0 +1,11 @@
+# T2 Port Map (vps.claw-main)
+
+Ports allocated by `HangmanLab.Server.T2` plugins on the OpenClaw host.
+System-level services (sshd, nginx, systemd-resolved, docker) are excluded.
+
+| Port | Bind | Service | Note |
+|------|------|---------|------|
+| 8787 | 127.0.0.1 | Dirigent no-reply sidecar | Default `sideCarPort` |
+| 18789 | 127.0.0.1 | OpenClaw Gateway | Internal gateway listener |
+| 18800 | 127.0.0.1 | ContractorAgent bridge | Default `bridgePort` |
+| 18900 | 127.0.0.1 | Yonexus.Server | WebSocket hub (`listenPort`) |