---
title: "Comandos CLI do OpenClaw — Terminal"
url: "https://openclaw.ia.br/api/cli/"
markdown_url: "https://openclaw.ia.br/api/cli.MD"
description: "Guia completo de todos os comandos da linha de comando do OpenClaw. Automatize, configure e controle seu assistente IA via terminal."
date: ""
author: ""
---

# Comandos CLI do OpenClaw — Terminal

Guia completo de todos os comandos da linha de comando do OpenClaw. Automatize, configure e controle seu assistente IA via terminal.


# 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

```bash
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.

```bash
# 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 `config.yaml`.

##  Channel — Canais de Comunicação

Gerencie conexões com Telegram, WhatsApp, Discord e outros.

```bash
# 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](/canais/)

##  Auth — Autenticação de Provedores

Configure suas chaves de API para modelos de IA.

```bash
# 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](/modelos/)

##  Skill — Extensões e Plugins

Instale e gerencie funcionalidades extras.

```bash
# 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](/api/skills-dev/)

##  Agent — Interação Direta

Converse com o agente direto do terminal.

```bash
# 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.

```bash
# 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

```bash
#!/bin/bash
cp ~/.openclaw/config.yaml ~/.openclaw/backup-$(date +%Y%m%d).yaml
openclaw gateway restart
openclaw status
```

### Health check para cron

```bash
#!/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](/api/rest/) — Para integrações HTTP
- [WebSocket](/api/websocket/) — Para streaming em tempo real
- [Configuração](/api/config/) — Referência completa do config