Run a persistent, always-on OpenClaw Gateway on a Raspberry Pi. Since the Pi is just the gateway (models run in the cloud via API), even a modest Pi handles the workload well.<\/p>\n
Use Raspberry Pi OS Lite (64-bit)<\/strong> — no desktop needed for a headless server.<\/p>\n \n \n “`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \n \n “`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \n \n \n \n On your computer, get a dashboard URL from the Pi:<\/p>\n Use a USB SSD<\/strong> — SD cards are slow and wear out. A USB SSD dramatically improves performance. See the Pi USB boot guide<\/a>.<\/p>\n Enable module compile cache<\/strong> — Speeds up repeated CLI invocations on lower-power Pi hosts:<\/p>\n “`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} Out of memory<\/strong> — Verify swap is active with Slow performance<\/strong> — Use a USB SSD instead of an SD card. Check for CPU throttling with Service will not start<\/strong> — Check logs with ARM binary issues<\/strong> — If a skill fails with “exec format error”, check whether the binary has an ARM64 build. Verify architecture with WiFi drops<\/strong> — Disable WiFi power management: Raspberry Pi Run a persistent, always-on OpenClaw Gatew […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-620","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/620","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=620"}],"version-history":[{"count":3,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/620\/revisions"}],"predecessor-version":[{"id":774,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/620\/revisions\/774"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=620"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=620"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=620"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}1. Download [Raspberry Pi Imager](https:\/\/www.raspberrypi.com\/software\/).\n2. Choose OS: **Raspberry Pi OS Lite (64-bit)**.\n3. In the settings dialog, pre-configure:\n * Hostname: `gateway-host`\n * Enable SSH\n * Set username and password\n * Configure WiFi (if not using Ethernet)\n4. Flash to your SD card or USB drive, insert it, and boot the Pi.\n<\/code><\/pre>\n<\/p>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n ssh user@gateway-host<\/code>\n <\/p>\n
\n sudo apt update && sudo apt upgrade -y
\n sudo apt install -y git curl build-essential<\/p>\n# Set timezone (important for cron and reminders)\nsudo timedatectl set-timezone America\/Chicago\n```\n<\/code><\/pre>\n<\/p>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n curl -fsSL https:\/\/deb.nodesource.com\/setup_24.x | sudo -E bash -
\n sudo apt install -y nodejs
\n node --version<\/code>\n <\/p>\n
\n sudo fallocate -l 2G \/swapfile
\n sudo chmod 600 \/swapfile
\n sudo mkswap \/swapfile
\n sudo swapon \/swapfile
\n echo ‘\/swapfile none swap sw 0 0’ | sudo tee -a \/etc\/fstab<\/p>\n# Reduce swappiness for low-RAM devices\necho 'vm.swappiness=10' | sudo tee -a \/etc\/sysctl.conf\nsudo sysctl -p\n```\n<\/code><\/pre>\n<\/p>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n curl -fsSL https:\/\/openclaw.ai\/install.sh | bash<\/code>\n <\/p>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n openclaw onboard --install-daemon<\/code><\/p>\nFollow the wizard. API keys are recommended over OAuth for headless devices. Telegram is the easiest channel to start with.\n<\/code><\/pre>\n<\/p>\nbash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n openclaw status
\n sudo systemctl status openclaw
\n journalctl -u openclaw -f<\/code>\n <\/p>\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nssh user@gateway-host 'openclaw dashboard --no-open'\n```\n\nThen create an SSH tunnel in another terminal:\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nssh -N -L 18789:127.0.0.1:18789 user@gateway-host\n```\n\nOpen the printed URL in your local browser. For always-on remote access, see [Tailscale integration](\/gateway\/tailscale).\n<\/code><\/pre>\n<\/p>\nPerformance tips<\/h2>\n
\ngrep -q ‘NODE_COMPILE_CACHE=\/var\/tmp\/openclaw-compile-cache’ ~\/.bashrc || cat >> ~\/.bashrc <<‘EOF’ # pragma: allowlist secret
\nexport NODE_COMPILE_CACHE=\/var\/tmp\/openclaw-compile-cache
\nmkdir -p \/var\/tmp\/openclaw-compile-cache
\nexport OPENCLAW_NO_RESPAWN=1
\nEOF
\nsource ~\/.bashrc<\/p>\n\n**Reduce memory usage** -- For headless setups, free GPU memory and disable unused services:\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\necho 'gpu_mem=16' | sudo tee -a \/boot\/config.txt\nsudo systemctl disable bluetooth\n<\/code><\/pre>\n故障排查<\/h2>\n
free -h<\/code>. Disable unused services (sudo systemctl disable cups bluetooth avahi-daemon<\/code>). Use API-based models only.<\/p>\nvcgencmd get_throttled<\/code> (should return 0x0<\/code>).<\/p>\njournalctl -u openclaw --no-pager -n 100<\/code> and run openclaw doctor --non-interactive<\/code>.<\/p>\nuname -m<\/code> (should show aarch64<\/code>).<\/p>\nsudo iwconfig wlan0 power off<\/code>.<\/p>\n下一步<\/h2>\n
\n