Skip to content

docs: Add Raspberry Pi installation guide#1871

Merged
thewilloftheshadow merged 2 commits intoopenclaw:mainfrom
0xJonHoldsCrypto:docs/raspberry-pi-guide
Jan 26, 2026
Merged

docs: Add Raspberry Pi installation guide#1871
thewilloftheshadow merged 2 commits intoopenclaw:mainfrom
0xJonHoldsCrypto:docs/raspberry-pi-guide

Conversation

@0xJonHoldsCrypto
Copy link
Copy Markdown
Contributor

Summary

Adds a comprehensive guide for running Clawdbot on Raspberry Pi — the cheapest always-on self-hosted option.

What's included

  • Hardware requirements table — Pi 3/4/5 compatibility matrix
  • Step-by-step setup — OS flashing through service verification
  • Swap configuration — Critical for 2GB or less RAM
  • Performance optimizations — USB SSD, memory tuning, resource monitoring
  • ARM-specific notes — Binary compatibility, 32-bit vs 64-bit warnings
  • Cost comparison — Pi vs cloud VPS break-even analysis
  • Troubleshooting — OOM, WiFi drops, ARM binary issues

Why this matters

  • FAQ already mentions Pi support but there's no dedicated guide
  • Pi is the cheapest way to run Clawdbot 24/7 (~$45 one-time vs $6/mo VPS)
  • ARM has some gotchas that deserve documentation
  • Common questions in Discord about Pi setup

Hardware Tested

Based on:

  • FAQ documentation (Pi 4 works, 1GB minimum, 2GB recommended)
  • Community reports from Discord
  • General ARM64 Node.js compatibility

Checklist

  • Follows existing docs structure (matches hetzner.md, digitalocean.md)
  • Includes frontmatter with summary/read_when
  • Covers ARM-specific edge cases
  • Links to related guides

Contributed via Clawdbot by @0xJonHoldsCrypto 🦖

thewilloftheshadow added a commit that referenced this pull request Jan 26, 2026
Co-authored-by: 0xJonHoldsCrypto <0xJonHoldsCrypto@users.noreply.github.com>
@thewilloftheshadow thewilloftheshadow merged commit 49ef622 into openclaw:main Jan 26, 2026
21 of 23 checks passed
@thewilloftheshadow
Copy link
Copy Markdown
Member

Merged via merge. Landed commit: a2d9127 (hostnames updated to generic placeholders).
Follow-up clawtributors update: e040f63.

zooqueen pushed a commit to hanzoai/bot that referenced this pull request Mar 6, 2026
Co-authored-by: 0xJonHoldsCrypto <0xJonHoldsCrypto@users.noreply.github.com>
zooqueen pushed a commit to hanzoai/bot that referenced this pull request Mar 6, 2026
…-pi-guide

docs: Add Raspberry Pi installation guide
lovewanwan pushed a commit to lovewanwan/openclaw that referenced this pull request Apr 28, 2026
Co-authored-by: 0xJonHoldsCrypto <0xJonHoldsCrypto@users.noreply.github.com>
lovewanwan pushed a commit to lovewanwan/openclaw that referenced this pull request Apr 28, 2026
…-pi-guide

docs: Add Raspberry Pi installation guide
ogt-redknie pushed a commit to ogt-redknie/OPENX that referenced this pull request May 2, 2026
Co-authored-by: 0xJonHoldsCrypto <0xJonHoldsCrypto@users.noreply.github.com>
ogt-redknie pushed a commit to ogt-redknie/OPENX that referenced this pull request May 2, 2026
…-pi-guide

docs: Add Raspberry Pi installation guide
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants