diff --git a/docs/vps.md b/docs/vps.md
index adb88403890..a378fa2272a 100644
--- a/docs/vps.md
+++ b/docs/vps.md
@@ -51,3 +51,21 @@ You can keep the Gateway in the cloud and pair **nodes** on your local devices
 capabilities while the Gateway stays in the cloud.
 
 Docs: [Nodes](/nodes), [Nodes CLI](/cli/nodes)
+
+## Startup tuning for small VMs and ARM hosts
+
+If CLI commands feel slow on low-power VMs (or ARM hosts), enable Node's module compile cache:
+
+```bash
+grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
+export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
+mkdir -p /var/tmp/openclaw-compile-cache
+export OPENCLAW_NO_RESPAWN=1
+EOF
+source ~/.bashrc
+```
+
+- `NODE_COMPILE_CACHE` improves repeated command startup times.
+- `OPENCLAW_NO_RESPAWN=1` avoids extra startup overhead from a self-respawn path.
+- First command run warms cache; subsequent runs are faster.
+- For Raspberry Pi specifics, see [Raspberry Pi](/platforms/raspberry-pi).