docker-compose.yml

services:
  claw-agent-dashboard:
    image: iota3/claw-agent-dashboard:latest
    build:
      context: .
      args:
        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple/}
    # Run as uid=1000 to match host the typical host user, so files written to
    # bind-mounted directories (e.g. /agents → ~/.openclaw) are owned by
    # the host user (uid=1000) instead of root.
    user: "1000:1000"
    ports:
      - "8080:8080"
    volumes:
      # Agent workspaces — read-write (save feature needs write access)
      - ${OPENCLAW_HOME}:/agents
      # Translations + config — writable
      - ${DATA_HOST_DIR:-./data}:/data
      # NPM global skills — read-only (optional, uncomment if using global skills)
      # - ${OPENCLAW_SKILLS_DIR}:/global-skills:ro
      # Host /proc for system metrics — read-only (optional, Linux only)
      # - /proc:/host/proc:ro
      # Gateway logs — read-only (optional, for event parsing)
      # - ${OPENCLAW_LOGS_DIR}:/host/logs:ro
      # Session data — read-only (optional, for detailed session info)
      # - ${OPENCLAW_AGENTS_DIR}:/host/openclaw-data/agents:ro
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      - AGENTS_DIR=/agents
      - DATA_DIR=/data
      - AGENTS_HOST_DIR=${OPENCLAW_HOME}
      - DATA_HOST_DIR=${DATA_HOST_DIR:-./data}
      - GLOBAL_SKILLS_DIR=/global-skills
      - SHARED_SKILLS_DIR=/agents/shared-skills
      - LOGS_DIR=/host/logs
      - SESSION_DATA_DIR=/host/openclaw-data/agents
      - OPENCLAW_CONFIG_PATH=/agents/openclaw.json
      - GATEWAY_URL=${GATEWAY_URL:-http://host.docker.internal:18789}
      - GATEWAY_TOKEN=${GATEWAY_TOKEN:-}