Comandos abrangentes do OpenClaw para gerir o seu agente de IA pessoal em multiplos canais de mensagens e plataformas.
| Plataforma | Comando |
|---|
| macOS/Linux | curl -fsSL https://openclaw.ai/install.sh | bash |
| npm (global) | npm install -g openclaw |
| Atualizar | openclaw update |
| Verificar | openclaw --version |
| Comando | Descricao |
|---|
openclaw onboard | Assistente de configuracao interativo para gateway, espaco de trabalho, canais e habilidades |
openclaw onboard --install-daemon | Configurar e instalar gateway como servico em segundo plano |
openclaw onboard --flow quickstart | Configuracao rapida com valores padrao sensatos |
openclaw onboard --flow advanced | Configuracao completa com todas as opcoes |
openclaw onboard --non-interactive | Configuracao sem interface (requer flags explicitas) |
openclaw setup --workspace ~/my-agent | Inicializar configuracao e diretorio do espaco de trabalho |
openclaw configure | Assistente interativo para modelos, canais, habilidades e gateway |
openclaw doctor | Verificacoes de saude e correcoes rapidas para configuracao e gateway |
openclaw doctor --deep | Verificacao profunda incluindo servicos do sistema |
openclaw reset --scope config | Redefinir apenas a configuracao |
openclaw reset --scope full --yes | Redefinicao completa de configuracao, credenciais e sessoes |
| Comando | Descricao |
|---|
openclaw config get <path> | Exibir um valor de configuracao |
openclaw config set <path> <value> | Definir um valor de configuracao (JSON5 ou string) |
openclaw config unset <path> | Remover um valor de configuracao |
openclaw configure | Iniciar assistente de configuracao interativo |
| Variavel | Finalidade |
|---|
OPENCLAW_HOME | Substituir diretorio padrao |
OPENCLAW_STATE_DIR | Diretorio de estado personalizado |
OPENCLAW_CONFIG_PATH | Caminho personalizado do ficheiro de configuracao |
| Comando | Descricao |
|---|
openclaw gateway run | Executar Gateway WebSocket em primeiro plano |
openclaw gateway run --port 18789 | Executar gateway numa porta especifica |
openclaw gateway run --bind lan | Vincular a interface LAN |
openclaw gateway run --bind tailnet | Vincular via Tailscale |
openclaw gateway status | Verificar estado do gateway via RPC |
openclaw gateway health | Obter estado de saude do gateway em execucao |
openclaw gateway install | Instalar gateway como servico do sistema |
openclaw gateway start | Iniciar servico instalado |
openclaw gateway stop | Parar servico em execucao |
openclaw gateway restart | Reiniciar servico |
openclaw gateway uninstall | Remover servico |
openclaw gateway discover | Descobrir gateways na rede |
openclaw logs --follow | Acompanhar logs do gateway em tempo real |
openclaw logs --limit 100 --json | Ultimas 100 entradas de log em JSON |
| Comando | Descricao |
|---|
openclaw channels list | Mostrar todos os canais configurados e perfis de autenticacao |
openclaw channels status | Verificar acessibilidade do gateway e saude dos canais |
openclaw channels add --channel telegram | Adicionar canal Telegram |
openclaw channels add --channel whatsapp | Adicionar canal WhatsApp |
openclaw channels add --channel discord | Adicionar canal Discord |
openclaw channels add --channel slack | Adicionar canal Slack |
openclaw channels add --channel signal | Adicionar canal Signal |
openclaw channels add --channel imessage | Adicionar canal iMessage |
openclaw channels add --channel msteams | Adicionar canal Microsoft Teams |
openclaw channels remove --channel telegram | Remover um canal |
openclaw channels login --channel discord | Login interativo no canal |
openclaw channels logout --channel telegram | Sair do canal |
openclaw channels logs --channel whatsapp | Mostrar logs recentes do canal |
| Comando | Descricao |
|---|
openclaw message send --text "Hello" | Enviar uma mensagem |
openclaw message send --to user123 --text "Hi" | Enviar para destino especifico |
openclaw message poll | Buscar novas mensagens |
openclaw message read | Marcar mensagens como lidas |
openclaw message edit --text "Updated" | Editar mensagem enviada |
openclaw message delete | Apagar uma mensagem |
openclaw message react --emoji "\U0001f44d" | Reagir a uma mensagem |
openclaw message reactions | Listar reacoes de uma mensagem |
openclaw message search --text "query" | Pesquisar mensagens |
openclaw message pin | Fixar uma mensagem |
openclaw message unpin | Desafixar uma mensagem |
openclaw message pins | Listar mensagens fixadas |
openclaw message thread create | Criar thread de mensagens |
openclaw message thread list | Listar threads |
openclaw message thread reply | Responder numa thread |
| Comando | Descricao |
|---|
openclaw agent --message "Research this topic" | Executar turno unico do agente via gateway |
openclaw agent --message "Hello" --thinking high | Turno do agente com raciocinio aprofundado |
openclaw agent --message "task" --local | Executar agente localmente (incorporado) |
openclaw agent --message "task" --deliver | Entregar resposta ao canal |
openclaw agents list | Listar agentes configurados |
openclaw agents add myagent --workspace ~/work | Adicionar agente isolado com espaco de trabalho |
openclaw agents add myagent --model claude-sonnet | Adicionar agente com modelo especifico |
openclaw agents delete myagent --force | Apagar um agente |
| Comando | Descricao |
|---|
openclaw models list | Listar modelos disponiveis |
openclaw models list --all | Listar todos os modelos incluindo indisponiveis |
openclaw models list --local | Listar apenas modelos locais |
openclaw models list --provider anthropic | Filtrar por provedor |
openclaw models status | Mostrar estado de tokens e autenticacao |
openclaw models status --probe | Verificacao ao vivo de perfis de autenticacao |
openclaw models set claude-sonnet | Definir modelo principal |
openclaw models set-image dall-e-3 | Definir modelo de imagem principal |
openclaw models scan | Escanear e descobrir modelos disponiveis |
openclaw models auth add | Assistente interativo de autenticacao |
openclaw models auth setup-token --provider openai | Configurar token do provedor |
openclaw models fallbacks add gpt-4o | Adicionar modelo de reserva |
openclaw models fallbacks list | Listar modelos de reserva |
openclaw models aliases add sonnet claude-sonnet | Criar alias de modelo |
| Comando | Descricao |
|---|
openclaw browser start | Iniciar navegador controlado |
openclaw browser stop | Fechar navegador |
openclaw browser status | Verificar estado do navegador |
openclaw browser open "https://example.com" | Abrir URL no navegador |
openclaw browser tabs | Listar separadores abertos |
openclaw browser focus <targetId> | Focar num separador especifico |
openclaw browser close <targetId> | Fechar separador especifico |
openclaw browser screenshot | Capturar ecra da viewport |
openclaw browser screenshot --full-page | Capturar ecra da pagina completa |
openclaw browser snapshot --format aria | Obter arvore de acessibilidade |
openclaw browser navigate "https://url" | Navegar para URL |
openclaw browser click <ref> | Clicar num elemento |
openclaw browser type <ref> "text" | Digitar texto num elemento |
openclaw browser press Enter | Pressionar tecla do teclado |
openclaw browser evaluate --fn "document.title" | Executar JavaScript |
openclaw browser pdf | Gerar PDF da pagina atual |
openclaw browser profiles | Listar perfis do navegador |
openclaw browser create-profile --name work | Criar perfil do navegador |
| Comando | Descricao |
|---|
openclaw node run --host gateway.local --port 18789 | Executar no sem interface |
openclaw node install --host gw.local | Instalar no como servico |
openclaw node status | Verificar estado do no |
openclaw nodes list | Listar todos os nos |
openclaw nodes status --connected | Mostrar apenas nos conectados |
openclaw nodes pending | Mostrar pedidos de aprovacao pendentes |
openclaw nodes approve <requestId> | Aprovar pedido de no |
openclaw nodes run --node mypc "ls -la" | Executar comando num no remoto |
openclaw nodes camera snap --node phone | Capturar imagem da camara |
openclaw nodes screen record --node desktop | Gravar ecra |
openclaw nodes location get --node mobile | Obter localizacao do dispositivo |
| Comando | Descricao |
|---|
openclaw cron list | Listar todas as tarefas agendadas |
openclaw cron status | Mostrar estado do sistema cron |
openclaw cron add --name "Daily report" --every 24h --message "Generate daily report" | Adicionar tarefa recorrente |
openclaw cron add --name "Morning brief" --at "08:00" --message "Brief me" | Adicionar tarefa baseada em horario |
openclaw cron add --name "Backup" --cron "0 2 * * *" --system-event "run backup" | Adicionar tarefa com expressao cron |
openclaw cron enable <id> | Ativar uma tarefa |
openclaw cron disable <id> | Desativar uma tarefa |
openclaw cron run <id> | Executar tarefa imediatamente |
openclaw cron runs --id <id> | Mostrar historico de execucoes |
openclaw cron edit <id> | Modificar tarefa existente |
openclaw cron rm <id> | Apagar uma tarefa |
| Comando | Descricao |
|---|
openclaw plugins list | Descobrir plugins disponiveis |
openclaw plugins info <id> | Mostrar detalhes do plugin |
openclaw plugins install <path> | Instalar plugin a partir de caminho ou npm |
openclaw plugins enable <id> | Ativar um plugin |
openclaw plugins disable <id> | Desativar um plugin |
openclaw plugins doctor | Reportar erros de carregamento de plugins |
openclaw skills list | Listar habilidades disponiveis |
openclaw skills list --eligible | Mostrar apenas habilidades prontas |
openclaw skills info <name> | Mostrar detalhes da habilidade |
openclaw skills check | Resumo de prontidao de todas as habilidades |
| Comando | Descricao |
|---|
openclaw security audit | Auditar configuracao e estado local |
openclaw security audit --deep | Verificacao de seguranca ao vivo do gateway |
openclaw security audit --fix | Corrigir automaticamente valores padrao seguros |
openclaw approvals get | Ver configuracoes de aprovacao atuais |
openclaw approvals set | Configurar fluxos de aprovacao |
openclaw approvals allowlist add | Adicionar a lista de permissoes |
openclaw pairing list telegram | Listar pedidos de emparelhamento pendentes |
openclaw pairing approve telegram <code> | Aprovar emparelhamento de DM |
| Comando | Descricao |
|---|
openclaw memory status | Mostrar estatisticas do indice de memoria |
openclaw memory index | Reindexar ficheiros de memoria |
openclaw memory search "query" | Pesquisa semantica na memoria |
openclaw sessions | Listar sessoes de conversa armazenadas |
openclaw sessions --active 60 | Mostrar sessoes ativas nos ultimos 60 min |
openclaw status | Mostrar saude da sessao vinculada |
openclaw status --all --deep | Diagnostico completo com verificacao de canais |
# Instalar e configurar
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
# Adicionar canal Telegram
openclaw channels add --channel telegram
# Verificar que tudo funciona
openclaw doctor
openclaw status --all
# Definir modelo preferido
openclaw models set claude-sonnet
# Adicionar modelo de reserva
openclaw models fallbacks add gpt-4o
# Executar turno do agente
openclaw agent --message "Summarize my emails" --thinking high
# Criar tarefa diaria as 8h
openclaw cron add \
--name "Morning briefing" \
--at "08:00" \
--message "Give me a summary of today's tasks and any urgent notifications"
# Verificar que esta agendada
openclaw cron list
# Listar nos conectados
openclaw nodes status --connected
# Executar comando em maquina remota
openclaw nodes run --node "desktop" "df -h"
# Capturar ecra de maquina remota
openclaw nodes screen record --node "desktop" --duration 5s
- Use
--install-daemon durante a configuracao inicial para executar o gateway como servico em segundo plano
- Execute
openclaw doctor regularmente para detetar problemas de configuracao cedo
- Defina modelos de reserva para garantir disponibilidade quando o modelo principal estiver com limite de taxa
- Use
--thinking high para tarefas de agente complexas que exigem raciocinio profundo
- Crie perfis de navegador para isolar contextos de navegacao para diferentes tarefas
- Use a flag
--json ao criar scripts ou encaminhar saida para outras ferramentas
- Execute auditorias de seguranca com a flag
--deep antes de expor o gateway a rede
| Problema | Solucao |
|---|
| Gateway nao inicia | Execute openclaw doctor --deep para diagnosticar |
| Canal desconectado | Verifique com openclaw channels status e depois faca login novamente |
| Falha na autenticacao do modelo | Execute openclaw models status --probe para testar tokens |
| Erro ao carregar plugin | Execute openclaw plugins doctor para diagnostico |
| No nao conecta | Verifique com openclaw nodes pending e aprove se necessario |
| Respostas lentas | Verifique openclaw status --usage para limites de taxa |
| Configuracao corrompida | Use openclaw reset --scope config para redefinir com seguranca |
