Skip to main content

​
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:
  1. 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 como openclaw onboard.
  2. -m/--message ou --yes executa o agente do sistema.
  3. Sem uma opção de roteamento, um sistema interativo configurado abre o OpenClaw. Um sistema novo executa a integração. Em um sistema configurado, --json exibe 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.
openclaw setup destina-se a instalações com configuração mutável. No modo Nix (OPENCLAW_NIX_MODE=1), o OpenClaw recusa gravações de configuração porque o arquivo de configuração é gerenciado pelo Nix. Use o Início rápido do nix-openclaw oficial ou a configuração de origem equivalente para outro pacote Nix.

​
Opções

--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

​
Observações

  • Após a configuração básica, execute openclaw onboard para a jornada guiada completa, openclaw configure para alterações específicas ou openclaw channels add para 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.

​
Relacionados