Comandos CLI OpenClaw

Referência completa de todos os comandos do terminal OpenClaw, com exemplos práticos e casos de uso.

💡 Primeira vez? Comece pelo guia de instalação ou veja o tutorial do seu primeiro bot.

📋 Referência Rápida

Use esta tabela para encontrar rapidamente o comando que precisa:

🚀 Workflows Comuns

Primeira Instalação

Se você acabou de instalar o OpenClaw, siga esta sequência:

# 1. Execute o wizard de configuração
openclaw onboard

# 2. Inicie o gateway
openclaw gateway start

# 3. Conecte seu primeiro canal (ex: Telegram)
openclaw channel add telegram --token SEU_TOKEN

# 4. Verifique se tudo está funcionando
openclaw gateway status

Próximo passo: Crie seu primeiro bot

Verificar Se Está Funcionando

Quando você quer saber se o OpenClaw está rodando corretamente:

# Ver status rápido
openclaw gateway status

# Ver logs em tempo real (Ctrl+C para sair)
openclaw gateway logs -f

# Diagnóstico completo de problemas
openclaw doctor

Dica: Se status mostrar tudo OK mas o bot não responde, verifique os logs com -f para ver erros em tempo real.

Reiniciar Após Mudanças

Sempre que alterar a configuração, reinicie:

# Opção 1: Restart direto
openclaw gateway restart

# Opção 2: Para + Inicia (útil para debug)
openclaw gateway stop
openclaw gateway start -v  # -v mostra mais detalhes

📡 Comandos Gateway

O gateway é o “coração” do OpenClaw — é ele que mantém seu bot funcionando.

gateway start

Inicia o gateway OpenClaw.

# Iniciar normalmente
openclaw gateway start

# Iniciar com logs detalhados (debug)
openclaw gateway start -v

# Iniciar em background (servidor)
openclaw gateway start --daemon

Quando usar: Toda vez que quiser ligar seu bot.

gateway stop

Para o gateway de forma segura.

openclaw gateway stop

Quando usar: Antes de atualizar, editar configuração, ou desligar o computador.

gateway restart

Reinicia o gateway (equivalente a stop + start).

openclaw gateway restart

Quando usar: Após qualquer mudança na configuração.

gateway status

Mostra se o gateway está rodando e informações básicas.

# Status simples
openclaw gateway status

# Status em JSON (para scripts)
openclaw gateway status --json

O que esperar:

• ✅ Gateway rodando, canais conectados = tudo OK
• ⚠️ Gateway rodando, canais desconectados = verificar canais
• ❌ Gateway parado = iniciar com gateway start

gateway logs

Visualiza os logs do gateway.

# Últimas 50 linhas
openclaw gateway logs

# Últimas 100 linhas
openclaw gateway logs -n 100

# Logs em tempo real (Ctrl+C para sair)
openclaw gateway logs -f

# Filtrar apenas erros
openclaw gateway logs | grep -i error

Quando usar: Para diagnosticar problemas ou verificar atividade do bot.

Veja também: Troubleshooting comum

📱 Comandos de Canal

Canais são as plataformas onde seu bot conversa (WhatsApp, Telegram, Discord, etc.).

channel list

Lista todos os canais configurados.

openclaw channel list

channel add

Adiciona um novo canal de comunicação.

# WhatsApp (vai pedir QR code)
openclaw channel add whatsapp

# Telegram (precisa do token do BotFather)
openclaw channel add telegram --token 123456:ABC-DEF...

# Discord
openclaw channel add discord --token SEU_TOKEN_DISCORD

Tutorial completo: Veja os guias específicos para cada plataforma em Plataformas.

channel remove

Remove um canal configurado.

openclaw channel remove whatsapp
openclaw channel remove telegram

Atenção: Isso desconecta o canal permanentemente. Para reconectar, use channel add novamente.

channel reconnect

Reconecta um canal que perdeu conexão.

openclaw channel reconnect whatsapp

Quando usar: Se o bot parou de responder em um canal específico mas o gateway está funcionando.

channel status

Mostra status detalhado de todos os canais.

openclaw channel status

O que verificar:

• connected: true = funcionando
• connected: false = precisa reconectar

🔄 Comandos de Atualização

update

Atualiza o OpenClaw para a versão mais recente.

# Atualizar para última versão estável
openclaw update

# Atualizar para canal beta (recursos novos)
openclaw update --channel beta

# Ver versão atual antes de atualizar
openclaw --version

Boa prática: Sempre pare o gateway antes de atualizar:

openclaw gateway stop
openclaw update
openclaw gateway start

🔧 Comandos de Diagnóstico

doctor

Executa verificação completa do sistema.

openclaw doctor

O que ele verifica:

• Configuração válida
• Dependências instaladas
• Conexão com APIs
• Permissões de arquivos
• Portas disponíveis

Quando usar: Sempre que algo não funcionar como esperado.

config validate

Verifica se a configuração está correta.

openclaw config validate

Erros comuns:

• Token inválido
• YAML mal formatado
• Campos obrigatórios faltando

test-model

Testa conexão com o modelo de IA.

openclaw test-model

Quando usar: Se o bot conecta mas não responde mensagens.

⚙️ Comandos de Configuração

config edit

Abre a configuração no editor de texto.

openclaw config edit

Dica: Após editar, sempre valide e reinicie:

openclaw config validate
openclaw gateway restart

config show

Mostra a configuração atual (sem dados sensíveis).

openclaw config show

config reset

Reseta a configuração para os valores padrão.

openclaw config reset

Atenção: Isso apaga todas as suas configurações! Use apenas se quiser recomeçar do zero.

💡 Dicas Avançadas

Ajuda Rápida

Todo comando tem documentação embutida:

# Ajuda geral
openclaw --help

# Ajuda de um comando específico
openclaw gateway --help
openclaw channel --help

Modo Verbose

Adicione -v para ver mais detalhes:

openclaw gateway start -v
openclaw doctor -v

Output JSON

Para integrar com scripts:

openclaw status --json
openclaw channel list --json

Alias Úteis

Adicione ao seu .bashrc ou .zshrc:

alias ocstart="openclaw gateway start"
alias ocstop="openclaw gateway stop"
alias ocstatus="openclaw gateway status"
alias oclogs="openclaw gateway logs -f"

🔗 Próximos Passos

• Novo usuário? Guia de instalação completo
• Quer criar um bot? Tutorial do primeiro bot
• Problemas? Troubleshooting
• Quer automatizar? Guia de agendamentos (cron)
• Configuração avançada? Documentação de agents

Veja também a referência técnica completa da API CLI para desenvolvedores.