PicoClaw is an ultra-lightweight personal AI assistant — a single static Go binary small enough to run on $10 hardware with under 10 MB of RAM. It connects to any OpenAI-compatible LLM (locally via Lemonade or Ollama, or cloud providers such as OpenAI, Anthropic, Gemini, and 30+ others) and to 19+ messaging platforms (Telegram, Discord, WhatsApp, Matrix, and more), performing agentic tasks with persistent memory and skills.
LOCAL AI
Run 'picoclaw.lemonade' to detect a running lemonade-server (http://127.0.0.1:13305), pick one of its models from a menu, and configure it as PicoClaw's default — fully offline, no API key required.
Or run 'picoclaw.inference-snap' to pick a Canonical inference snap (gemma4, gemma3, deepseek-r1, and others) as the provider instead.
SETUP
Run the onboarding wizard on first launch:
picoclaw onboard
Then add a provider API key (or use Lemonade/Ollama locally) and chat:
picoclaw agent -m "Hello!"
The background gateway service (chat integrations) starts automatically the first time you run any picoclaw command and is managed as a standard systemd user unit:
systemctl --user status picoclaw systemctl --user stop picoclaw
SECURITY NOTE
This tool is capable of executing code, accessing files, and interacting with external services on your behalf. Due to the nature of autonomous AI agents, we recommend installing and running this snap inside an LXD container as best practice. A container provides an extra layer of confinement, limiting the agent's reach to the container environment and reducing exposure to your host system and personal data.
lxc launch ubuntu:24.04 my-agent lxc exec my-agent -- snap install --classic picoclaw
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
Snap is available for Red Hat Enterprise Linux (RHEL) 8 and RHEL 7, from the 7.6 release onward.
The packages for RHEL 7, RHEL 8, and RHEL 9 are in each distribution’s respective Extra Packages for Enterprise Linux (EPEL) repository. The instructions for adding this repository diverge slightly between RHEL 7, RHEL 8 and RHEL 9, which is why they’re listed separately below.
The EPEL repository can be added to RHEL 9 with the following command:
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo dnf upgrade
The EPEL repository can be added to RHEL 8 with the following command:
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo dnf upgrade
The EPEL repository can be added to RHEL 7 with the following command:
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
Adding the optional and extras repositories is also recommended:
sudo subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms"
sudo yum update
Snap can now be installed as follows:
sudo yum install snapd
Once installed, the systemd unit that manages the main snap communication socket needs to be enabled:
sudo systemctl enable --now snapd.socket
To enable classic snap support, enter the following to create a symbolic link between /var/lib/snapd/snap and /snap:
sudo ln -s /var/lib/snapd/snap /snap
Either log out and back in again or restart your system to ensure snap’s paths are updated correctly.
To install PicoClaw, simply use the following command:
sudo snap install picoclaw --candidate --classic
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.