zeroclaw-docker

Container image for running zeroclaw with persistent workspace data at /zeroclaw-data.

Onboard (first-time setup)

Run interactive onboarding and persist data by mounting /zeroclaw-data:

docker run --rm -it -v zeroclaw-data:/zeroclaw-data ghcr.io/jhoogstraat/zeroclaw-docker:latest zeroclaw onboard --interactive

Start

docker run -d --name zeroclaw -v zeroclaw-data:/zeroclaw-data ghcr.io/jhoogstraat/zeroclaw-docker:latest

Notes:

• zeroclaw daemon is executed by default when no command is provided.
• Use the same volume (zeroclaw-data) for future runs so config/state is reused.
• The volume can also be a local directory (like ./zeroclaw)

Executing commands

It is necessary to access the zeroclaw cli to approve channels. With zeroclaw running in a container, execute:

docker exec -it zeroclaw zeroclaw

Docker Compose

A ready example is included at compose.yaml.

Run onboarding:

docker compose run --rm zeroclaw-onboard

Start service:

docker compose up -d zeroclaw

Podman Quadlet

A ready example is included at examples/zeroclaw.container.

1. Copy it to your user Quadlet directory:

mkdir -p ~/.config/containers/systemd
cp examples/zeroclaw.container ~/.config/containers/systemd/zeroclaw.container

2. Edit the Image= line and replace <github-owner>.
3. Run onboarding once with the same volume:

podman run --rm -it \
  -v zeroclaw-data:/zeroclaw-data \
  ghcr.io/jhoogstraat/zeroclaw-docker:latest \
  onboard --interactive

4. Enable and start the Quadlet service:

systemctl --user daemon-reload
systemctl --user enable --now zeroclaw.service