Erros comuns de instalação do OpenClaw e como corrigi-los

Guia de solução de problemas de instalação do OpenClaw
Uma postagem recente no r/openclaw aborda erros recorrentes de instalação e execução da ferramenta OpenClaw, fornecendo comandos e correções específicas.
Problemas principais e soluções
"instalado, mas o openclaw não é encontrado"
Isso ocorre quando o diretório bin global do npm não está no seu PATH. O binário existe, mas não pode ser encontrado.
- Execute
npm prefix -gpara encontrar seu prefixo global. - Adicione
<prefix>/binao seu$PATHno.bashrcou.zshrc. - Recarregue seu shell, então
openclaw --versiondeve funcionar.
"EACCES: permissão negada" na instalação
Este é um problema de permissões com o diretório global padrão do npm, geralmente de propriedade do root.
- Não use
sudo. - Configure um prefixo de propriedade do usuário em vez disso:
mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' export PATH="$HOME/.npm-global/bin:$PATH" - Adicione a exportação à configuração do seu shell e execute novamente a instalação sem sudo.
Falhas silenciosas do Node.js antigo
O OpenClaw requer Node.js 22+. Versões mais antigas podem instalar sem erro, mas produzem um binário que falha durante a execução.
- Sempre verifique
node --versionprimeiro.
"ioctl inadequado para o dispositivo"
Este é um problema de TTY, comum em contêineres Docker ou ambientes de CI sem um terminal real.
- Execute
openclaw onboard --non-interactive --accept-riskpara pular o assistente interativo.
Plugin do Telegram travado como "não disponível"
Se uma instalação anterior com problemas deixou o plugin do Telegram em um estado parcialmente configurado, ele pode ficar travado.
- Execute
openclaw doctor --fixpara limpar o estado.
Nota sobre "pareamento de conexão do gateway necessário"
Esta mensagem não é um erro de instalação. Ela se relaciona à política de DM, onde o OpenClaw requer pareamento manual antes de responder a DMs por padrão. Consulte a documentação do OpenClaw sobre configuração de canal.
📖 Leia a fonte completa: r/openclaw
👀 See Also

Corrigindo erros 'Falha ao iniciar o espaço de trabalho' do Claude Cowork no Windows 11 Home
Um usuário resolveu os erros de inicialização do Claude Cowork no Windows 11 Home instalando o Windows Subsystem for Linux (WSL2) da Microsoft Store, que é necessário para a tecnologia de VM subjacente.

Solução Alternativa com Atalho do iOS para Enviar Fotos do iPhone para Cowork via Sincronização do iCloud
Um desenvolvedor criou um atalho do iOS chamado "PhoPo" que converte fotos do iPhone para JPEG, redimensiona-as e salva em uma pasta sincronizada pelo iCloud que o Cowork pode acessar, permitindo que o Claude analise capturas de tela e fotos de dispositivos móveis.

Atualização do OpenClaw v2.0: Lista de Verificação Crítica Pré-Atualização para Evitar Mudanças Disruptivas
A última atualização do OpenClaw introduz 12 mudanças que quebram compatibilidade, um novo sistema de plugins e mais de 30 correções de segurança. Este guia descreve cinco verificações essenciais a serem realizadas antes de atualizar, incluindo renomeação de variáveis de ambiente, migração do diretório de estado e reconfiguração da automação do navegador.

Duas configurações $0 do OpenClaw usando modelos de nuvem gratuitos ou Ollama local
Uma postagem no Reddit detalha duas abordagens para executar agentes OpenClaw sem custo: usar camadas gratuitas do OpenRouter, Gemini e Groq com limites de taxa, ou executar modelos locais via Ollama sem chaves de API e sem que dados saiam da sua máquina.