Configurar OpenClaw en macOS con un punto de conexión unificado de proveedor de IA

Tutorial de instalación de OpenClaw en macOS

Un desarrollador documentó su proyecto de fin de semana para poner en marcha OpenClaw en macOS, compartiendo pasos de configuración específicos y consejos de solución de problemas que no eran obvios en la documentación.

Requisitos del sistema e instalación

La configuración requiere Node.js 24 o 22.16+. El desarrollador señaló que Node 20 de un proyecto anterior producía mensajes de error poco útiles. Las opciones de instalación incluyen:

• Homebrew: brew install openclaw-cli
• Script de instalación oficial (elegir un método, no ambos)

Después de la instalación, ejecuta el asistente de configuración inicial:

openclaw onboard

Configuración del proveedor

El desarrollador pasó de usar claves separadas de OpenAI y Anthropic a un endpoint de proveedor unificado usando ZenMux. Durante la configuración inicial, seleccionaron "Proveedor personalizado", luego "Compatible con OpenAI" e ingresaron la URL base y la clave API.

La configuración posterior a la instalación se puede realizar en el archivo de configuración JSON5 en ~/.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",
      },
    },
  },
}

Verificación y operación en segundo plano

Para verificar la configuración:

• openclaw doctor verifica la configuración, la conectividad y la versión de Node
• openclaw models list muestra los modelos disponibles
• openclaw agent --local --agent main --message "Hello, respond with just Hi" para una verificación básica

Para ejecutar OpenClaw como un servicio en segundo plano:

openclaw onboard --install-daemon

Esto configura un LaunchAgent de macOS que se inicia al arrancar. Usa openclaw status para confirmar que está en ejecución.

Problemas comunes y solución de problemas

El desarrollador encontró dos problemas principales:

• WhatsApp bloquea todos los mensajes entrantes por defecto por seguridad. Los remitentes deben estar explícitamente en la lista de permitidos o los mensajes se descartan silenciosamente.
• Al solucionar problemas, siempre ejecuta primero openclaw doctor ya que detecta la mayoría de los problemas de configuración.

Después de una semana de uso, el desarrollador notó beneficios que incluyen la conmutación automática por error entre proveedores de modelos durante interrupciones y facturación simplificada con una sola clave API y página de facturación en lugar de gestionar múltiples proveedores.