AiHubMix Documentation Hub

Instalación

Asegúrate de tener Node >= 22 antes de la instalación.

Ejecuta el comando de instalación:

npm install -g openclaw@latest

Después de la instalación, los siguientes comandos se pueden ejecutar desde cualquier directorio. No hace falta cambiar primero al directorio de instalación de OpenClaw. Si tu terminal reconoce openclaw, puedes copiar directamente los comandos de esta guía.

openclaw models status

Si Windows indica que no encuentra openclaw, sustituye el comando inicial por la ruta local del ejecutable:

& "tu-ruta-de-instalacion\OpenClaw\openclaw.cmd" models status

tu-ruta-de-instalacion es un marcador de posición. Sustitúyelo por el directorio superior donde instalaste OpenClaw. Por ejemplo, si OpenClaw está en D:\Apps\OpenClaw, usa & "D:\Apps\OpenClaw\openclaw.cmd" models status.

Configuración en la terminal

Abre la terminal y ejecuta el siguiente comando para iniciar la configuración:

openclaw onboard

Selecciona Yes.

Selecciona QuickStart.

Selecciona Skip for now.

Selecciona All providers.

Elige el modelo predeterminado según necesites; inicialmente puedes seleccionar Keep current (si usas el «Método 2: Configuración manual», podrás modificarlo en el archivo de configuración en el siguiente paso).

Vincula tu cuenta personal según necesites; si no es necesario, selecciona Skip for now.

Configura las skills seleccionando Yes.

Selecciona npm.

Configura la selección de skills según necesites.

Selecciona No para todas las opciones.

Selecciona Skip for now.

Selecciona Hatch in UI.

Configurar AIHubMix

Método 1: Configuración rápida mediante plugin (recomendado)

Código fuente del plugin: aihubmix-auth

Instala el plugin AIHubMix auth y reinicia el Gateway:

openclaw plugins install @akakenle/aihubmix-auth
openclaw gateway restart

Ejecuta el comando de autenticación. Introduce tu clave API de AIHubMix cuando se te solicite. Solo necesitas ejecutar el comando de abajo una vez para cualquiera de los cuatro providers — el plugin utiliza providerAuthAliases para que la misma clave sea válida en todos los transports:

openclaw models auth login --provider aihubmix-openai --method api-key --set-default

El plugin organiza los modelos en los siguientes grupos:

aihubmix-openai — gpt-* / o1-* / o3-* / o4-*, https://aihubmix.com/v1 (openai-completions)
aihubmix-anthropic — claude-*, https://aihubmix.com (anthropic-messages)
aihubmix-google — gemini-*, https://aihubmix.com/gemini/v1beta (google-generative-ai)
aihubmix-other — Otros modelos, https://aihubmix.com/v1 (openai-completions)

Los identificadores de modelo abreviados (p. ej. claude-sonnet-4-5) se enrutan automáticamente al transport correcto mediante el hook resolveDynamicModel del plugin — no es necesario escribir el formato completo provider/model.

¿Prefieres omitir el inicio de sesión interactivo? Establece export AIHUBMIX_API_KEY=sk-... antes de instalar — el plugin escribirá la clave como apiKey inline en la configuración del provider (el inicio de sesión interactivo la almacena en el auth-profile en su lugar).

Una vez configurado, salta a la sección Iniciar para empezar a usarlo.

Método 2: Configuración manual

Abre el archivo ~/.openclaw/openclaw.json y añade la siguiente configuración:

{
  "models": {
    "mode": "merge",
    "providers": {
      "aihubmix-openai": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      },
      "aihubmix-anthropic": {
        "baseUrl": "https://aihubmix.com",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "claude-sonnet-4-5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "aihubmix-google": {
        "baseUrl": "https://aihubmix.com/gemini/v1beta",
        "api": "google-generative-ai",
        "models": []
      },
      "aihubmix-other": {
        "baseUrl": "https://aihubmix.com/v1",
        "api": "openai-completions",
        "models": []
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aihubmix-anthropic/claude-sonnet-4-5"
      },
      "workspace": "your_workspace_path",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

Método 3: cambiar el modelo predeterminado con comandos de modelo dinámicos

El plugin de AIHubMix para OpenClaw admite enrutamiento dinámico de modelos. Siempre que el modelo esté disponible en tu cuenta de AIHubMix, puedes llamarlo con el formato provider/model-id. La disponibilidad real depende de la consola de AIHubMix y de la respuesta de la API. Reglas habituales para elegir provider:

aihubmix-openai: modelos compatibles con OpenAI, por ejemplo gpt-*, o1-*, o3-* y o4-*
aihubmix-anthropic: modelos Claude, por ejemplo claude-*
aihubmix-google: modelos Gemini, por ejemplo gemini-*
aihubmix-other: otros modelos llamados mediante un endpoint compatible con OpenAI, por ejemplo glm-5.2

Ejemplo: establecer gpt-5.4 como modelo predeterminado de OpenClaw:

openclaw models set aihubmix-openai/gpt-5.4

Si Windows no encuentra openclaw, usa la forma con ruta local:

& "tu-ruta-de-instalacion\OpenClaw\openclaw.cmd" models set aihubmix-openai/gpt-5.4

Comprueba el modelo predeterminado actual y el estado de autenticación:

openclaw models status

Ejecuta una llamada real para verificarlo:

openclaw infer model run --local --json --model aihubmix-openai/gpt-5.4 --prompt "Reply only OK"

Para llamar a modelos fuera de los grupos OpenAI / Claude / Gemini, usa aihubmix-other, por ejemplo:

openclaw infer model run --local --json --model aihubmix-other/glm-5.2 --prompt "Reply only OK"

Lista el catálogo de modelos cargado actualmente por OpenClaw:

openclaw infer model list --json

Iniciar

openclaw gateway

Prueba

Escribe hello en la página de chat; si recibes una respuesta, la configuración es correcta.

Preguntas frecuentes

Actualización de versión

openclaw plugins update @akakenle/aihubmix-auth
openclaw gateway restart

Proceso del Gateway ocupado

openclaw gateway stop
openclaw gateway

Última actualización: 2026-07-03

Asistentes de código

Integraciones IDE

Agente / Workflow

SDKs y frameworks

OpenClaw

Instalación

Configuración en la terminal

Configurar AIHubMix

Método 1: Configuración rápida mediante plugin (recomendado)

Método 2: Configuración manual

Método 3: cambiar el modelo predeterminado con comandos de modelo dinámicos

Iniciar

Prueba

Preguntas frecuentes

Actualización de versión

Proceso del Gateway ocupado

​Instalación

​Configuración en la terminal

​Configurar AIHubMix

​Método 1: Configuración rápida mediante plugin (recomendado)

​Método 2: Configuración manual

​Método 3: cambiar el modelo predeterminado con comandos de modelo dinámicos

​Iniciar

​Prueba

​Preguntas frecuentes

​Actualización de versión

​Proceso del Gateway ocupado

Instalación

Configuración en la terminal

Configurar AIHubMix

Método 1: Configuración rápida mediante plugin (recomendado)

Método 2: Configuración manual

Método 3: cambiar el modelo predeterminado con comandos de modelo dinámicos

Iniciar

Prueba

Preguntas frecuentes

Actualización de versión

Proceso del Gateway ocupado