Comandos CLI do PetClaw

Esta página foca nos comandos reais que você executa com petclaw.

Nota: a documentação upstream ainda pode mostrar openclaw ...; neste projeto, em geral você pode ler isso como petclaw ....

Os 5 comandos mais usados

| Comando | Objetivo | Quando usar | |---|---|---| | petclaw --version | Verificar a versão do runtime | Validar a instalação | | petclaw health | Verificar a saúde do gateway local | Quando o app não consegue se conectar | | petclaw gateway | Iniciar o gateway local | Quando o serviço não está em execução | | petclaw dashboard --no-open | Imprimir a URL do painel com token | Depurar acesso ao painel | | petclaw channels login --channel whatsapp | Iniciar o login do WhatsApp | Configurar o login do canal |

Inicialização e verificações básicas

petclaw --version
petclaw health
petclaw status
  • --version: confirma a instalação do runtime
  • health: confirma que o gateway está respondendo
  • status: mostra um status global mais legível

Comandos do gateway

petclaw gateway
petclaw gateway run
petclaw gateway status
petclaw gateway health
petclaw gateway probe
petclaw gateway discover
petclaw gateway call <method>

Use esses comandos para iniciar o gateway, inspecionar o status, testar a conectividade e chamar métodos RPC manualmente.

Comandos de painel e sessão

petclaw dashboard --no-open
petclaw sessions
petclaw sessions cleanup

dashboard --no-open imprime uma URL do painel com token. sessions ajuda a inspecionar ou limpar os dados de sessão.

Comandos de canais

petclaw channels list
petclaw channels status
petclaw channels add
petclaw channels remove
petclaw channels login --channel whatsapp
petclaw channels logout

Use channels para gerenciar a configuração dos canais e o estado de login.

Configuração e diagnóstico

petclaw setup
petclaw onboard
petclaw configure
petclaw config
petclaw doctor
petclaw backup
petclaw reset
  • setup: inicializa a configuração local e o workspace
  • onboard: executa o fluxo inicial de configuração
  • configure: configuração interativa
  • config: inspeciona ou valida a configuração
  • doctor: executa diagnósticos e sugere correções
  • backup: faz backup do estado local
  • reset: redefine o estado local

Outros grupos de comandos úteis

| Grupo de comandos | Objetivo | |---|---| | logs | Ler logs do gateway | | models | Descobrir e configurar modelos | | approvals | Gerenciar aprovações de execução | | devices | Emparelhar dispositivos e gerenciar tokens | | plugins | Gerenciar plugins e extensões | | skills | Inspecionar habilidades disponíveis | | docs | Pesquisar a documentação do OpenClaw | | update | Atualizar o runtime / OpenClaw |

Ordem recomendada de troubleshooting

petclaw --version
petclaw health
petclaw gateway
petclaw dashboard --no-open
petclaw channels status
petclaw channels login --channel whatsapp
Comandos CLI do PetClaw