OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Containers

ClawDock

ClawDock é uma pequena camada de utilitários de shell para instalações do OpenClaw baseadas em Docker.

Ela oferece comandos curtos como clawdock-start, clawdock-dashboard e clawdock-fix-token em vez de invocações mais longas de docker compose ....

Se você ainda não configurou o Docker, comece por Docker.

Instalação

bash
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

Se você instalou anteriormente o ClawDock a partir de scripts/shell-helpers/clawdock-helpers.sh, reinstale-o usando o caminho atual scripts/clawdock/clawdock-helpers.sh; o caminho antigo de conteúdo bruto do GitHub foi removido.

Os utilitários detectam automaticamente seu checkout do OpenClaw no primeiro uso (verificando caminhos comuns, como ~/openclaw e ~/projects/openclaw) e armazenam o resultado em cache em ~/.clawdock/config. Defina CLAWDOCK_DIR manualmente se seu checkout estiver em outro local.

O que está incluído

Operações básicas

Comando Descrição
clawdock-start Iniciar o Gateway
clawdock-stop Parar o Gateway
clawdock-restart Reiniciar o Gateway
clawdock-status Verificar o status do contêiner
clawdock-logs Acompanhar os logs do Gateway

Acesso ao contêiner

Comando Descrição
clawdock-shell Abrir um shell dentro do contêiner do Gateway
clawdock-cli <command> Executar comandos da CLI do OpenClaw no Docker
clawdock-exec <command> Executar um comando arbitrário no contêiner

Interface web e pareamento

Comando Descrição
clawdock-dashboard Abrir a URL da interface de controle
clawdock-devices Listar pareamentos de dispositivos pendentes
clawdock-approve <id> Aprovar uma solicitação de pareamento

Configuração e manutenção

Comando Descrição
clawdock-fix-token Gravar o token do Gateway na configuração do contêiner
clawdock-update Baixar, recompilar e reiniciar
clawdock-rebuild Recompilar somente a imagem do Docker
clawdock-clean Remover contêineres e volumes

Utilitários

Comando Descrição
clawdock-health Executar uma verificação de integridade do Gateway
clawdock-token Exibir o token do Gateway
clawdock-cd Ir para o diretório do projeto OpenClaw
clawdock-config Abrir ~/.openclaw
clawdock-show-config Exibir arquivos de configuração com valores ocultados
clawdock-workspace Abrir o diretório do espaço de trabalho
clawdock-help Listar todos os comandos do ClawDock

Fluxo inicial

bash
clawdock-startclawdock-fix-tokenclawdock-dashboard

Se o navegador informar que o pareamento é necessário:

bash
clawdock-devicesclawdock-approve <request-id>

Configuração e segredos

O ClawDock lê dois arquivos .env separados, de acordo com a divisão descrita em Docker:

  • O .env do projeto ao lado de docker-compose.yml: valores específicos do Docker, como nome da imagem, portas e OPENCLAW_GATEWAY_TOKEN. clawdock-token lê o token desse arquivo.
  • ~/.openclaw/.env (montado no contêiner): segredos provenientes de variáveis de ambiente gerenciados pelo próprio OpenClaw, junto com openclaw.json e agents/<agentId>/agent/auth-profiles.json.

clawdock-fix-token copia o token do .env do projeto para os valores de configuração gateway.remote.token e gateway.auth.token do contêiner e reinicia o Gateway.

Use clawdock-show-config para inspecionar rapidamente o openclaw.json e ambos os arquivos .env; ele oculta os valores de .env na saída exibida.

Relacionados

Docker

Instalação canônica do OpenClaw com Docker.
Ambiente de execução de VM do Docker

Ambiente de execução de VM gerenciado pelo Docker para isolamento reforçado.
Atualização

Atualização do pacote OpenClaw e dos serviços gerenciados.
Was this useful?
On this page

On this page