Skip to main content
50% off all plans, limited time. Starting at $2.48/mo
PicoClaw

PicoClaw

PicoClaw is an ultra-lightweight self-hosted personal AI assistant written entirely in Go by Sipeed. Run your own assistant on a small server without a heavy runtime. MIT licensed with 29,800+ GitHub stars.

At a glance

License MIT Version Latest OS Ubuntu 24.04 LTS Min RAM 512 MB IP IPV4,IPV6

Access

  1. Open your browser: http://<SERVER-IP>:18800
  2. Log in using the dashboard password stored in: /root/.cloudzy-creds
  3. The web dashboard is the easiest way to configure PicoClaw, including the provider, model, and API key.

Manual Configuration

PicoClaw can also be configured manually.

Initialize your workspace:

picoclaw onboard

Configure the provider and model in: /root/.picoclaw/config.json

Configure the API key in: /root/.picoclaw/.security.yml

View available commands and options:

picoclaw -h

Important Files & Directories

  • PicoClaw Binary: /usr/local/bin/picoclaw
  • Launcher Binary: /usr/local/bin/picoclaw-launcher
  • Configuration: /root/.picoclaw/config.json
  • Security Configuration: /root/.picoclaw/.security.yml
  • Dashboard Credentials: /root/.cloudzy-creds
  • systemd Unit: /etc/systemd/system/picoclaw-launcher.service

Service Management

Check PicoClaw Launcher status:

systemctl status picoclaw-launcher.service

Restart PicoClaw Launcher:

systemctl restart picoclaw-launcher.service

Stop PicoClaw Launcher:

systemctl stop picoclaw-launcher.service

Start PicoClaw Launcher:

systemctl start picoclaw-launcher.service

View PicoClaw Launcher logs:

journalctl -u picoclaw-launcher.service -f

Running a Custom Launcher Configuration

The installation creates and enables a systemd service for the PicoClaw dashboard.

To stop and disable the default service:

systemctl disable --now picoclaw-launcher.service

You can then run picoclaw-launcher manually or create a custom systemd service.

View available launcher options:

picoclaw-launcher -h

More in Automation

Related apps.

Deploy PicoClaw now. From $2.48/mo.