Pular para o conteúdo principal
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.
  • Você concluiu Obter uma API Key.
  • OpenClaw está instalado e openclaw --version funciona.
  • Você tem a API Key, o Base URL e o nome do modelo do 4096bytes.
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.

​
Configure um Provider personalizado

Execute este comando para adicionar o 4096bytes como Provider de modelo personalizado. 
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.
O comando usa --strict-json. JSON não pode conter vírgulas finais, ou o OpenClaw rejeitará a configuração.

​
Defina o modelo padrão do agent

Defina o modelo 4096bytes como modelo padrão do agent e atribua um alias curto. 
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. 
openclaw gateway restart

​
Ative o novo modelo

Defina a sessão atual para usar o modelo 4096bytes. 
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. 
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

Verifique vírgulas finais, aspas sem escape ou chaves faltando. Com --strict-json, o valor precisa ser JSON válido.
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.
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.
Execute openclaw gateway restart primeiro. Se ainda falhar, verifique se models.providers.4096bytes e agents.defaults.models foram gravados com sucesso.