CLI commands
Configuração
openclaw setup
openclaw setup é o ponto de entrada do agente do sistema. Em um sistema configurado,
openclaw setup sem argumentos abre um chat interativo do OpenClaw. Em um sistema novo, ele
prossegue para a integração guiada. Use -m/--message para uma solicitação ou
--baseline para inicializar as pastas de configuração/espaço de trabalho sem o assistente.
Ordem de roteamento:
- Qualquer opção de integração (
--wizard,--baseline, espaço de trabalho, redefinição, modo não interativo, fluxo, modo, Gateway, daemon, ignorar, importar, remoto ou opções de autenticação) executa a integração exatamente comoopenclaw onboard. -m/--messageou--yesexecuta o agente do sistema.- Sem uma opção de roteamento, um sistema interativo configurado abre o OpenClaw. Um
sistema novo executa a integração. Em um sistema configurado,
--jsonexibe a visão geral do sistema mesmo sem um TTY; uma opção de integração mantém o resumo JSON da integração.
No modo guiado, --workspace <dir> é o espaço de trabalho proposto ao OpenClaw;
ele só é persistido depois que a proposta é aprovada. As configurações básica, clássica e
não interativa persistem o espaço de trabalho fornecido por meio de seus fluxos normais.
A detecção de inferência guiada é executada no host do Gateway no macOS ou Linux. A CLI e o aplicativo para macOS chamam o mesmo detector pertencente ao Gateway, que verifica modelos configurados, logins de CLI compatíveis, variáveis de ambiente de chave de API e modelos do Ollama ou LM Studio já instalados. Os modelos locais nunca são baixados por essa verificação automática; o candidato selecionado deve responder a uma conclusão real antes que a configuração do provedor e do modelo seja salva.
setup aceita os mesmos sinalizadores de integração que openclaw onboard, incluindo
autenticação (--auth-choice, --token, sinalizadores de chave do provedor), Gateway
(--gateway-port, --gateway-bind, --gateway-auth, --install-daemon),
Tailscale (--tailscale), redefinição (--reset, --reset-scope), fluxo
(--flow quickstart|advanced|manual|import) e sinalizadores para ignorar etapas
(--skip-channels, --skip-skills, --skip-bootstrap, --skip-search,
--skip-health, --skip-ui, --skip-hooks). Consulte Integração e
Automação da CLI para obter a referência completa dos sinalizadores e
exemplos não interativos. openclaw onboard --modern continua sendo uma entrada de
compatibilidade para o mesmo assistente do OpenClaw condicionado à inferência.
Opções
| Sinalizador | Descrição |
|---|---|
-m, --message <text> |
Executa uma solicitação do OpenClaw. |
--yes |
Aprova gravações persistentes de configuração para uma solicitação --message. |
--workspace <dir> |
Proposta de espaço de trabalho no modo guiado; persistida diretamente pelas configurações básica, clássica e não interativa. |
--baseline |
Cria pastas básicas de configuração/espaço de trabalho/sessão sem integração. |
--wizard |
Força a integração interativa. |
--non-interactive |
Executa a integração sem prompts. |
--accept-risk |
Reconhece o risco de acesso do agente a todo o sistema; obrigatório com --non-interactive. |
--mode <mode> |
Modo de integração: local ou remote. |
--flow <flow> |
Fluxo de integração: quickstart, advanced, manual ou import. |
--reset |
Redefine a configuração + credenciais + sessões antes da integração (espaço de trabalho somente com --reset-scope full). |
--reset-scope <scope> |
Escopo da redefinição: config, config+creds+sessions ou full. |
--import-from <provider> |
Provedor de migração a ser executado durante a integração. |
--import-source <path> |
Diretório inicial do agente de origem para --import-from. |
--import-secrets |
Importa segredos compatíveis durante a migração da integração. |
--remote-url <url> |
URL WebSocket do Gateway remoto. |
--remote-token <token> |
Token do Gateway remoto (opcional). |
--json |
Sistema configurado: visão geral do OpenClaw. Rota de integração: resumo da integração. |
--classic e --non-interactive são mutuamente exclusivos: o modo clássico abre o
assistente com prompts, enquanto a configuração não interativa usa o caminho de automação.
Modo básico
openclaw setup --baseline preserva o comportamento anterior limitado ao modo básico: ele
cria os diretórios de configuração, espaço de trabalho e sessão e, em seguida, encerra sem
executar a integração.
Exemplos
openclaw setupopenclaw setup -m "status"openclaw setup -m "restart gateway" --yesopenclaw setup --jsonopenclaw setup --wizardopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>Observações
- Após a configuração básica, execute
openclaw onboardpara a jornada guiada completa,openclaw configurepara alterações específicas ouopenclaw channels addpara adicionar contas de canais. - Se um estado do Hermes for detectado, a integração interativa poderá oferecer a migração automaticamente. A integração com importação exige uma configuração nova; use Migrar para planos de simulação, backups e modo de substituição fora da integração.
