PicoClaw on Raspberry Pi: Setup Guide for Clawbot & OpenClaw AI Assistants - Deploy your own tiny, fast AI automation bot


The Problem

You installed PicoClaw, the tiny, fast, and deployable anywhere, Clawdbot-inspired AI assistant to automate the mundane and unleash your creativity, on a Raspberry Pi. It works great, until you disconnect from SSH and it stops. Or your Pi loses network because the Ethernet chip went to sleep to save power.

This guide fixes that.


1. Put the binary in the right place

The issue: Your binary lives in /home/pi/picoclaw. That's fine for testing. But it's not where Linux expects user programs to be.

The fix:

sudo cp /home/pi/picoclaw /usr/local/bin/picoclaw
sudo chmod +x /usr/local/bin/picoclaw

Why: /usr/local/bin is where custom software goes. System services expect to find executables there. It's the convention.


2. Make it run forever (systemd service)

The issue: Running ./picoclaw gateway in an SSH session dies when you disconnect. You need it to run in the background, automatically, even after a reboot.

The fix:

Create /etc/systemd/system/picoclaw.service:

[Unit]
Description=PicoClaw Gateway
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi
ExecStart=/usr/local/bin/picoclaw gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Then tell systemd about it:

sudo systemctl daemon-reload
sudo systemctl enable picoclaw
sudo systemctl start picoclaw

Why:

Check it's running:

sudo systemctl status picoclaw

3. Stop the network card from sleeping

The issue: The Raspberry Pi's Ethernet (bcmgenet) and WiFi (brcmfmac) adapters have power saving enabled by default. They go to sleep when idle. When they wake up, they may not reconnect properly, especially on Pi 3B+ and Pi 4.

You know this happened if your Pi goes silent and dmesg shows:

bcmgenet fd580000.ethernet eth0: link down

The fix:

Edit /boot/firmware/cmdline.txt (note: not /boot/cmdline.txt. This varies by Pi model and OS):

Add this to the single line (keep everything else on that line):

psci=force_on

That enables ARM Power State Coordination Interface, which helps keep things awake.

Then disable WiFi power saving:

echo "options brcmfmac roamoff=1 feature_disable=0x82000" | sudo tee /etc/modprobe.d/brcmfmac.conf

Reboot:

sudo reboot

Why:


4. Verify everything works

# Check service is running
sudo systemctl status picoclaw

# Check for power save issues in logs
dmesg | grep -i "power\|sleep\|wol"

# Check network is stable
ip link show
ping -c 3 8.8.8.8

Summary

Step Command
Move binary sudo cp /home/pi/picoclaw /usr/local/bin/picoclaw
Create service Write /etc/systemd/system/picoclaw.service
Enable service sudo systemctl enable picoclaw
Disable power save Edit /boot/firmware/cmdline.txt, add /etc/modprobe.d/brcmfmac.conf
Reboot sudo reboot

Why this matters

A personal AI assistant should be always on. You don't want to SSH in just to start it. You don't want it going offline because a network chip napped.

These three changes (binary location, systemd service, power management) make your Pi a reliable server instead of a finicky toy.

That's it.

Resources

Picoclaw repo: https://github.com/sipeed/picoclaw
Picoclaw releases: https://github.com/sipeed/picoclaw/releases