picoclaw Docker & Self-Hosted Deployment

GitHub

Tiny, Fast, and Deployable anywhere — automate the mundane, unleash your creativity

29,841 stars Go Go 1 file · ~10,195 tokens
RAW Compose
1. Pull Image (DOCKERHUB) docker pull sipeed/picoclaw
2. Docker Run (1-Click Launch) docker run -d --name picoclaw --restart always sipeed/picoclaw:latest
3. Podman Run podman run -d --name picoclaw --restart always sipeed/picoclaw:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://docker.io/sipeed/picoclaw:latest
5. ORAS Pull (OCI Artifact) oras pull sipeed/picoclaw:latest
6. Compose Deployment docker compose up -d
docker/docker-compose.full.yml
Download .yml 
services:
  # ─────────────────────────────────────────────
  # PicoClaw Agent (one-shot query) - Full MCP Support
  #   docker compose -f docker/docker-compose.full.yml run --rm picoclaw-agent -m "Hello"
  # ─────────────────────────────────────────────
  picoclaw-agent:
    build:
      context: ..
      dockerfile: docker/Dockerfile.full
    container_name: picoclaw-agent-full
    profiles:
      - agent
    volumes:
      - ../config/config.json:/root/.picoclaw/config.json:ro
      - picoclaw-workspace:/root/.picoclaw/workspace
      - picoclaw-npm-cache:/root/.npm # npm cache for faster MCP server installs
    entrypoint: ["picoclaw", "agent"]
    stdin_open: true
    tty: true

  # ─────────────────────────────────────────────
  # PicoClaw Gateway (Long-running Bot) - Full MCP Support
  #   docker compose -f docker/docker-compose.full.yml --profile gateway up
  # ─────────────────────────────────────────────
  picoclaw-gateway:
    build:
      context: ..
      dockerfile: docker/Dockerfile.full
    container_name: picoclaw-gateway-full
    restart: unless-stopped
    profiles:
      - gateway
    volumes:
      # Configuration file
      - ../config/config.json:/root/.picoclaw/config.json:ro
      # Persistent workspace (sessions, memory, logs)
      - picoclaw-workspace:/root/.picoclaw/workspace
      # NPM cache for faster MCP server installs
      - picoclaw-npm-cache:/root/.npm
    command: ["gateway"]

volumes:
  picoclaw-workspace:
  picoclaw-npm-cache: # Cache npm packages to speed up MCP server installations