Como corrigir o erro 'Cannot find module' do OpenClaw após atualização

Problema: Módulo ausente após atualização do OpenClaw

Usuários que atualizam o OpenClaw da versão 2026.3.24 para 2026.4.5 estão encontrando um erro Cannot find module '@buape/carbon'. Este problema supostamente foi corrigido em um pull request há mais de uma semana, mas algumas instalações ainda enfrentam a questão.

Instalar manualmente o pacote ausente globalmente não é recomendado, pois pode causar incompatibilidades de dependências posteriormente.

Solução: Execute o script pós-instalação manualmente

A correção envolve executar manualmente um script pós-instalação que deveria ter sido executado automaticamente durante o processo de atualização.

Passos para corrigir

1. Identifique a localização da instalação do OpenClaw:
   Execute which openclaw para determinar qual gerenciador de pacotes (pnpm ou npm) gerencia sua instalação.
2. Encontre o diretório de instalação global:
   Execute pnpm root -g ou npm root -g dependendo do seu gerenciador de pacotes.
3. Navegue até o diretório do OpenClaw:
   Execute cd $(pnpm root -g)/openclaw ou o equivalente para npm.
4. Execute o script pós-instalação:
   Execute node scripts/postinstall-bundled-plugins.mjs
5. Aguarde a conclusão:
   O script é executado sem exibir logs. Aguarde até que ele termine.
6. Verifique a correção:
   Execute openclaw doctor para confirmar que a instalação está funcionando corretamente.

Esta abordagem garante que as dependências sejam instaladas corretamente sem criar incompatibilidades de versão que podem ocorrer com a instalação manual de pacotes.