ClawDock

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

Ela fornece 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

Use o caminho auxiliar canônico:

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

Se você instalou o ClawDock anteriormente a partir de scripts/shell-helpers/clawdock-helpers.sh, reinstale a partir do novo caminho scripts/clawdock/clawdock-helpers.sh. O caminho antigo no GitHub bruto foi removido.

# O que você obtém

# 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	Configurar o token do Gateway dentro do contêiner
clawdock-update	Baixar, reconstruir e reiniciar
clawdock-rebuild	Reconstruir apenas a imagem 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	Imprimir o token do Gateway
clawdock-cd	Ir para o diretório do projeto OpenClaw
clawdock-config	Abrir ~/.openclaw
clawdock-show-config	Imprimir arquivos de configuração com valores ocultados
clawdock-workspace	Abrir o diretório do workspace

# Fluxo da primeira vez

clawdock-start
clawdock-fix-token
clawdock-dashboard

Se o navegador disser que o pareamento é obrigatório:

clawdock-devices
clawdock-approve <request-id>

# Configuração e segredos

O ClawDock funciona com a mesma divisão de configuração do Docker descrita em Docker:

• <project>/.env para valores específicos do Docker, como nome da imagem, portas e o token do Gateway
• ~/.openclaw/.env para chaves de provedores e tokens de bots baseados em env
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json para autenticação OAuth/API-key de provedores armazenada
• ~/.openclaw/openclaw.json para configuração de comportamento

Use clawdock-show-config quando quiser inspecionar rapidamente os arquivos .env e openclaw.json. Ele oculta valores de .env na saída impressa.

# Relacionado