A comprehensive system for managing isolated development containers with integrated IDEs, graphical access, and automated web routing.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install devboxes
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install devboxes using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Devboxes?
Devboxes represent a powerful orchestration layer for creating temporary, secure, and fully-featured coding sandboxes. Designed to work seamlessly with Openclaw Skills, this tool allows users to spin up containers that include VSCode Web, noVNC for desktop access, and headless Chromium for automated browser interactions. Each devbox is an isolated environment where agents can write, test, and preview code without affecting the host system.
By leveraging sophisticated routing through Traefik or Cloudflare Tunnels, Devboxes provide unique URLs for each service. This enables developers and AI agents to collaborate in real-time within a consistent environment that supports up to five simultaneous application ports, private GitHub repository cloning, and custom project setup scripts.
Devboxes Use Cases
- Creating isolated sandboxes for testing untrusted code or new libraries.
- Providing AI agents with a complete environment for web development and debugging.
- Setting up temporary remote IDEs for quick collaboration sessions.
- Automating browser-based integration tests within a containerized lifecycle.
- Managing multiple development environments with unique routing and DNS mapping.
How Devboxes Works
- The main agent reads and increments a persistent counter file to assign a unique DEVBOX_ID.
- A subagent is initialized using a specialized Docker image containing all necessary development tools.
- The subagent executes a initialization script that builds the environment variables and routing configuration.
- Core services such as Xvfb, VSCode Web, and Chromium start automatically upon container entry.
- Networking is established via Traefik dynamic configs or Cloudflare Tunnel API registration.
- The system generates and returns accessible URLs for the IDE, VNC, and application ports to the user.
Devboxes Setup
To get started with Devboxes in Openclaw Skills, follow these steps:
- Ensure the Docker socket is accessible within your container:
ls -l /var/run/docker.sock
- Initialize the devbox counter to track environment IDs:
echo "0" > /home/node/.openclaw/.devbox-counter
- Pull the required image:
docker pull ghcr.io/adshrc/openclaw-devbox:latest
- Follow the onboarding flow to configure your routing mode (Traefik or Cloudflare) and domain settings within openclaw.json.
Devboxes Data Schema & Taxonomy
The skill manages its state and configuration through a specific file hierarchy:
| Path | Description |
|---|---|
/home/node/.openclaw/.devbox-counter |
Tracks the sequential ID for new devboxes. |
/etc/devbox.env |
Stores dynamic environment variables for the current box. |
/home/node/.openclaw/traefik |
Dynamic YAML configs for Traefik routing. |
/etc/profile.d/devbox.sh |
Shell initialization script for environment persistence. |
Devboxes Advanced Features
- Automated routing for 5 distinct application ports per container.
- Integrated Chromium with Chrome DevTools Protocol (CDP) on port 9222 for browser automation.
- Support for custom project setup scripts via
.openclaw/setup.shinside repositories. - Dual routing backends supporting either local Traefik instances or global Cloudflare Tunnels.
- Secure GitHub PAT integration for automated cloning of private projects.
SKILL.md
Loading
Related Openclaw Skills
Chitin Moat
A security framework that enforces AI agent permission boundaries based on the communication channel trust level.
Chitin Core
An intelligent routing layer that selects the most cost-effective AI model for any given task while ensuring zero downtime from rate limits.
Chitin Editorial
A git-backed coordination system for AI agents to manage content publication, prevent duplicates, and track narrative timelines.
Deepgram Discord Voice
Enables real-time, low-latency voice conversations with AI agents in Discord channels using Deepgram streaming technology.
Mobayilo Voice
A safety-first voice automation skill that enables AI agents to place outbound phone calls for bookings and follow-ups.
SecureClaw
A comprehensive security and auditing framework designed to protect AI agents from prompt injections, data leaks, and unauthorized commands.
Featured*
