OpenClaw on Raspberry Pi

Practical guidance repo for anyone who wants to try OpenClaw on a Raspberry Pi.

This project focuses on:

• fast first-time setup
• reproducible scripts instead of one-off commands
• operational reliability (health checks, logs, restart flows)
• performance visibility (benchmarks, temperature, throttling)

Start Here

If this is your first time:

1. Read docs/START_HERE.md
2. Run docs/QUICKSTART.md
3. Use docs/OPERATIONS.md for daily usage

Quick Install

git clone https://github.com/sulimanbadour1/OpenClaw_raspberry.git
cd open_claw_raspberry
cp .env.example .env
nano .env
chmod +x scripts/*.sh
./scripts/bootstrap_full.sh --env-file .env

What You Get

• Bootstrap and setup automation: scripts/setup_pi_openclaw.sh, scripts/bootstrap_full.sh
• Runtime/service management: scripts/stack.sh, scripts/healthcheck.sh
• Environment and secret handling: scripts/configure_env.sh, .env.example, SECURITY.md
• Performance and thermal tools: scripts/benchmark_openclaw.py, scripts/pi_telemetry.sh, scripts/optimize_openclaw.sh
• Optional diagnostics UIs: openclaw_model_monitor.py, check_openclaw_pi5.py

Command Shortcuts

make help
make health
make benchmark
make telemetry
make tune-show
make check

Docs Map

• docs/START_HERE.md
• docs/QUICKSTART.md
• docs/INSTALL_PI.md
• docs/CONFIGURATION.md
• docs/OPERATIONS.md
• docs/TROUBLESHOOTING.md
• docs/FAQ.md
• docs/LOCAL_LLM_CATALOG.md
• docs/BENCHMARKING.md
• docs/PERFORMANCE_TUNING.md
• docs/PI_OPENCLAW_GENERAL.md
• SECURITY.md
• CONTRIBUTING.md

Security

• Never commit real secrets.
• Keep runtime keys in local .env and service overrides.
• Follow SECURITY.md checks before pushing.

Automated Checks

• Local:
  • make repo-health
  • make security-check
  • make check
• CI:
  • .github/workflows/validate.yml
  • .github/workflows/health-security.yml (includes scheduled daily run)

License

MIT (LICENSE).

OpenClaw_raspberry