Configuração do OpenClaw
Saiba como configurar o OpenClaw para usar a API da Aiberm. Este guia aborda a instalação e a configuração no Windows, macOS e Linux.
O que é o OpenClaw?
O OpenClaw é uma plataforma de agentes de IA de código aberto que leva a assistência de IA diretamente ao seu terminal e aos aplicativos de mensagens. Ele oferece suporte a vários provedores de LLM e pode ser estendido com plugins.
Ao instalar o plugin openclaw-aiberm, você pode acessar todos os modelos disponíveis na Aiberm (incluindo GPT, Claude, Gemini, DeepSeek, Grok e outros) por uma interface unificada com uma única chave de API.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma conta Aiberm (Cadastre-se aqui)
- Uma chave de API da Aiberm (Obtenha sua chave)
- Acesso ao Terminal/Prompt de Comando no seu computador
- Node.js 18+ instalado
Instalação
Etapa 1: Instalar o OpenClaw
macOS e Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
Ou usando o npm:
npm i -g openclaw
Windows:
npm i -g openclaw
Verificar a instalação:
openclaw --version
Etapa 2: Instalar o plugin da Aiberm
Instale o plugin de provedor da Aiberm:
openclaw plugins install openclaw-aiberm
Ative o plugin:
openclaw plugins enable openclaw-aiberm
Importante: Após ativar, reinicie o gateway para que as alterações tenham efeito:
openclaw gateway restart
Autenticação
Após instalar e ativar o plugin, autentique-se com sua chave de API da Aiberm:
openclaw models auth login --provider aiberm --set-default
Você será solicitado a inserir sua chave de API da Aiberm. Obtenha sua chave de API em https://aiberm.com/console/token.
Se precisar trocar para um modelo diferente, você pode executar novamente openclaw onboard, selecionar Skip for now em Model/auth provider, selecionar aiberm em Filter models by provider e, em seguida, escolher o modelo para o qual deseja trocar na lista de modelos.

Se você estiver em um contêiner Docker em que instalar plugins seja inconveniente, pode consultar diretamente este arquivo de configuração e salvá-lo em
~/.openclaw/openclaw.json.
Modelos disponíveis
O plugin carrega os modelos dinamicamente a partir da API da Aiberm. Aqui estão alguns exemplos:
OpenAI GPT
aiberm/openai/gpt-5.2-codexaiberm/openai/gpt-5.2aiberm/openai/gpt-4.1aiberm/openai/gpt-4oaiberm/openai/gpt-4o-mini
Anthropic Claude
aiberm/anthropic/claude-opus-4.5aiberm/anthropic/claude-sonnet-4.5aiberm/anthropic/claude-haiku-4.5aiberm/anthropic/claude-sonnet-4.5:thinking
Google Gemini
aiberm/google/gemini-3-proaiberm/google/gemini-3-flashaiberm/google/gemini-2.5-pro
DeepSeek
aiberm/deepseek/deepseek-r1aiberm/deepseek/deepseek-v3.2
X.AI Grok
aiberm/x-ai/grok-4.1-fastaiberm/x-ai/grok-code-fast-1
Visite Aiberm Pricing para a lista completa e atualizada dos modelos disponíveis.
Uso
Após a autenticação, você pode começar a usar o OpenClaw. Para um uso detalhado, consulte a documentação do OpenClaw.
Listar os modelos instalados:
openclaw models list | grep aiberm
Variável de ambiente
Você também pode definir a chave de API por variável de ambiente:
export AIBERM_API_KEY=sk-your-api-key
Carregamento dinâmico de modelos
O plugin openclaw-aiberm oferece carregamento dinâmico de modelos:
- Quando o plugin é carregado, ele busca a lista de modelos mais recente na API da Aiberm
- Se a API estiver indisponível, o plugin recorre a uma lista de modelos integrada
- Durante a autenticação, os modelos mais recentes são buscados novamente
Isso significa:
- Novos modelos ficam disponíveis imediatamente, sem atualizações do plugin
- Modelos descontinuados são removidos automaticamente
- As capacidades dos modelos estão sempre atualizadas
Solução de problemas
Erro “No provider plugins found”
Certifique-se de que você:
- Instalou o plugin:
openclaw plugins install openclaw-aiberm - Ativou o plugin:
openclaw plugins enable openclaw-aiberm - Reiniciou o gateway:
openclaw gateway restart
Erros 401/403
- Erro 401: API Key não definida ou inválida
- Erro 403: Permissões insuficientes ou chave expirada
- Verifique sua chave de API em Aiberm Console
O plugin não está carregando
Verifique se o plugin está ativado:
openclaw plugins list
Se não estiver ativado, execute:
openclaw plugins enable openclaw-aiberm
openclaw gateway restart