Devboxes para Openclaw

Um sistema abrangente para gerenciar contêineres de desenvolvimento isolados com IDEs integradas, acesso gráfico e roteamento web automatizado.

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

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install devboxes

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o devboxes usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Devboxes?

Devboxes representam uma poderosa camada de orquestração para criar sandboxes de codificação temporárias, seguras e completas. Projetada para funcionar perfeitamente com o Openclaw Skills, esta ferramenta permite que os usuários iniciem contêineres que incluem VSCode Web, noVNC para acesso ao desktop e Chromium headless para interações automatizadas com o navegador. Cada devbox é um ambiente isolado onde os agentes podem escrever, testar e visualizar o código sem afetar o sistema host.

Aproveitando o roteamento sofisticado através do Traefik ou Cloudflare Tunnels, os Devboxes fornecem URLs exclusivas para cada serviço. Isso permite que desenvolvedores e agentes de IA colaborem em tempo real em um ambiente consistente que suporta até cinco portas de aplicativos simultâneas, clonagem de repositórios privados do GitHub e scripts de configuração de projeto personalizados.

Casos de uso do Devboxes

  • Criação de sandboxes isoladas para testar código não confiável ou novas bibliotecas.
  • Fornecimento de um ambiente completo para agentes de IA para desenvolvimento e depuração web.
  • Configuração de IDEs remotas temporárias para sessões de colaboração rápida.
  • Automação de testes de integração baseados em navegador dentro de um ciclo de vida em contêiner.
  • Gerenciamento de múltiplos ambientes de desenvolvimento com roteamento e mapeamento DNS exclusivos.

Como o Devboxes funciona

  1. O agente principal lê e incrementa um arquivo de contador persistente para atribuir um DEVBOX_ID exclusivo.
  2. Um subagente é inicializado usando uma imagem Docker especializada contendo todas as ferramentas de desenvolvimento necessárias.
  3. O subagente executa um script de inicialização que constrói as variáveis de ambiente e a configuração de roteamento.
  4. Serviços principais como Xvfb, VSCode Web e Chromium iniciam automaticamente ao entrar no contêiner.
  5. A rede é estabelecida via configurações dinâmicas do Traefik ou registro de API do Cloudflare Tunnel.
  6. O sistema gera e retorna URLs acessíveis para o IDE, VNC e portas de aplicativos para o usuário.

Configuração do Devboxes

Para começar com Devboxes no Openclaw Skills, siga estas etapas:

  1. Certifique-se de que o socket do Docker esteja acessível dentro do seu contêiner:
ls -l /var/run/docker.sock
  1. Inicialize o contador do devbox para rastrear os IDs do ambiente:
echo "0" > /home/node/.openclaw/.devbox-counter
  1. Puxe a imagem necessária:
docker pull ghcr.io/adshrc/openclaw-devbox:latest
  1. Siga o fluxo de integração para configurar seu modo de roteamento (Traefik ou Cloudflare) e as configurações de domínio no openclaw.json.

Esquema de Dados e Taxonomia de Devboxes

A skill gerencia seu estado e configuração por meio de uma hierarquia de arquivos específica:

Caminho Descrição
/home/node/.openclaw/.devbox-counter Rastreia o ID sequencial para novos devboxes.
/etc/devbox.env Armazena variáveis de ambiente dinâmicas para o box atual.
/home/node/.openclaw/traefik Configurações YAML dinâmicas para roteamento Traefik.
/etc/profile.d/devbox.sh Script de inicialização do shell para persistência do ambiente.

Recursos avançados do Devboxes

  • Roteamento automatizado para 5 portas de aplicativos distintas por contêiner.
  • Chromium integrado com Chrome DevTools Protocol (CDP) na porta 9222 para automação de navegador.
  • Suporte para scripts de configuração de projeto personalizados via .openclaw/setup.sh dentro dos repositórios.
  • Backends de roteamento duplo suportando instâncias locais do Traefik ou Cloudflare Tunnels globais.
  • Integração segura de PAT do GitHub para clonagem automatizada de projetos privados.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*