# ClawdBox

A persistent sandbox environment for Clawdbot (OpenClaw).

## Purpose
This container provides a stable, tool-rich environment for the AI agent to:
- Persist state across agent restarts.
- Run long-running processes.
- Perform "messy" work (compiling, scraping, data processing) without polluting the main agent container or host.
- Use tools that aren't available in the minimal agent environment.

## Tools Included
- **Core:** curl, wget, git, jq, yq, unzip, tar, vim/nano
- **Dev:** python3 (pip/venv), build-essential, nodejs, npm
- **Network:** ping, dnsutils, net-tools
- **Media:** ffmpeg
- **Access:** openssh-server

## Deployment (OpenShift / K8s)

1. **Build Image:**
   ```bash
   docker build -t clawdbox .
   ```

2. **Run with Persistence:**
   Ensure you mount a PVC to `/data` to keep files across restarts.

   ```yaml
   apiVersion: v1
   kind: Pod
   metadata:
     name: clawdbox
   spec:
     containers:
     - name: clawdbox
       image: clawdbox:latest
       ports:
       - containerPort: 22
       volumeMounts:
       - mountPath: /data
         name: claw-data
     volumes:
     - name: claw-data
       persistentVolumeClaim:
         claimName: claw-pvc
   ```

## Access
Connect via SSH using the `claw` user (passwordless sudo enabled).