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

# OpenClaw

> Configure o 4096bytes como Provider de modelo personalizado no OpenClaw

O OpenClaw pode se conectar ao 4096bytes por meio de um Provider de modelo personalizado. Escreva a configuração compatível com OpenAI, defina o modelo padrão do agent, reinicie o gateway e ative o novo modelo.

## Pré-requisitos

* Você concluiu [Criar uma conta](/pt-BR/quickstart/create-account).
* Você concluiu [Obter uma API Key](/pt-BR/quickstart/get-api-key).
* OpenClaw está instalado e `openclaw --version` funciona.
* Você tem a API Key, o Base URL e o nome do modelo do 4096bytes.

<Warning>
  Os comandos abaixo gravam a API Key na configuração local do OpenClaw. Não envie comandos, arquivos de configuração, capturas de tela ou saídas de terminal que contenham a API Key real.
</Warning>

## Configure um Provider personalizado

Execute este comando para adicionar o 4096bytes como Provider de modelo personalizado.

```bash theme={null}
openclaw config set models.providers.4096bytes '{
  "api": "openai-completions",
  "baseUrl": "https://api.4096bytes.com/v1",
  "apiKey": "YOUR_4096BYTES_API_KEY",
  "auth": "api-key",
  "headers": {
    "User-Agent": "Mozilla/5.0"
  },
  "models": [
    {
      "id": "gpt-5.5",
      "name": "GPT-5.5",
      "contextWindow": 200000,
      "reasoning": true,
      "input": [
        "text"
      ]
    }
  ]
}' --strict-json --merge
```

Substitua `YOUR_4096BYTES_API_KEY` pela API Key criada no painel. Use os valores atuais do painel para `id`, `name`, `contextWindow` e `reasoning`.

<Tip>
  O comando usa `--strict-json`. JSON não pode conter vírgulas finais, ou o OpenClaw rejeitará a configuração.
</Tip>

## Defina o modelo padrão do agent

Defina o modelo 4096bytes como modelo padrão do agent e atribua um alias curto.

```bash theme={null}
openclaw config set agents.defaults.models '{"4096bytes/gpt-5.5": {"alias": "G55"}}' --strict-json --merge
```

Se o nome do seu modelo não for `gpt-5.5`, substitua `4096bytes/gpt-5.5` no comando.

## Reinicie o gateway

Depois de gravar a configuração, reinicie o gateway do OpenClaw.

```bash theme={null}
openclaw gateway restart
```

## Ative o novo modelo

Defina a sessão atual para usar o modelo 4096bytes.

```bash theme={null}
openclaw models set 4096bytes/gpt-5.5
```

Se você usa outro nome de modelo, substitua `gpt-5.5` pelo ID exibido no painel.

## Teste a chamada do modelo

Envie uma mensagem curta para verificar a conexão.

```bash theme={null}
openclaw chat --message "hi"
```

Se o OpenClaw responder sem erro de autenticação ou modelo não encontrado, a configuração está ativa.

## Problemas comuns

<AccordionGroup>
  <Accordion title="OpenClaw informa que o JSON é inválido">
    Verifique vírgulas finais, aspas sem escape ou chaves faltando. Com `--strict-json`, o valor precisa ser JSON válido.
  </Accordion>

  <Accordion title="Falha de autenticação">
    Confira se `apiKey` está completo e foi copiado sem espaços extras ou quebras de linha. Confirme que a API Key não foi excluída, expirou ou passou do limite.
  </Accordion>

  <Accordion title="Modelo não encontrado">
    Confirme que o `id` em `models` corresponde ao ID usado por `openclaw models set`. Copie o nome do modelo no painel, não em capturas antigas ou configurações de outros usuários.
  </Accordion>

  <Accordion title="Configuração não tem efeito">
    Execute `openclaw gateway restart` primeiro. Se ainda falhar, verifique se `models.providers.4096bytes` e `agents.defaults.models` foram gravados com sucesso.
  </Accordion>
</AccordionGroup>