Openclaw용 Devboxes

통합 IDE, 그래픽 액세스 및 자동 웹 라우팅을 갖춘 격리된 개발 컨테이너 관리를 위한 종합 시스템입니다.

adshrc
v1.4.0
Mar 8, 2026
0
1k
39

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install devboxes

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 devboxes 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Devboxes란 무엇인가요?

Devboxes는 임시적이고 안전하며 모든 기능을 갖춘 코딩 샌드박스를 만들기 위한 강력한 오케스트레이션 레이어를 나타냅니다. Openclaw Skills와 원활하게 작동하도록 설계된 이 도구를 사용하면 사용자는 VSCode Web, 데스크톱 액세스를 위한 noVNC, 자동화된 브라우저 상호 작용을 위한 headless Chromium이 포함된 컨테이너를 가동할 수 있습니다. 각 devbox는 에이전트가 호스트 시스템에 영향을 주지 않고 코드를 작성, 테스트 및 미리 볼 수 있는 격리된 환경입니다.

Traefik 또는 Cloudflare Tunnels를 통한 정교한 라우팅을 활용하여 Devboxes는 각 서비스에 대해 고유한 URL을 제공합니다. 이를 통해 개발자와 AI 에이전트는 최대 5개의 동시 애플리케이션 포트, 프라이빗 GitHub 리포지토리 복제 및 사용자 정의 프로젝트 설정 스크립트를 지원하는 일관된 환경 내에서 실시간으로 협업할 수 있습니다.

Devboxes 활용 사례

  • 신뢰할 수 없는 코드나 새로운 라이브러리 테스트를 위한 격리된 샌드박스 생성.
  • AI 에이전트에게 웹 개발 및 디버깅을 위한 완전한 환경 제공.
  • 빠른 협업 세션을 위한 임시 원격 IDE 설정.
  • 컨테이너화된 라이프사이클 내에서 브라우저 기반 통합 테스트 자동화.
  • 고유한 라우팅 및 DNS 매핑으로 여러 개발 환경 관리.

Devboxes 작동 원리

  1. 메인 에이전트가 영구 카운터 파일을 읽고 증가시켜 고유한 DEVBOX_ID를 할당합니다.
  2. 필요한 모든 개발 도구가 포함된 특수 Docker 이미지를 사용하여 하위 에이전트가 초기화됩니다.
  3. 하위 에이전트가 환경 변수 및 라우팅 구성을 빌드하는 초기화 스크립트를 실행합니다.
  4. 컨테이너 진입 시 Xvfb, VSCode Web 및 Chromium과 같은 핵심 서비스가 자동으로 시작됩니다.
  5. Traefik 동적 설정 또는 Cloudflare Tunnel API 등록을 통해 네트워킹이 구축됩니다.
  6. 시스템이 IDE, VNC 및 애플리케이션 포트에 대해 액세스 가능한 URL을 생성하여 사용자에게 반환합니다.

Devboxes 설정 가이드

Openclaw Skills에서 Devboxes를 시작하려면 다음 단계를 따르세요.

  1. 컨테이너 내에서 Docker 소켓에 액세스할 수 있는지 확인합니다.
ls -l /var/run/docker.sock
  1. 환경 ID를 추적하기 위해 devbox 카운터를 초기화합니다.
echo "0" > /home/node/.openclaw/.devbox-counter
  1. 필요한 이미지를 가져옵니다.
docker pull ghcr.io/adshrc/openclaw-devbox:latest
  1. 온보딩 흐름에 따라 openclaw.json 내에서 라우팅 모드(Traefik 또는 Cloudflare) 및 도메인 설정을 구성합니다.

Devboxes 데이터 스키마 및 분류 체계

이 스킬은 특정 파일 계층 구조를 통해 상태와 구성을 관리합니다.

경로 설명
/home/node/.openclaw/.devbox-counter 새 devbox의 순차 ID를 추적합니다.
/etc/devbox.env 현재 박스의 동적 환경 변수를 저장합니다.
/home/node/.openclaw/traefik Traefik 라우팅을 위한 동적 YAML 설정입니다.
/etc/profile.d/devbox.sh 환경 유지를 위한 셸 초기화 스크립트입니다.

Devboxes 고급 기능

  • 컨테이너당 5개의 고유한 애플리케이션 포트에 대한 자동 라우팅.
  • 브라우저 자동화를 위해 포트 9222에서 Chrome DevTools Protocol(CDP)이 포함된 통합 Chromium.
  • 리포지토리 내의 .openclaw/setup.sh를 통한 사용자 정의 프로젝트 설정 스크립트 지원.
  • 로컬 Traefik 인스턴스 또는 글로벌 Cloudflare Tunnels를 지원하는 듀얼 라우팅 백엔드.
  • 프라이빗 프로젝트의 자동 복제를 위한 안전한 GitHub PAT 통합.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*