From 08ea7f0cf68340bc960e12d7c58eeb7e0a683fd6 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Sun, 1 Mar 2026 12:28:06 -0800 Subject: [PATCH] Docs VPS: add startup tuning for small hosts --- docs/vps.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) 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).