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

# Atualização

# Atualização

O OpenClaw está evoluindo rapidamente (pré “1.0”). Trate atualizações como infraestrutura de produção: atualizar → executar verificações → reiniciar (ou usar `openclaw update`, que reinicia) → verificar.

## Recomendado: executar novamente o instalador do site (atualização no local)

O caminho **preferido** de atualização é executar novamente o instalador a partir do site. Ele
detecta instalações existentes, atualiza no local e executa `openclaw doctor` quando
necessário.

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://openclaw.ai/install.sh | bash
```

Notas:

* Adicione `--no-onboard` se você não quiser que o assistente de integração inicial seja executado novamente.

* Para **instalações a partir do código-fonte**, use:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
  ```

  O instalador fará `git pull --rebase` **apenas** se o repositório estiver limpo.

* Para **instalações globais**, o script usa `npm install -g openclaw@latest` internamente.

* Nota legada: `clawdbot` permanece disponível como um shim de compatibilidade.

## Antes de atualizar

* Saiba como você instalou: **global** (npm/pnpm) vs **a partir do código-fonte** (git clone).
* Saiba como seu Gateway está rodando: **terminal em primeiro plano** vs **serviço supervisionado** (launchd/systemd).
* Faça um snapshot do seu ajuste:
  * Configuração: `~/.openclaw/openclaw.json`
  * Credenciais: `~/.openclaw/credentials/`
  * Espaço de trabalho: `~/.openclaw/workspace`

## Atualizar (instalação global)

Instalação global (escolha uma):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g openclaw@latest
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm add -g openclaw@latest
```

**Não** recomendamos Bun para o runtime do Gateway (bugs no WhatsApp/Telegram).

Para trocar canais de atualização (instalações via git + npm):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable
```

Use `--tag <dist-tag|version>` para uma instalação pontual por tag/versão.

Veja [Canais de desenvolvimento](/install/development-channels) para a semântica dos canais e notas de versão.

Nota: em instalações via npm, o gateway registra uma dica de atualização na inicialização (verifica a tag do canal atual). Desative via `update.checkOnStart: false`.

Depois:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
openclaw gateway restart
openclaw health
```

Notas:

* Se o seu Gateway roda como serviço, `openclaw gateway restart` é preferível a matar PIDs.
* Se você está fixado em uma versão específica, veja “Rollback / fixação” abaixo.

## Atualizar (`openclaw update`)

Para **instalações a partir do código-fonte** (git checkout), prefira:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update
```

Ele executa um fluxo de atualização relativamente seguro:

* Requer uma árvore de trabalho limpa.
* Alterna para o canal selecionado (tag ou branch).
* Faz fetch + rebase contra o upstream configurado (canal dev).
* Instala dependências, compila, compila a Control UI e executa `openclaw doctor`.
* Reinicia o gateway por padrão (use `--no-restart` para pular).

Se você instalou via **npm/pnpm** (sem metadados git), `openclaw update` tentará atualizar via seu gerenciador de pacotes. Se não conseguir detectar a instalação, use “Atualizar (instalação global)” em vez disso.

## Atualizar (Control UI / RPC)

A Control UI tem **Update & Restart** (RPC: `update.run`). Ela:

1. Executa o mesmo fluxo de atualização a partir do código-fonte que `openclaw update` (apenas git checkout).
2. Grava um sentinel de reinício com um relatório estruturado (stdout/stderr tail).
3. Reinicia o gateway e envia um ping para a última sessão ativa com o relatório.

Se o rebase falhar, o gateway aborta e reinicia sem aplicar a atualização.

## Atualizar (a partir do código-fonte)

A partir do checkout do repositório:

Preferido:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw update
```

Manual (equivalente-ish):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health
```

Notas:

* `pnpm build` importa quando você executa o binário empacotado `openclaw` ([`openclaw.mjs`](https://github.com/openclaw/openclaw/blob/main/openclaw.mjs)) ou usa Node para executar `dist/`.
* Se você roda a partir de um checkout do repositório sem uma instalação global, use `pnpm openclaw ...` para comandos da CLI.
* Se você roda diretamente a partir de TypeScript (`pnpm openclaw ...`), geralmente uma recompilação é desnecessária, mas **migrações de configuração ainda se aplicam** → execute o doctor.
* Alternar entre instalações globais e via git é fácil: instale o outro formato e, em seguida, execute `openclaw doctor` para que o entrypoint do serviço do gateway seja reescrito para a instalação atual.

## Sempre execute: `openclaw doctor`

Doctor é o comando de “atualização segura”. Ele é intencionalmente simples: reparar + migrar + avisar.

Nota: se você estiver em uma **instalação a partir do código-fonte** (git checkout), `openclaw doctor` oferecerá executar `openclaw update` primeiro.

Coisas típicas que ele faz:

* Migra chaves de configuração obsoletas / locais legados de arquivos de configuração.
* Audita políticas de DM e avisa sobre configurações “abertas” arriscadas.
* Verifica a saúde do Gateway e pode oferecer reiniciar.
* Detecta e migra serviços de gateway antigos (launchd/systemd; schtasks legados) para os serviços atuais do OpenClaw.
* No Linux, garante o lingering do usuário no systemd (para que o Gateway sobreviva ao logout).

Detalhes: [Doctor](/gateway/doctor)

## Iniciar / parar / reiniciar o Gateway

CLI (funciona independentemente do SO):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow
```

Se você usa supervisão:

* macOS launchd (LaunchAgent empacotado no app): `launchctl kickstart -k gui/$UID/bot.molt.gateway` (use `bot.molt.<profile>`; o legado `com.openclaw.*` ainda funciona)
* Serviço de usuário do Linux systemd: `systemctl --user restart openclaw-gateway[-<profile>].service`
* Windows (WSL2): `systemctl --user restart openclaw-gateway[-<profile>].service`
  * `launchctl`/`systemctl` só funcionam se o serviço estiver instalado; caso contrário, execute `openclaw gateway install`.

Runbook + rótulos exatos de serviços: [Gateway runbook](/gateway)

## Rollback / fixação (quando algo quebra)

### Fixar (instalação global)

Instale uma versão conhecida e estável (substitua `<version>` pela última que funcionou):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g openclaw@<version>
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm add -g openclaw@<version>
```

Dica: para ver a versão publicada atual, execute `npm view openclaw version`.

Depois reinicie + execute o doctor novamente:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
openclaw gateway restart
```

### Fixar (código-fonte) por data

Escolha um commit por data (exemplo: “estado da main em 2026-01-01”):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
```

Depois reinstale dependências + reinicie:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm install
pnpm build
openclaw gateway restart
```

Se quiser voltar para o mais recente depois:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git checkout main
git pull
```

## Se você estiver travado

* Execute `openclaw doctor` novamente e leia a saída com atenção (ela frequentemente indica a correção).
* Confira: [Solução de problemas](/gateway/troubleshooting)
* Pergunte no Discord: [https://discord.gg/clawd](https://discord.gg/clawd)