Managing Your Install

ClawHalla is managed differently depending on your install mode.

Docker

All commands run from your install directory (default ~/clawhalla).

Start / Stop / Restart

cd ~/clawhalla

docker compose up -d        # start all services
docker compose down         # stop all services (data preserved)
docker compose restart      # restart all services

View logs

docker compose logs -f                   # all services
docker compose logs -f openclaw          # gateway only
docker compose logs -f mission-control   # MC only

Update to latest version

Re-run the installer — it detects the existing install and offers an Update option:

curl -fsSL https://clawhalla.xyz/install.sh | bash

Select 1 — Update to pull the latest code and restart services. All data is preserved.

Reset (fresh start)

Select 2 — Reinstall from the installer menu. Your data directory is preserved and restored after the fresh clone.

---

Bare Metal (PM2)

Services are managed by PM2, named after your workspace.

List running processes

pm2 list

Start / Stop / Restart

pm2 restart <workspace>-gateway
pm2 restart <workspace>-mc
pm2 stop <workspace>-gateway

View logs

pm2 logs <workspace>-gateway
pm2 logs <workspace>-mc

Update

Same as Docker — re-run the installer and select Update.

Auto-start on boot

PM2 startup is configured automatically by the installer. To reconfigure manually:

pm2 startup   # prints a command to run with sudo
pm2 save      # saves current process list

---

Multiple Instances

You can run multiple ClawHalla instances on the same machine (e.g. different workspaces for different users). Each instance uses a different install directory and ports — the installer auto-detects available ports.

# Instance 1 — already running on :18789 / :3000
~/daniel/

# Instance 2 — installer detects ports in use, suggests next free
~/spouse/        # gateway :18790, MC :3001