🦞 OpenClaw Docker Kit

Idioma: Português | English

Kit simples para rodar o OpenClaw localmente com Docker, sem clonar o repositório oficial.

⚙️ Pré-requisitos

• Docker Desktop ou Podman com suporte a Compose
• Um provedor de modelo de IA (pago ou local): OpenAI, Anthropic, OpenRouter, Ollama, etc.

Windows

No Windows, o cenário ideal é ter Docker Desktop ou Podman Desktop com WSL 2 habilitado. Com isso, você já terá bash disponível (via WSL) por padrão.

Resumo de requisitos:

• Docker Desktop ou Podman Desktop: runtime de containers suportado
• WSL2 diretamente: qualquer distro WSL2 com bash (recomendado)
• Git for Windows: alternativa para usar Git Bash

Caso não queira usar bash, os arquivos start.ps1 e stop.ps1 executam os scripts .sh via wsl/bash automaticamente.

▶️ Primeira execução

Abra o Terminal ou PowerShell na pasta deste kit e execute:

macOS/Linux:

./start.sh

Windows PowerShell:

.\start.ps1

Se o PowerShell bloquear a execução, rode:

powershell -ExecutionPolicy Bypass -File .\start.ps1

O script configura tudo automaticamente: cria o .env, constrói a imagem local, roda o onboarding interativo e abre a Control UI no navegador.

Durante o onboarding, configure o provedor/modelo e os canais desejados. Se usar um provedor pago, a chave de API será pedida nessa etapa — ou você pode adicioná-la depois no .env:

ANTHROPIC_API_KEY=...
# ou
OPENAI_API_KEY=...

📋 Uso diário

Ação	macOS/Linux	Windows PowerShell
Iniciar	./start.sh	.\start.ps1
Parar	./stop.sh	.\stop.ps1
Parar e resetar tudo	./stop.sh --reset	.\stop.ps1 -Reset
Reconfigurar	./start.sh --onboard	.\start.ps1 -Onboard

🌐 Acesso

http://127.0.0.1:18789/

Se pedir token:

grep OPENCLAW_GATEWAY_TOKEN .env

Windows PowerShell:

Select-String OPENCLAW_GATEWAY_TOKEN .env

♻️ Reset completo

./stop.sh --reset
./start.sh

Windows PowerShell:

.\stop.ps1 -Reset
.\start.ps1

💾 Backup e Restauração

Faça backup da configuração (canais, históricos, settings) do OpenClaw:

Backup (macOS/Linux/Windows):

./backup.sh      # ou .\backup.ps1 no Windows
# Arquivo salvo em: ./backups/openclaw_backup_YYYYMMDD-HHMM.tar.gz

Restaurar (macOS/Linux/Windows):

./restore.sh              # lista backups disponíveis
./restore.sh <caminho>    # restaura arquivo específico
# ou no Windows: .\restore.ps1

Os scripts param o container automaticamente durante a operação e o reiniciam ao final.

🧱 Personalização via .env

O Dockerfile estende a imagem oficial para instalar dependências persistentes. Edite o .env para personalizar conforme necessário:

# Imagem base oficial fixada por tag
OPENCLAW_BASE_IMAGE=ghcr.io/openclaw/openclaw:<versao>

# Pacotes apt extras (separados por espaço)
OPENCLAW_APT_PACKAGES=

# Gerenciadores de pacotes (instalados automaticamente se preenchidos)
OPENCLAW_BREW_PACKAGES=
OPENCLAW_PNPM_PACKAGES=
OPENCLAW_BUN_PACKAGES=

# Browser: agent-browser (padrão), chromium, ou vazio para nenhum
OPENCLAW_INSTALL_BROWSER=agent-browser

agent-browser — instala o browser com suporte nativo ao Agent Browser e registra a skill correspondente automaticamente ao iniciar.

Em Linux ARM64, o kit usa Chromium do sistema automaticamente, porque o agent-browser install não tem binários Chrome for Testing para essa arquitetura.

chromium — instala o Chromium via Playwright (útil para automações com Playwright).

Para forçar o rebuild da imagem (ex: após mudar variáveis de pacotes):

./start.sh --build

Windows PowerShell:

.\start.ps1 -Build

🔄 Atualização da imagem base

Para atualizar para uma nova versão do OpenClaw:

1. Edite OPENCLAW_BASE_IMAGE no .env com a nova tag.
2. Rode ./start.sh — o rebuild acontece automaticamente.
3. Valide o onboarding e a Control UI.

A imagem local usa a tag padrão openclaw-dk:local. Para forçar uma tag diferente, defina OPENCLAW_IMAGE no .env.

🔒 Observações

• os dados (configuração, credenciais, workspace) ficam em um volume Docker isolado do filesystem do host
• o kit cria/atualiza automaticamente /home/node/.openclaw/workspace/AGENTS.md no volume persistente para orientar agents sobre o que não persiste após restart
• guarde o .env em local seguro; ele contém o token do gateway e eventuais chaves de API
• no Windows, use PowerShell; não é necessário abrir WSL
• se algum .sh der Permission denied, rode chmod +x start.sh stop.sh
• por padrão, Docker e Podman são detectados automaticamente; para forçar um: OPENCLAW_ENGINE=docker ./start.sh
• site oficial: https://openclaw.ai
• releases oficiais: https://github.com/openclaw/openclaw/releases
• documentação oficial: https://docs.openclaw.ai/install/docker