Installez et exécutez l'assistant IA Clawdbot dans des conteneurs Docker. Configuration de passerelle conteneurisée avec Docker Compose.

Aperçu de Clawdbot Docker

Docker est optionnel pour Clawdbot. Utilisez-le uniquement si vous voulez une passerelle conteneurisée ou pour valider le flux Docker.

Docker est-il Adapté pour Moi ?

Cas d'Utilisation	Recommandation
Environnement de passerelle isolé et jetable	Oui, utilisez Docker
Exécuter Clawdbot sur l'hôte sans installations locales	Oui, utilisez Docker
Exécuter sur votre propre machine pour le cycle de développement le plus rapide	Non, utilisez l'installation normale

Note : Le sandboxing des agents utilise aussi Docker, mais il ne nécessite pas que la passerelle complète s'exécute dans Docker.

Prérequis

Docker Desktop (ou Docker Engine) + Docker Compose v2
Suffisamment d'espace disque pour les images + logs

Passerelle Conteneurisée (Docker Compose)

Démarrage Rapide (Recommandé)

Depuis la racine du dépôt :

./docker-setup.sh

Ce script :

Construit l'image de la passerelle
Exécute l'assistant d'intégration
Affiche les conseils optionnels de configuration des fournisseurs
Démarre la passerelle via Docker Compose
Génère un token de passerelle et l'écrit dans .env

Variables d'environnement optionnelles :

Variable	Description
`CLAWDBOT_DOCKER_APT_PACKAGES`	Installer des paquets apt supplémentaires pendant la construction
`CLAWDBOT_EXTRA_MOUNTS`	Ajouter des montages de liaison hôte supplémentaires
`CLAWDBOT_HOME_VOLUME`	Persister /home/node dans un volume nommé

Après la fin :

Ouvrez http://127.0.0.1:18789/ dans votre navigateur
Collez le token dans l'UI de Contrôle (Paramètres → token)

Besoin de l'URL tokenisée à nouveau ?

docker compose run --rm clawdbot-cli dashboard --no-open

Flux Manuel (Compose)

docker build -t clawdbot:local -f Dockerfile .
docker compose run --rm clawdbot-cli onboard
docker compose up -d clawdbot-gateway

Token de l'UI de Contrôle + Appairage (Docker)

Si vous voyez "non autorisé" ou "déconnecté (1008) : appairage requis" :

docker compose run --rm clawdbot-cli dashboard --no-open
docker compose run --rm clawdbot-cli devices list
docker compose run --rm clawdbot-cli devices approve <requestId>

Montages Supplémentaires (Optionnel)

Monter des répertoires hôte supplémentaires dans les conteneurs :

export CLAWDBOT_EXTRA_MOUNTS="$HOME/.codex:/home/node/.codex:ro,$HOME/github:/home/node/github:rw"
./docker-setup.sh

Persister le Home du Conteneur (Optionnel)

Persister /home/node entre les recréations du conteneur :

export CLAWDBOT_HOME_VOLUME="clawdbot_home"
./docker-setup.sh

Installer des Paquets Supplémentaires (Optionnel)

Installer des paquets système dans l'image :

export CLAWDBOT_DOCKER_APT_PACKAGES="ffmpeg build-essential"
./docker-setup.sh

Sandbox d'Agent (Outils Docker)

Clawdbot peut utiliser Docker pour le sandboxing des agents, isolant les outils d'agents dans des conteneurs.

Ce Que Ça Fait

Exécute les outils d'agents (exec, browser, etc.) dans des conteneurs Docker isolés
Fournit des frontières de sécurité entre les agents
Permet des profils de sandbox par agent

Activer le Sandboxing

Dans votre clawdbot.json :

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

Construire l'Image de Sandbox

clawdbot sandbox build

Profils de Sandbox par Agent

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.clawdbot/workspace",
        "sandbox": {
          "mode": "off"
        }
      },
      "untrusted": {
        "sandbox": {
          "mode": "always"
        }
      }
    }
  }
}

Vérification de Santé

docker compose run --rm clawdbot-cli health
docker compose run --rm clawdbot-cli status

Vérifiez les logs Docker : docker compose logs clawdbot-gateway
Vérifiez que le port 18789 n'est pas utilisé
Assurez-vous que Docker a suffisamment de ressources

Problèmes de Token

Régénérez le token de la passerelle :

docker compose run --rm clawdbot-cli configure --reset-token

Étapes Suivantes

Installation de Clawdbot - Autres méthodes d'installation
Passerelle Clawdbot - Configuration de la passerelle
Configuration de Clawdbot - Guide de configuration complet

Installation de Clawdbot avec Docker