Pular para o conteúdo principal

ClawDock

ClawDock é uma pequena camada de helpers de shell para instalações do OpenClaw baseadas em Docker. Ele 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 canônico do helper:
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 antigo caminho raw do GitHub foi removido.

O que você recebe

Operações básicas

CommandDescription
clawdock-startInicia o gateway
clawdock-stopPara o gateway
clawdock-restartReinicia o gateway
clawdock-statusVerifica o status do contêiner
clawdock-logsAcompanha os logs do gateway

Acesso ao contêiner

CommandDescription
clawdock-shellAbre um shell dentro do contêiner do gateway
clawdock-cli <command>Executa comandos da CLI do OpenClaw no Docker
clawdock-exec <command>Executa um comando arbitrário no contêiner

Interface web e pareamento

CommandDescription
clawdock-dashboardAbre a URL da interface de Control
clawdock-devicesLista pareamentos de dispositivo pendentes
clawdock-approve <id>Aprova uma solicitação de pareamento

Configuração e manutenção

CommandDescription
clawdock-fix-tokenConfigura o token do gateway dentro do contêiner
clawdock-updateFaz pull, rebuild e restart
clawdock-rebuildRecompila apenas a imagem Docker
clawdock-cleanRemove contêineres e volumes

Utilitários

CommandDescription
clawdock-healthExecuta uma verificação de integridade do gateway
clawdock-tokenImprime o token do gateway
clawdock-cdVai para o diretório do projeto OpenClaw
clawdock-configAbre ~/.openclaw
clawdock-show-configImprime arquivos de configuração com valores redigidos
clawdock-workspaceAbre o diretório do workspace

Fluxo da primeira vez

clawdock-start
clawdock-fix-token
clawdock-dashboard
Se o navegador disser que o pareamento é necessá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 provedor e tokens de bot baseados em env
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json para autenticação OAuth/chave de API de provedor armazenada
  • ~/.openclaw/openclaw.json para configuração de comportamento
Use clawdock-show-config quando quiser inspecionar rapidamente os arquivos .env e openclaw.json. Ele redige valores de .env na saída impressa.

Páginas relacionadas