Configurações principais
Pré-requisitos
- A versão atual da ferramenta está instalada
- Uma BetterToken API Key: cadastre-se e crie uma
- Um ID de modelo da model plaza
Requisitos adicionais
- O ID de modelo selecionado vem de um provedor compatível
- macOS, Linux, or Windows WSL2
Instalação
Instalar o Hermes Agent
- macOS / Linux / WSL2
- Windows
Referência rápida de recursos
Configuração manual
Use a configuração interativa de modelo do Hermes Agent como caminho principal. Comandos e variáveis de ambiente continuam disponíveis como alternativas.Configuração
- Configuração interativa
- Configuração por CLI
- Variáveis de ambiente
1
Execute o seletor de modelos
2
Escolha o provedor OpenAI ou OpenAI Compatible
Selecione OpenAI ou OpenAI Compatible na lista de provedores.
3
Preencha a configuração da BetterToken
Informe:
- Base URL:
https://www.bettertoken.ai/v1 - API Key: sua BetterToken API Key
- Model: um ID de modelo de um provedor compatível copiado da model plaza
4
Reinicie o Hermes Agent
Após atualizar a configuração, encerre a sessão atual do Hermes Agent e inicie-a novamente.
5
Inicie o Hermes Agent
Migre do OpenClaw
Se você já usa OpenClaw, primeiro verifique se a versão atual do Hermes Agent oferece o comando de migração. Execute uma simulação antes de alterar algo.https://www.bettertoken.ai/v1, à sua BetterToken API Key e a um ID de modelo de um provedor compatível.
Verifique a conexão
Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.Alterne entre modelos
Abra o seletor de modelos ou altere o campoModel na configuração. Use o ID de modelo exato da model plaza e reinicie a sessão atual.
Erros comuns
Solução de problemas
- Se as solicitações falharem ou não retornarem resposta, confirme que Base URL é exatamente
https://www.bettertoken.ai/v1. Não acrescente/chat/completionsnesse campo. - Se o Hermes informar que o modelo não existe, confirme que Model é um ID de modelo de um provedor compatível da model plaza.
- Se a autenticação falhar, verifique espaços copiados e confirme que o ID de modelo selecionado vem do provedor compatível.
- Se o Hermes continuar usando o modelo antigo após uma alteração, encerre a sessão atual do Hermes Agent e execute
hermesnovamente. - A BetterToken geralmente não exige
User-Agentadicional nem cabeçalhos personalizados. Adicione cabeçalhos somente quando o gateway personalizado, roteamento de tenant, observabilidade ou camada de cache exigir explicitamente.
Não envie API Keys reais ao repositório. Para configurações compartilhadas pela equipe, prefira variáveis de ambiente ou configuração local.
FAQ relacionada
- MCP vs. API Key e Base URL
- O que são model_provider, base_url e wire_api?
- Como configurar uma API compatível com OpenAI no Cline
- Guia de configuração da BetterToken no OpenClaw
Advanced setup
Provedores compatíveis
Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
O que significa cada método de configuração
O que significa cada método de configuração
- Configuração manual: informe a API Key, a Base URL e o Model.
- Sem suporte: ainda não há um método verificado de conexão direta.
Detalhes técnicos
Protocolo, endpoint e campos internos do provedor
Protocolo, endpoint e campos internos do provedor
Esta configuração usa
https://www.bettertoken.ai/v1. A ferramenta acrescenta o caminho de endpoint compatível com OpenAI. Não adicione /chat/completions ou /responses, exceto quando um campo específico exigir isso.