> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração

# `openclaw setup`

Execute o fluxo completo de integração inicial da CLI. `openclaw setup` é um alias para `openclaw onboard`; use `--baseline` quando você só precisa inicializar as pastas de configuração/workspace sem o assistente.

<Note>
  `openclaw setup` é para instalações com configuração mutável. No modo Nix (`OPENCLAW_NIX_MODE=1`), o OpenClaw recusa gravações de setup porque o arquivo de configuração é gerenciado pelo Nix. Use o [Início Rápido do nix-openclaw](https://github.com/openclaw/nix-openclaw#quick-start) oficial ou a configuração de origem equivalente para outro pacote Nix.
</Note>

## Opções

| Flag                       | Descrição                                                                                                       |
| -------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `--workspace <dir>`        | Diretório de workspace do agente (padrão `~/.openclaw/workspace`; armazenado como `agents.defaults.workspace`). |
| `--baseline`               | Cria as pastas básicas de configuração/workspace/sessão sem integração inicial.                                 |
| `--wizard`                 | Aceito por compatibilidade; o setup executa a integração inicial por padrão.                                    |
| `--non-interactive`        | Executa a integração inicial sem prompts.                                                                       |
| `--accept-risk`            | Reconhece o risco de acesso de agente ao sistema inteiro; obrigatório com `--non-interactive`.                  |
| `--mode <mode>`            | Modo de integração inicial: `local` ou `remote`.                                                                |
| `--import-from <provider>` | Provedor de migração a ser executado durante a integração inicial.                                              |
| `--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 inicial.                                          |
| `--remote-url <url>`       | URL WebSocket do Gateway remoto.                                                                                |
| `--remote-token <token>`   | Token do Gateway remoto (opcional).                                                                             |

### Modo básico

`openclaw setup --baseline` preserva o comportamento antigo somente básico: cria os diretórios de configuração, workspace e sessão, depois sai sem executar a integração inicial.

## Exemplos

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw setup
openclaw setup --baseline
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --import-from hermes --import-source ~/.hermes
openclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>
```

## Observações

* `openclaw setup` simples executa a mesma jornada guiada que `openclaw onboard`.
* Após o setup básico, execute `openclaw setup` ou `openclaw onboard` para a jornada guiada completa, `openclaw configure` para mudanças direcionadas, ou `openclaw channels add` para adicionar contas de canal.
* Se o estado do Hermes for detectado, a integração inicial interativa pode oferecer a migração automaticamente. A integração inicial de importação exige um setup novo; use [Migrar](/pt-BR/cli/migrate) para planos de simulação, backups e modo de sobrescrita fora da integração inicial.

## Relacionado

* [Referência da CLI](/pt-BR/cli)
* [Integração inicial (CLI)](/pt-BR/start/wizard)
* [Primeiros passos](/pt-BR/start/getting-started)
* [Visão geral da instalação](/pt-BR/install)