Configurando o OpenClaw no macOS com um endpoint unificado de provedor de IA

Tutorial de instalação do OpenClaw no macOS

Um desenvolvedor documentou seu projeto de fim de semana para fazer o OpenClaw funcionar no macOS, compartilhando etapas específicas de configuração e insights de solução de problemas que não eram óbvios na documentação.

Requisitos do sistema e instalação

A configuração requer Node.js 24 ou 22.16+. O desenvolvedor observou que o Node 20 de um projeto antigo produziu mensagens de erro pouco úteis. As opções de instalação incluem:

• Homebrew: brew install openclaw-cli
• Script de instalação oficial (escolha um método, não ambos)

Após a instalação, execute o assistente de configuração inicial:

openclaw onboard

Configuração do provedor

O desenvolvedor migrou de chaves separadas da OpenAI e Anthropic para um endpoint de provedor unificado usando o ZenMux. Durante a configuração inicial, eles selecionaram "Provedor Personalizado", depois "Compatível com OpenAI" e inseriram a URL base e a chave da API.

A configuração pós-instalação pode ser feita no arquivo de configuração JSON5 em ~/.openclaw/openclaw.json:

// ~/.openclaw/openclaw.json
{
  models: {
    mode: "merge",
    providers: {
      "zenmux": {
        baseUrl: "<your provider's base URL>/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-responses",
      },
    },
  },
}

Verificação e operação em segundo plano

Para verificar a configuração:

• openclaw doctor verifica configuração, conectividade e versão do Node
• openclaw models list mostra os modelos disponíveis
• openclaw agent --local --agent main --message "Hello, respond with just Hi" para um teste básico

Para executar o OpenClaw como um serviço em segundo plano:

openclaw onboard --install-daemon

Isso configura um LaunchAgent do macOS que inicia na inicialização. Use openclaw status para confirmar que está em execução.

Armadilhas e solução de problemas

O desenvolvedor encontrou dois problemas principais:

• O WhatsApp bloqueia todas as mensagens recebidas por padrão por segurança. Os remetentes devem ser explicitamente adicionados à lista de permissões ou as mensagens são descartadas silenciosamente.
• Ao solucionar problemas, sempre execute openclaw doctor primeiro, pois ele detecta a maioria dos problemas de configuração.

Após uma semana de uso, o desenvolvedor observou benefícios, incluindo failover automático entre provedores de modelo durante interrupções e faturamento simplificado com uma única chave de API e página de cobrança, em vez de gerenciar vários provedores.