Docker Compose for PicoClaw

Run PicoClaw as an always-on AI assistant using Docker Compose. Mount your configuration into the container and keep your setup easy to update.

1. Why Docker Compose?

  • Simple deployment with a single `compose.yml`
  • Volumes for persistent config/workspace
  • Works well for homelab setups with other services

2. Example `compose.yml`

This example mounts `config.yaml` and keeps the container running.

services:
  picoclaw:
    image: ghcr.io/sipeed/picoclaw:latest
    container_name: picoclaw
    volumes:
      - ./config.yaml:/etc/picoclaw/config.yaml
    restart: unless-stopped
    # ports:
    #   - "8080:8080"

3. Start PicoClaw with Compose

docker compose up -d
docker compose logs -f picoclaw

4. Next steps