What you end up with
- An agent that runs on your Raspberry Pi day and night and answers you on Telegram or WhatsApp.
- It remembers what you tell it, sends scheduled messages such as a morning brief or a research digest, and watches the Pi and your websites.
- It is locked down: only you can talk to it, nothing on your network can reach it, and it cannot run shell commands from chat.
- A watchdog that restarts it if it stops and tells you, and nightly backups.
The Pi does not run the AI model. It runs the OpenClaw gateway, which calls the model provider you choose. See where the AI actually runs.
What you need
| Item | Notes |
|---|---|
| Raspberry Pi 5 (4 GB or 8 GB) | A Pi 4 with 4 GB also works well. 2 GB works with swap. |
| Official power supply | 27 W USB-C for a Pi 5. Weak supplies cause throttling and random crashes. |
| Cooling | The official active cooler for a Pi 5, or a case with a fan. |
| Storage | A USB SSD is the most reliable for something that writes all day. A good 32 GB microSD card is fine to start. |
| Ethernet cable | Recommended over Wi-Fi for an always-on device. |
| A model provider API key | Anthropic, OpenAI or another provider OpenClaw supports. Set a monthly spend limit first. |
| Telegram or WhatsApp | Telegram: you create a bot in two minutes. WhatsApp: a spare number for the agent is recommended. |
The path
| Step | Guide | Script |
|---|---|---|
| 0 | Before you start: hardware, accounts, costs, the security model | |
| 1 | Prepare the Pi: flash the OS, connect, tune it | 01-prepare-pi.sh |
| 2 | Install OpenClaw and onboard | 02-install-openclaw.sh |
| 3 | Connect Telegram, then apply the hardened config | 04-apply-config.sh |
| 3b | Or connect WhatsApp instead | 04-apply-config.sh |
| 4 | Lock it down: firewall, automatic updates, SSH protection | 03-harden.sh |
| 5 | Give it a job: install one of the three agents | workspaces/ |
| 6 | Automations, watchdog and backups | automations.sh, watchdog.sh, backup.sh |
| 7 | Connect your own MCP server | |
| 8 | Maintenance and troubleshooting |
Every script says what it changes, and the config script shows a dry run of every setting before it asks to apply. A one-page checklist is included for setting up a second Pi.
Security defaults
| Setting | Why |
|---|---|
| Chat locked to your Telegram id or WhatsApp number | Strangers who find the agent cannot even ask for access. |
| Gateway bound to the Pi itself | Nothing on your network can reach it. Use an SSH tunnel or Tailscale for the dashboard. |
| No shell commands from chat | A web page that tries to trick the agent into running commands has nothing to call. |
| File tools limited to the workspace | The agent cannot read the rest of the system. |
| Firewall, automatic security updates, SSH brute-force protection | The operating system looks after itself. |
| Groups: answers only when mentioned | Adding it to a group does not make it talk to everyone. |
Guide 4 explains each switch and how to loosen it deliberately, for example to allow commands that you approve in chat.
Agents and their jobs
Each agent comes with its personality, operating rules, a heartbeat checklist and scheduled jobs. Install one, or run several.
| Agent | Job | When |
|---|---|---|
| Chief of staff | Morning brief | Weekdays 07:30 |
| Chief of staff | Weekly review | Sundays 18:00 |
| Research scout | Daily digest | Every day 08:00 |
| Research scout | Weekly trends | Fridays 17:00 |
| Ops watchdog | Pi health (a script, no model) | Every 15 minutes |
| Ops watchdog | Weekly status (a script, no model) | Mondays 09:00 |
| Ops watchdog | Monthly incident review | 1st of the month 09:00 |
You can change any time, pause a job or add your own. One-off reminders work from chat: "remind me at 18:00 to call the garage".
What is in the zip
pi-agent-kit/
README.md CHECKLIST.md CHANGELOG.md LICENSE.md
guide/ 00 to 08, plus 03b for WhatsApp
scripts/ 01-prepare-pi 02-install-openclaw 03-harden 04-apply-config
watchdog backup pi-health
config/ hardened.patch.json5 plus a Telegram and a WhatsApp part
workspaces/
chief-of-staff/ SOUL.md AGENTS.md USER.md heartbeat.md automations.sh
research-scout/ the same five files
ops-watchdog/ the same five files
Running costs
- Hardware: one-off.
- Electricity: a Pi draws a few watts.
- Model API: pay per use, depending on the model you pick and how much you use it. The kit keeps background usage low: health checks are scripts, not model calls, and scheduled jobs run with minimal context.
Versions
Built for OpenClaw 2026.11 and Raspberry Pi OS Lite (64-bit) on a Raspberry Pi 4 or 5. OpenClaw moves fast; the kit is updated for new releases, and every 1.x update is free.
Put an agent on your Pi
€29 on its own, or with the MCP kit in the bundle so your agent can use your own tools.