KitwireDocsPi Agent Kit

Kit 2

Pi Agent Kit

From a blank SD card to an always-on AI agent on Telegram or WhatsApp, on hardware you own. Built on OpenClaw, the open-source agent gateway.

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

ItemNotes
Raspberry Pi 5 (4 GB or 8 GB)A Pi 4 with 4 GB also works well. 2 GB works with swap.
Official power supply27 W USB-C for a Pi 5. Weak supplies cause throttling and random crashes.
CoolingThe official active cooler for a Pi 5, or a case with a fan.
StorageA USB SSD is the most reliable for something that writes all day. A good 32 GB microSD card is fine to start.
Ethernet cableRecommended over Wi-Fi for an always-on device.
A model provider API keyAnthropic, OpenAI or another provider OpenClaw supports. Set a monthly spend limit first.
Telegram or WhatsAppTelegram: you create a bot in two minutes. WhatsApp: a spare number for the agent is recommended.

The path

StepGuideScript
0Before you start: hardware, accounts, costs, the security model
1Prepare the Pi: flash the OS, connect, tune it01-prepare-pi.sh
2Install OpenClaw and onboard02-install-openclaw.sh
3Connect Telegram, then apply the hardened config04-apply-config.sh
3bOr connect WhatsApp instead04-apply-config.sh
4Lock it down: firewall, automatic updates, SSH protection03-harden.sh
5Give it a job: install one of the three agentsworkspaces/
6Automations, watchdog and backupsautomations.sh, watchdog.sh, backup.sh
7Connect your own MCP server
8Maintenance 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

SettingWhy
Chat locked to your Telegram id or WhatsApp numberStrangers who find the agent cannot even ask for access.
Gateway bound to the Pi itselfNothing on your network can reach it. Use an SSH tunnel or Tailscale for the dashboard.
No shell commands from chatA web page that tries to trick the agent into running commands has nothing to call.
File tools limited to the workspaceThe agent cannot read the rest of the system.
Firewall, automatic security updates, SSH brute-force protectionThe operating system looks after itself.
Groups: answers only when mentionedAdding 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.

AgentJobWhen
Chief of staffMorning briefWeekdays 07:30
Chief of staffWeekly reviewSundays 18:00
Research scoutDaily digestEvery day 08:00
Research scoutWeekly trendsFridays 17:00
Ops watchdogPi health (a script, no model)Every 15 minutes
Ops watchdogWeekly status (a script, no model)Mondays 09:00
Ops watchdogMonthly incident review1st 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.