devboxes
Deploy isolated development containers with web-accessible VSCode, VNC, and automated app routing via Traefik or Cloudflare Tunnels.
Introduction
The Devboxes skill enables OpenClaw agents to provision and manage fully functional, isolated development environment containers. Designed for developers and technical users, this skill streamlines the process of creating coding sandboxes on demand. By leveraging custom images containing VSCode Web, noVNC for visual desktop access, and headless Chromium with Chrome DevTools Protocol (CDP) support, it provides a consistent, portable development environment regardless of the host machine's configuration. The skill automates complex infrastructure tasks, including sequential container ID assignment, environment variable injection, and dynamic network routing configuration.
-
Automated lifecycle management for devbox containers with sequential ID tracking via local counter files.
-
Flexible routing options supporting Traefik for self-hosted infrastructure or Cloudflare Tunnels for zero-port-forwarding connectivity.
-
Integrated browser-based IDE (VSCode Web) and visual desktop access (noVNC) for immediate, remote-ready coding sessions.
-
Support for up to five routable application ports, allowing for previewing web services, APIs, and dashboards via clean, unique URLs.
-
Seamless project setup using .openclaw/setup.sh conventions and NVM integration for automated runtime configuration.
-
Headless browser automation capabilities via Chromium and CDP, ideal for end-to-end testing and synthetic monitoring.
-
Prerequisite: Requires Docker socket access (/var/run/docker.sock) on the host system to spawn containers.
-
Usage: Onboarding requires specifying a routing mode (Traefik/Cloudflare), a wildcard DNS domain, and optional GitHub tokens for private repository cloning.
-
Constraints: All user capabilities are dropped by default; host-mounted volumes for Traefik configuration require specific permission settings (chmod 777 on the host side).
-
Workflow: The main agent handles infrastructure orchestration, while sub-agents execute devbox-init scripts to configure shell environments and routing ingress automatically.
-
Best for: Rapid prototyping, ephemeral coding sandboxes, collaborative debugging sessions, and testing full-stack applications in consistent, isolated environments.
Repository Stats
- Stars
- 10
- Forks
- 2
- Open Issues
- 3,202
- Language
- Not provided
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- May 3, 2026, 10:28 PM