AiHubMix Documentation Hub

Instalação

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

Execute o comando de instalação

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.

openclaw models status

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

& "seu-caminho-de-instalacao\OpenClaw\openclaw.cmd" models status

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.

Configuração do Terminal

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

openclaw onboard

Selecione Yes

Selecione QuickStart

Selecione Skip for now

Selecione All providers

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

Vincule sua conta pessoal conforme necessário; se não for necessário, selecione Skip for now.

Configure as skills selecionando Yes.

Selecione npm

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

Selecione No para todas as opções.

Selecione Skip for now.

Selecione Hatch in UI.

Configurar AIHubMix

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

Código fonte do plugin: aihubmix-auth

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

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:

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 para começar a usar.

Método 2: Configuração Manual

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

{
  "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:

openclaw models set aihubmix-openai/gpt-5.4

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

& "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:

openclaw models status

Execute uma chamada real para validar:

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:

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:

openclaw infer model list --json

Iniciar

openclaw gateway

Teste

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

Perguntas Frequentes

Atualização de versão

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

Processo Gateway ocupado

openclaw gateway stop
openclaw gateway

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

Assistentes de codificação

Integrações IDE

Agente / Workflow

SDKs e frameworks

OpenClaw

Instalação

Configuração do Terminal

Configurar AIHubMix

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

Método 2: Configuração Manual

Método 3: alternar o modelo padrão com comandos dinâmicos de modelo

Iniciar

Teste

Perguntas Frequentes

Atualização de versão

Processo Gateway ocupado

​Instalação

​Configuração do Terminal

​Configurar AIHubMix

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

​Método 2: Configuração Manual

​Método 3: alternar o modelo padrão com comandos dinâmicos de modelo

​Iniciar

​Teste

​Perguntas Frequentes

​Atualização de versão

​Processo Gateway ocupado

Instalação

Configuração do Terminal

Configurar AIHubMix

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

Método 2: Configuração Manual

Método 3: alternar o modelo padrão com comandos dinâmicos de modelo

Iniciar

Teste

Perguntas Frequentes

Atualização de versão

Processo Gateway ocupado