Mantenha o OpenClaw atualizado.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Recomendado: openclaw update
A maneira mais rápida de atualizar. Ele detecta seu tipo de instalação (npm ou git), busca a versão mais recente, executa openclaw doctor e reinicia o Gateway.
openclaw update não aceita --verbose. Para diagnósticos de atualização, use
--dry-run para visualizar as ações planejadas, --json para resultados estruturados, ou
openclaw update status --json para inspecionar o estado do canal e da disponibilidade. O
instalador tem sua própria flag --verbose, mas essa flag não faz parte de
openclaw update.
--channel beta prefere beta, mas o runtime recua para stable/latest quando
a tag beta está ausente ou é mais antiga que a versão estável mais recente. Use --tag beta
se quiser a dist-tag beta bruta do npm para uma atualização de pacote pontual.
Para plugins gerenciados, o fallback do canal beta é um aviso: a atualização do core ainda pode
ter sucesso enquanto um Plugin usa sua versão padrão/mais recente registrada porque nenhum
beta do Plugin está disponível.
Veja Canais de desenvolvimento para a semântica dos canais.
Alternar entre instalações npm e git
Use canais quando quiser alterar o tipo de instalação. O atualizador mantém seu estado, configuração, credenciais e workspace em~/.openclaw; ele altera apenas
qual instalação de código do OpenClaw a CLI e o Gateway usam.
--dry-run primeiro para visualizar a troca exata do modo de instalação:
dev garante um checkout git, compila-o e instala a CLI global
a partir desse checkout. Os canais stable e beta usam instalações de pacote. Se o
Gateway já estiver instalado, openclaw update atualiza os metadados do serviço
e o reinicia, a menos que você passe --no-restart.
Alternativa: executar novamente o instalador
--no-onboard para pular o onboarding. Para forçar um tipo de instalação específico pelo
instalador, passe --install-method git --no-onboard ou
--install-method npm --no-onboard.
Se openclaw update falhar após a fase de instalação do pacote npm, execute novamente o
instalador. O instalador não chama o atualizador antigo; ele executa a instalação global
do pacote diretamente e pode recuperar uma instalação npm parcialmente atualizada.
--version:
Alternativa: npm, pnpm ou bun manual
openclaw update para instalações supervisionadas porque ele pode coordenar a
troca de pacote com o serviço Gateway em execução. Se você atualizar manualmente enquanto um
Gateway gerenciado estiver em execução, reinicie o Gateway imediatamente após o gerenciador
de pacotes terminar para que o processo antigo não continue servindo a partir de arquivos de pacote
substituídos.
Quando openclaw update gerencia uma instalação npm global, ele instala o destino em
um prefixo npm temporário primeiro, verifica o inventário dist empacotado e então troca
a árvore de pacote limpa para o prefixo global real. Isso evita que o npm sobreponha um
novo pacote sobre arquivos obsoletos do pacote antigo. Se o comando de instalação falhar,
o OpenClaw tenta novamente uma vez com --omit=optional. Essa nova tentativa ajuda hosts nos quais
dependências opcionais nativas não conseguem compilar, mantendo a falha original visível
se o fallback também falhar.
Tópicos avançados de instalação npm
Árvore de pacote somente leitura
Árvore de pacote somente leitura
O OpenClaw trata instalações globais empacotadas como somente leitura em runtime, mesmo quando o diretório global do pacote é gravável pelo usuário atual. Instalações de pacotes de Plugin ficam em raízes npm/git pertencentes ao OpenClaw sob o diretório de configuração do usuário, e a inicialização do Gateway não modifica a árvore de pacote do OpenClaw.Algumas configurações npm no Linux instalam pacotes globais em diretórios pertencentes ao root, como
/usr/lib/node_modules/openclaw. O OpenClaw oferece suporte a esse layout porque comandos de instalação/atualização de plugins gravam fora desse diretório global de pacote.Unidades systemd reforçadas
Unidades systemd reforçadas
Conceda ao OpenClaw acesso de escrita às suas raízes de configuração/estado para que instalações explícitas de plugins, atualizações de plugins e limpezas do doctor possam persistir suas alterações:
Pré-verificação de espaço em disco
Pré-verificação de espaço em disco
Antes de atualizações de pacote e instalações explícitas de plugins, o OpenClaw tenta uma verificação de espaço em disco de melhor esforço para o volume de destino. Pouco espaço produz um aviso com o caminho verificado, mas não bloqueia a atualização porque cotas de sistema de arquivos, snapshots e volumes de rede podem mudar após a verificação. A instalação real pelo gerenciador de pacotes e a verificação pós-instalação continuam sendo autoritativas.
Atualizador automático
O atualizador automático fica desativado por padrão. Habilite-o em~/.openclaw/openclaw.json:
| Canal | Comportamento |
|---|---|
stable | Aguarda stableDelayHours e então aplica com jitter determinístico ao longo de stableJitterHours (implantação distribuída). |
beta | Verifica a cada betaCheckIntervalHours (padrão: a cada hora) e aplica imediatamente. |
dev | Sem aplicação automática. Use openclaw update manualmente. |
update.checkOnStart: false).
Para downgrade ou recuperação de incidente, defina OPENCLAW_NO_AUTO_UPDATE=1 no ambiente do Gateway para bloquear aplicações automáticas mesmo quando update.auto.enabled estiver configurado. Dicas de atualização na inicialização ainda podem rodar, a menos que update.checkOnStart também esteja desativado.
Atualizações do gerenciador de pacotes solicitadas pelo manipulador do plano de controle do Gateway ao vivo
forçam uma reinicialização de atualização sem adiamento e sem cooldown após a troca do pacote. Isso
evita deixar um processo antigo em memória por tempo suficiente para carregar chunks sob demanda
a partir de uma árvore de pacote que já foi substituída. O openclaw update via shell
continua sendo o caminho preferido para instalações supervisionadas porque pode parar e
reiniciar o serviço durante a atualização.
Depois de atualizar
Migra a configuração, audita políticas de DM e verifica a integridade do Gateway. Detalhes: Doctor
Reversão
Fixar uma versão (npm)
Fixar um commit (código-fonte)
git checkout main && git pull.
Se você estiver travado
- Execute
openclaw doctornovamente e leia a saída com atenção. - Para
openclaw update --channel devem checkouts de código-fonte, o atualizador inicializapnpmautomaticamente quando necessário. Se você vir um erro de bootstrap do pnpm/corepack, instalepnpmmanualmente (ou reabilitecorepack) e execute a atualização novamente. - Verifique: Solução de problemas
- Pergunte no Discord: https://discord.gg/clawd
Relacionados
- Visão geral da instalação: todos os métodos de instalação.
- Doctor: verificações de integridade após atualizações.
- Migração: guias de migração de versões principais.