Execute o OpenClaw no Docker

Execute o gateway e a CLI como serviços do Docker Compose, compilados a partir do código-fonte ou obtidos da imagem pré-construída ghcr.io/openclaw/openclaw.

1. Clone o repositório e execute a configuração

   O script de configuração do repositório prepara os serviços do Compose. Para ignorar o build local, exporte OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest antes de executá-lo. Uma imagem espelhada também é publicada no Docker Hub como openclaw/openclaw.

   shellCopiar

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   ./scripts/docker/setup.sh

2. Abra o dashboard

   Este comando executa o contêiner da CLI uma vez para abrir o dashboard; --no-open impede que ele tente iniciar um navegador dentro do contêiner. Outros comandos da CLI funcionam da mesma forma. Por exemplo: docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>".

   shellCopiar

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

3. Persista os dados e dimensione o host

   Mantenha o estado do OpenClaw — ou seja, openclaw.json e o workspace do agente — em um volume nomeado ou bind mount para que ele seja preservado ao recriar e atualizar os contêineres. Reserve pelo menos 6 GB de RAM se você mesmo compilar a imagem; com a imagem pré-construída e modelos na nuvem, o gateway funciona com 1 GB. Dentro de um contêiner, gateway.bind auto é resolvido como 0.0.0.0; portanto, mantenha a autenticação por token ativada.

4. Atualize os contêineres

   Baixe as novas imagens para os serviços do gateway e da CLI e, em seguida, recrie somente o gateway. Sua configuração e seu workspace continuam no volume.

   shellCopiar

   docker compose pull openclaw-gateway openclaw-cli
   docker compose up -d openclaw-gateway

Mais guias do OpenClaw