> ## 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

## Instalação

<Note>
  Certifique-se de que Node >= 22 antes da instalação.
</Note>

Execute o comando de instalação

```shellscript theme={null}
npm install -g openclaw@latest
```

Depois da instalação, os comandos abaixo podem ser executados em qualquer diretório. Não é necessário entrar antes no diretório de instalação do OpenClaw. Se o terminal reconhecer `openclaw`, você pode copiar diretamente os comandos deste guia.

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

Se o Windows informar que não encontrou `openclaw`, substitua o comando inicial pelo caminho local do executável:

```powershell theme={null}
& "seu-caminho-de-instalacao\OpenClaw\openclaw.cmd" models status
```

<Note>
  `seu-caminho-de-instalacao` é um marcador de posição. Substitua pelo diretório pai onde o OpenClaw está instalado. Por exemplo, se o OpenClaw estiver em `D:\Apps\OpenClaw`, use `& "D:\Apps\OpenClaw\openclaw.cmd" models status`.
</Note>

### Configuração do Terminal

Abra o terminal e execute o seguinte comando para iniciar a configuração

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

Selecione `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" />

Selecione `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" />

Selecione `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" />

Selecione `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" />

Escolha o modelo padrão conforme necessário; você pode inicialmente selecionar `Keep current` (se usar o "Método 2: Configuração Manual", poderá modificá-lo no arquivo de configuração na próxima etapa).

<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" />

Vincule sua conta pessoal conforme necessário; se não for necessário, selecione `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" />

Configure as skills selecionando `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" />

Selecione `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" />

Configure a seleção de skills conforme necessário.

<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" />

Selecione `No` para todas as opções.

<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" />

Selecione `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" />

Selecione `Hatch in UI`.

## Configurar AIHubMix

### Método 1: Configuração rápida via plugin (recomendado)

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

Instale o plugin de autenticação AIHubMix e reinicie o Gateway:

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

Execute o comando de autenticação. Insira sua chave de API AIHubMix quando solicitado. Você só precisa executar o comando abaixo uma vez para qualquer um dos quatro providers — o plugin usa `providerAuthAliases` para tornar a mesma chave válida em todos os transports:

```shellscript theme={null}
openclaw models auth login --provider aihubmix-openai --method api-key --set-default
```

O plugin organiza os modelos nos seguintes 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** — outros modelos, `https://aihubmix.com/v1` (`openai-completions`)

IDs de modelo abreviados (ex. `claude-sonnet-4-5`) são roteados automaticamente para o transport correto pelo hook `resolveDynamicModel` do plugin — não é necessário escrever o formato completo `provider/model`.

> Prefere pular o login interativo? Defina `export AIHUBMIX_API_KEY=sk-...` antes de instalar — o plugin escreverá a chave como `apiKey` inline na configuração do provider (o login interativo a armazena no auth-profile).

Uma vez configurado, vá para a seção [Iniciar](#iniciar) para começar a usar.

### Método 2: Configuração Manual

Abra o arquivo `~/.openclaw/openclaw.json` e adicione a seguinte configuração:

```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: alternar o modelo padrão com comandos dinâmicos de modelo

O plugin AIHubMix para OpenClaw oferece suporte a roteamento dinâmico de modelos. Desde que o modelo esteja disponível na sua conta AIHubMix, você pode chamá-lo no formato `provider/model-id`. A disponibilidade real deve ser confirmada pelo console do AIHubMix e pela resposta da API.

Regras comuns para escolher o provider:

* `aihubmix-openai`: modelos compatíveis com OpenAI, como `gpt-*`, `o1-*`, `o3-*` e `o4-*`
* `aihubmix-anthropic`: modelos Claude, como `claude-*`
* `aihubmix-google`: modelos Gemini, como `gemini-*`
* `aihubmix-other`: outros modelos chamados por um endpoint compatível com OpenAI, como `glm-5.2`

Exemplo: definir `gpt-5.4` como modelo padrão do OpenClaw:

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

Se o Windows não encontrar `openclaw`, use a forma com caminho local:

```powershell theme={null}
& "seu-caminho-de-instalacao\OpenClaw\openclaw.cmd" models set aihubmix-openai/gpt-5.4
```

Verifique o modelo padrão atual e o estado de autenticação:

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

Execute uma chamada real para validar:

```powershell theme={null}
openclaw infer model run --local --json --model aihubmix-openai/gpt-5.4 --prompt "Reply only OK"
```

Para chamar modelos fora dos grupos OpenAI / Claude / Gemini, use `aihubmix-other`, por exemplo:

```powershell theme={null}
openclaw infer model run --local --json --model aihubmix-other/glm-5.2 --prompt "Reply only OK"
```

Liste o catálogo de modelos carregado atualmente pelo OpenClaw:

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

## Iniciar

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

## Teste

Digite `hello` na página de chat; se receber uma resposta, a configuração foi bem-sucedida.

<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" />

## Perguntas Frequentes

### Atualização de versão

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

### Processo Gateway ocupado

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

***

Última atualização: 2026-07-03