> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

## Instalación

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

Ejecuta el comando de instalación:

```shellscript theme={null}
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.

```powershell theme={null}
openclaw models status
```

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

```powershell theme={null}
& "tu-ruta-de-instalacion\OpenClaw\openclaw.cmd" models status
```

<Note>
  `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`.
</Note>

### Configuración en la terminal

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

```shellscript theme={null}
openclaw onboard
```

Selecciona `Yes`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-1.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=88d5674d5255b84d695044b7e36fbfcc" alt="Oc 1" width="1212" height="814" data-path="public/cn/oc-1.png" />

Selecciona `QuickStart`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-2.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=093443c0dc408dfaa6b6b4eba004e8d1" alt="Oc 2" width="1212" height="814" data-path="public/cn/oc-2.png" />

Selecciona `Skip for now`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-3.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=690bbdc272c9e3de0eec7fb3bb65ca93" alt="Oc 3" width="1212" height="814" data-path="public/cn/oc-3.png" />

Selecciona `All providers`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-4.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=03c0af702000f97a0c53470300f0f3a7" alt="Oc 4" width="1212" height="814" data-path="public/cn/oc-4.png" />

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).

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-5.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=996d39a888f2f5b739dbfc8bcc0f033f" alt="Oc 5" width="1212" height="814" data-path="public/cn/oc-5.png" />

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

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-6.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=28b73573f717822c0786788c582aa99e" alt="Oc 6" width="1212" height="814" data-path="public/cn/oc-6.png" />

Configura las skills seleccionando `Yes`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-7.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=fe9c36aac91dd294ccce4a1ee12ad0e0" alt="Oc 7" width="1212" height="814" data-path="public/cn/oc-7.png" />

Selecciona `npm`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-8.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=c6eef11c88ae8f783e8d12bd196bdd0c" alt="Oc 8" width="1212" height="814" data-path="public/cn/oc-8.png" />

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

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-9.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=0ae533bdae76daf8939f91acc8df90dc" alt="Oc 9" width="1212" height="814" data-path="public/cn/oc-9.png" />

Selecciona `No` para todas las opciones.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-10.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=30834a010846ee0b3f53e13770346bca" alt="Oc 10" width="1212" height="814" data-path="public/cn/oc-10.png" />

Selecciona `Skip for now`.

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-11.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=1473f71f42c750cf132f321f9b4bc5bb" alt="Oc 11" width="1212" height="814" data-path="public/cn/oc-11.png" />

Selecciona `Hatch in UI`.

## Configurar AIHubMix

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

<Info>
  Código fuente del plugin: [aihubmix-auth](https://github.com/akakenle/aihubmix-auth)
</Info>

Instala el plugin AIHubMix auth y reinicia el Gateway:

```shellscript theme={null}
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:

```shellscript theme={null}
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](#iniciar) para empezar a usarlo.

### Método 2: Configuración manual

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

```json theme={null}
{
  "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:

```powershell theme={null}
openclaw models set aihubmix-openai/gpt-5.4
```

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

```powershell theme={null}
& "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:

```powershell theme={null}
openclaw models status
```

Ejecuta una llamada real para verificarlo:

```powershell theme={null}
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:

```powershell theme={null}
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:

```powershell theme={null}
openclaw infer model list --json
```

## Iniciar

```shellscript theme={null}
openclaw gateway
```

## Prueba

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

<img src="https://mintcdn.com/aihubmix/WotSdjzuAai7hVOs/public/cn/oc-12.png?fit=max&auto=format&n=WotSdjzuAai7hVOs&q=85&s=3340254888707f81142e23906a55ff0e" alt="Oc 12" width="3266" height="1892" data-path="public/cn/oc-12.png" />

## Preguntas frecuentes

### Actualización de versión

```shellscript theme={null}
openclaw plugins update @akakenle/aihubmix-auth
openclaw gateway restart
```

### Proceso del Gateway ocupado

```shellscript theme={null}
openclaw gateway stop
openclaw gateway
```

***

Última actualización: 2026-07-03