Instale e execute o assistente de IA Clawdbot em contêineres Docker. Configuração de gateway containerizado com Docker Compose.

Visão Geral do Clawdbot Docker

Docker é opcional para o Clawdbot. Use-o apenas se você quiser um gateway containerizado ou para validar o fluxo do Docker.

O Docker é Adequado para Mim?

Caso de Uso	Recomendação
Ambiente de gateway isolado e descartável	Sim, use Docker
Executar Clawdbot no host sem instalações locais	Sim, use Docker
Executar na sua própria máquina para o ciclo de desenvolvimento mais rápido	Não, use instalação normal

Nota: O sandboxing de agentes também usa Docker, mas não requer que o gateway completo seja executado no Docker.

Requisitos

Docker Desktop (ou Docker Engine) + Docker Compose v2
Espaço em disco suficiente para imagens + logs

Gateway Containerizado (Docker Compose)

Início Rápido (Recomendado)

A partir da raiz do repositório:

./docker-setup.sh

Este script:

Constrói a imagem do gateway
Executa o assistente de integração
Exibe dicas opcionais de configuração de provedores
Inicia o gateway via Docker Compose
Gera um token de gateway e o escreve em .env

Variáveis de ambiente opcionais:

Variável	Descrição
`CLAWDBOT_DOCKER_APT_PACKAGES`	Instalar pacotes apt adicionais durante a construção
`CLAWDBOT_EXTRA_MOUNTS`	Adicionar montagens de ligação de host adicionais
`CLAWDBOT_HOME_VOLUME`	Persistir /home/node em um volume nomeado

Após terminar:

Abra http://127.0.0.1:18789/ no seu navegador
Cole o token na UI de Controle (Configurações → token)

Precisa da URL com token novamente?

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

Fluxo Manual (Compose)

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

Token da UI de Controle + Emparelhamento (Docker)

Se você vir "não autorizado" ou "desconectado (1008): emparelhamento necessário":

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>

Montagens Adicionais (Opcional)

Monte diretórios de host adicionais nos contêineres:

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

Persistir Home do Contêiner (Opcional)

Persistir /home/node entre recriações do contêiner:

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

Instalar Pacotes Adicionais (Opcional)

Instalar pacotes do sistema dentro da imagem:

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

Sandbox de Agente (Ferramentas Docker)

O Clawdbot pode usar Docker para sandboxing de agentes, isolando ferramentas de agentes em contêineres.

O Que Faz

Executa ferramentas de agentes (exec, browser, etc.) em contêineres Docker isolados
Fornece limites de segurança entre agentes
Permite perfis de sandbox por agente

Habilitar Sandboxing

No seu clawdbot.json:

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

Construir a Imagem de Sandbox

clawdbot sandbox build

Perfis de Sandbox por Agente

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

Verificação de Saúde

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

Solução de Problemas

Erros de Permissão (EACCES)

Se você vir erros de permissão, verifique se os diretórios montados têm as permissões corretas.

O Contêiner Não Inicia

Verifique os logs do Docker: docker compose logs clawdbot-gateway
Verifique se a porta 18789 não está em uso
Certifique-se de que o Docker tem recursos suficientes

Problemas com Token

Regenere o token do gateway:

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

Próximos Passos

Instalação do Clawdbot - Outros métodos de instalação
Gateway do Clawdbot - Configuração do gateway
Configuração do Clawdbot - Guia completo de configuração

Instalação do Clawdbot com Docker