Crabbox : une box à la demande pour les tests, builds et vérifications d'UI de vos agents

Install

npx skills add openclaw/crabbox --skill crabbox

Crabbox est conçu pour le scénario où un agent de codage modifie le code en local pendant que les tests, les builds ou les vérifications d'UI sont confiés à une machine distante disponible à la demande ; avant de commencer, la condition la plus importante est que votre machine puisse installer la CLI, et que Docker ou Podman soit déjà installé et lancé pour le chemin rapide des conteneurs locaux.

Pour qui ?

Pour celles et ceux qui veulent faire exécuter les tests, builds et vérifications d'UI par un agent (ou par eux-mêmes) sur une box cloud, une VM/conteneur local ou une machine qu'ils possèdent déjà, tout en continuant à éditer le code en local.
Crabbox est une CLI qui propose trois formes de box : box cloud, VM ou conteneur local, et votre propre machine existante.
Le chemin rapide des conteneurs locaux exige que Docker ou Podman soit installé et en cours d'exécution sur la machine ; le flux de travail via SSH exige en local git, ssh, ssh-keygen, rsync et curl. Si ces prérequis ne sont pas remplis, les preuves officielles ne mentionnent aucune autre méthode disponible.
S'agissant des box cloud, les preuves ne précisent ni la nécessité d'un compte, ni le mode de facturation, ni les plateformes cloud prises en charge ; à vérifier vous-même dans la documentation officielle avant utilisation.

Première tentative en 3 minutes

Le chemin principal officiel recommandé est le démarrage rapide par conteneur local, qui ne nécessite aucun compte cloud :

Prérequis : Docker ou Podman installé et lancé sur la machine, et la CLI installée séparément (l'indication officielle est "Install the CLI separately" ; pour les commandes d'installation exactes, référez-vous au README officiel).
Installer la compétence pour l'agent : exécuter la commande officielle dans un agent pris en charge :
```
npx skills add openclaw/crabbox --skill crabbox
```
L'éditeur publie aussi une compétence crabbox-quickstart, utilisable comme alternative.
Se placer dans un dépôt Git de confiance (l'éditeur exige de travailler dans un dépôt fiable).
Faire exécuter par l'agent (ou dans un terminal) la commande d'auto-diagnostic officielle :
```
crabbox doctor --provider local-container
```
Signal de succès : doctor valide les vérifications de l'environnement de conteneurs locaux.
Lancer ensuite une première tâche à faible risque et en lecture seule, pour valider toute la chaîne :
```
crabbox run --provider local-container -- uname -a
```
Signal de succès : Crabbox loue une box conteneur jetable, renvoie la sortie de la commande en streaming vers votre terminal, puis libère la box. Cet exemple n'exécute que uname -a et ne modifie pas vos fichiers.
Le flux de travail central ensuite est crabbox run -- <cmd> : il loue une box, synchronise votre arborescence de travail (y compris les modifications non commitées), exécute la commande en renvoyant la sortie en streaming vers le terminal, retourne le code de sortie, puis libère la box jetable. Attention : c'est l'arborescence de travail entière, modifications non commitées comprises, qui est synchronisée ; avant de lancer une vraie commande de test pour la première fois, assurez-vous de bien comprendre ce qui sera exécuté sur la box.

Cas d'usage

Cas n° 1 : exécuter la suite de tests dans une box propre avant de committer. Scénario : vous (ou l'agent) avez modifié le code mais ne voulez pas polluer votre environnement local. Faites exécuter par l'agent crabbox run -- pnpm test (en remplaçant pnpm test par la commande de test de votre projet). Résultat attendu : une box jetable est louée, votre arborescence de travail avec les modifications non commitées est synchronisée, la sortie des tests revient en streaming en temps réel dans le terminal, vous obtenez à la fin le vrai code de sortie, et la box est libérée.

Cas n° 2 : vérifier l'environnement de la box conteneur. Scénario : première configuration ou doute sur l'environnement. Faites d'abord exécuter par l'agent crabbox doctor --provider local-container pour le diagnostic, puis crabbox run --provider local-container -- uname -a pour confirmer que la box peut exécuter des commandes. Résultat attendu : doctor indique si l'environnement de conteneurs locaux est prêt ; run renvoie les informations système de la box, prouvant que la chaîne complète location—synchronisation—exécution—restitution fonctionne. Ces deux opérations ne font que des vérifications et de la lecture d'informations système : ce sont des actions de première utilisation typiques à faible risque.

Limites d'utilisation

Effets de bord et points de confirmation : chaque crabbox run loue une box et y synchronise votre arborescence de travail (modifications non commitées comprises), puis y exécute la commande que vous avez indiquée — la commande s'exécute réellement sur la box ; avant de la lancer, vérifiez son contenu. Le chemin des conteneurs locaux démarre en outre un conteneur sur votre machine ; les limites des services externes impliqués par les box cloud ne sont pas précisées par les preuves.
Prérequis d'environnement d'exécution : le chemin rapide des conteneurs locaux exige Docker ou Podman ; le flux SSH exige en local git, ssh, ssh-keygen, rsync et curl.
Prérequis côté client : la compétence s'installe via npx skills add et s'applique aux agents prenant en charge les agent skills ; la liste exacte des clients pris en charge n'est pas détaillée dans les preuves.
Informations clés non confirmées : les conditions d'activation et de compte des box cloud, la question de savoir si crabbox doctor ou run accède au réseau ou quels fichiers locaux ils lisent ou écrivent, ainsi que l'existence d'autres sous-commandes que celles montrées dans la documentation : rien de tout cela n'est précisé dans les preuves officielles ; consultez le README officiel avant utilisation.

Catégories de fonctions IA