How to Fix OpenClaw Docker Container Crashing

# See all containers including stopped ones:
docker ps -a | grep openclaw

# Check exit code:
docker inspect openclaw --format='{{.State.ExitCode}}'
# Exit codes:
# 0 = clean exit (shouldn't restart)
# 137 = SIGKILL, often OOMKilled
# 139 = SIGSEGV, segmentation fault
# 1 = general error

# Check if OOMKilled:
docker inspect openclaw --format='{{.State.OOMKilled}}'

# Get logs from last crash:
docker logs openclaw --tail 200

# Follow logs in real-time:
docker logs -f openclaw

# Get logs from all restart attempts:
docker logs openclaw --since 1h

# Look for:
# - "Cannot find module" (missing dependencies)
# - "ENOENT" (missing files/volumes)
# - "ECONNREFUSED" (network issues)
# - "JavaScript heap out of memory" (needs more RAM)

# Check current memory limit:
docker inspect openclaw --format='{{.HostConfig.Memory}}'

# Stop and remove container:
docker stop openclaw
docker rm openclaw

# Recreate with higher memory limit:
docker run -d \
  --name openclaw \
  --memory="4g" \
  --memory-swap="4g" \
  -p 3000:3000 \
  openclaw/openclaw:latest

# Or update docker-compose.yml:
services:
  openclaw:
    mem_limit: 4g
    mem_reservation: 2g

# Inspect mounted volumes:
docker inspect openclaw --format='{{json .Mounts}}' | jq .

# Check if volumes exist on host:
ls -la /var/lib/openclaw/data
ls -la /var/lib/openclaw/config

# Test volume access inside container:
docker exec openclaw ls -la /app/data
docker exec openclaw cat /app/config/config.json

# Fix permissions if needed:
sudo chown -R 1000:1000 /var/lib/openclaw

# Recreate with correct volumes:
docker run -d \
  -v /var/lib/openclaw/data:/app/data \
  -v /var/lib/openclaw/config:/app/config \
  openclaw/openclaw:latest

# List available tags:
curl -s https://registry.hub.docker.com/v2/repositories/openclaw/openclaw/tags | jq .

# Pull specific version:
docker pull openclaw/openclaw:1.2.3

# Update docker-compose.yml:
services:
  openclaw:
    image: openclaw/openclaw:1.2.3  # Not :latest

# Or in docker run:
docker run -d openclaw/openclaw:1.2.3

# Document which version is running:
docker exec openclaw cat /app/VERSION

# Stop the crashing container:
docker stop openclaw

# Run interactively with shell:
docker run -it --rm \
  --name openclaw-debug \
  -p 3000:3000 \
  openclaw/openclaw:latest \
  /bin/bash

# Inside container, manually start OpenClaw:
node server.js
# Or:
python main.py

# Watch for startup errors
# Once working, exit and recreate with -d (detached)