Comandos CLI do OpenClaw
Comandos CLI do OpenClaw
O CLI do OpenClaw oferece controle total sobre seu assistente via terminal. Ideal para automação, scripts e usuários que preferem a linha de comando.
🎯 Sintaxe Básica
openclaw [comando] [subcomando] [opções]
Dica: Use openclaw --help ou openclaw [comando] --help para ver todas as opções disponíveis.
🖥️ Gateway — Gerenciamento do Servidor
O Gateway é o coração do OpenClaw. Todos os canais e APIs dependem dele.
# Verificar status atual
openclaw gateway status
# Iniciar o gateway
openclaw gateway start
# Parar o gateway
openclaw gateway stop
# Reiniciar (útil após mudanças de config)
openclaw gateway restart
# Iniciar com porta personalizada
openclaw gateway --port 18789
# Modo verboso para debug
openclaw gateway --verbose
Quando usar: Sempre que precisar iniciar/parar o serviço ou após editar clawdbot.json.
📡 Channel — Canais de Comunicação
Gerencie conexões com Telegram, WhatsApp, Discord e outros.
# Adicionar novo canal (wizard interativo)
openclaw channel add telegram
# Listar canais configurados
openclaw channel list
# Ver status de um canal específico
openclaw channel status telegram
# Reconectar canal com problemas
openclaw channel reconnect telegram
# Remover canal
openclaw channel remove telegram
Veja também: Configuração de Canais
🔑 Auth — Autenticação de Provedores
Configure suas chaves de API para modelos de IA.
# Adicionar novo provider (wizard interativo)
openclaw auth add anthropic
# Listar providers configurados
openclaw auth list
# Testar conexão com provider
openclaw auth test anthropic
# Remover provider
openclaw auth remove anthropic
Providers suportados: anthropic, openai, google, ollama
Veja também: Modelos de IA
🧩 Skill — Extensões e Plugins
Instale e gerencie funcionalidades extras.
# Instalar skill do registry
openclaw skill install browser-control
# Listar skills instaladas
openclaw skill list
# Atualizar skill específica
openclaw skill update browser-control
# Atualizar todas as skills
openclaw skill update
# Remover skill
openclaw skill remove browser-control
Veja também: Desenvolvimento de Skills
🤖 Agent — Interação Direta
Converse com o agente direto do terminal.
# Enviar mensagem única
openclaw agent --message "Qual a previsão do tempo?"
# Modo interativo (chat contínuo)
openclaw agent --interactive
# Usar modelo específico
openclaw agent --model anthropic/claude-opus-4
# Combinar opções
openclaw agent --interactive --model openai/gpt-4o
Útil para: Testes rápidos, scripts de automação, integração com outras ferramentas.
🛠️ Utilidades
Comandos auxiliares para diagnóstico e configuração.
# Diagnóstico completo do sistema
openclaw doctor
# Status geral (gateway + canais + auth)
openclaw status
# Ver configuração atual
openclaw config get
# Ver valor específico
openclaw config get agents.defaults.model
# Setup inicial (wizard)
openclaw onboard
O que o doctor verifica?
- ✅ Node.js e dependências
- ✅ Configuração válida
- ✅ Conectividade com APIs
- ✅ Permissões de arquivos
- ✅ Portas disponíveis
📝 Exemplos Práticos
Script de backup e restart
#!/bin/bash
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/backup-$(date +%Y%m%d).json
openclaw gateway restart
openclaw status
Health check para cron
#!/bin/bash
if ! openclaw gateway status | grep -q "running"; then
openclaw gateway start
echo "Gateway reiniciado em $(date)" >> /var/log/openclaw.log
fi
🔗 Próximos Passos
- REST API — Para integrações HTTP
- WebSocket — Para streaming em tempo real
- Configuração — Referência completa do config