ClawdBox/README.md

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:

   docker build -t clawdbox .
   

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

   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).