diff --git a/tools/box-install-from-tar.sh b/tools/box-install-from-tar.sh
new file mode 100644
index 0000000..cfe82dd
--- /dev/null
+++ b/tools/box-install-from-tar.sh
@@ -0,0 +1,7 @@
+#!/bin/bash
+# 在 BOX 上由 sudo 执行：先解压本机 tarball，再运行包内 install.sh（避免 raw.githubusercontent CDN 滞后；离线机也可不用 curl）。
+set -euo pipefail
+rm -rf /opt/clawd
+mkdir -p /opt/clawd
+tar xzf "${1:-$HOME/clawd-deploy.tgz}" -C /opt/clawd
+exec bash /opt/clawd/install.sh