openclaw é o principal ponto de entrada da CLI. Cada comando principal tem uma
página de referência dedicada ou é documentado junto ao comando do qual é alias; este
índice lista os comandos, as flags globais e as regras de estilo de saída que
se aplicam a toda a CLI.
Use os comandos de configuração conforme a intenção:
openclaw setupcria a configuração e o workspace básicos sem passar por todo o fluxo guiado de onboarding.openclaw onboardé o caminho guiado completo de primeira execução para Gateway, autenticação de modelo, workspace, canais, Skills e integridade.openclaw configurealtera partes específicas de uma configuração existente, como autenticação de modelo, Gateway, canais, plugins ou Skills.openclaw channels addconfigura contas de canal depois que a base existe; execute sem flags para configuração guiada de canais ou com flags específicas do canal para scripts.
Páginas de comandos
| Área | Comandos |
|---|---|
| Configuração e onboarding | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Redefinição e desinstalação | backup · reset · uninstall · update |
| Mensagens e agentes | message · agent · agents · acp · mcp |
| Integridade e sessões | status · health · sessions |
| Gateway e logs | gateway · logs · system |
| Modelos e inferência | models · infer · capability (alias para infer) · memory · commitments · wiki |
| Rede e nós | directory · nodes · devices · node |
| Runtime e sandbox | approvals · exec-policy (veja approvals) · sandbox · tui · chat/terminal (aliases para tui --local) · browser |
| Automação | cron · tasks · hooks · webhooks · transcripts |
| Descoberta e documentação | dns · docs |
| Pareamento e canais | pairing · qr · channels |
| Segurança e plugins | security · secrets · skills · plugins · proxy |
| Aliases legados | daemon (serviço de Gateway) · clawbot (namespace) |
| Plugins (opcional) | path · policy · voicecall · workboard (se instalado) |
Flags globais
| Flag | Finalidade |
|---|---|
--dev | Isola o estado em ~/.openclaw-dev e desloca as portas padrão |
--profile <name> | Isola o estado em ~/.openclaw-<name> |
--container <name> | Direciona a execução para um contêiner nomeado |
--no-color | Desabilita cores ANSI (NO_COLOR=1 também é respeitado) |
--update | Atalho para openclaw update (somente instalações a partir do código-fonte) |
-V, --version, -v | Imprime a versão e sai |
Modos de saída
- Cores ANSI e indicadores de progresso são renderizados apenas em sessões TTY.
- Hiperlinks OSC-8 são renderizados como links clicáveis onde houver suporte; caso contrário, a CLI usa URLs simples como fallback.
--json(e--plainonde houver suporte) desabilita o estilo para uma saída limpa.- Comandos de longa duração mostram um indicador de progresso (OSC 9;4 quando houver suporte).
src/terminal/palette.ts.
Árvore de comandos
Full command tree
Full command tree
openclaw workboard ou openclaw voicecall.Comandos de barra no chat
Mensagens de chat dão suporte a comandos/.... Veja comandos de barra.
Destaques:
/status— diagnóstico rápido./trace— linhas de trace/debug de plugin no escopo da sessão./config— alterações persistidas de configuração./debug— sobrescritas de configuração apenas em runtime (memória, não disco; exigecommands.debug: true).
Rastreamento de uso
openclaw status --usage e a Control UI expõem uso/cota do provedor quando
credenciais OAuth/API estão disponíveis. Os dados vêm diretamente dos endpoints de uso
do provedor e são normalizados para X% left. Provedores com janelas de uso
atuais: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax,
Xiaomi e z.ai.
Veja Rastreamento de uso para obter detalhes.