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, Windows 10/11 ou WSL2
- Um modelo com janela de contexto mínima de 64K para uso de ferramentas
Instalação
Instalar o Hermes Agent
- Desktop (macOS / Windows)
- Linux / macOS / WSL2
- Windows PowerShell
A Hermes recomenda o instalador Desktop no macOS e no Windows. Baixe o Hermes Desktop e execute o instalador do seu sistema.
O WSL2 continua compatível, mas é opcional. Use-o quando precisar de um ambiente Linux ou do terminal incorporado do Web Dashboard.
Referência rápida de recursos
Configuração manual
Use a configuração interativa de modelo do Hermes Agent como caminho principal. Edite os arquivos de configuração diretamente apenas quando precisar de uma configuração manual.Configuração
- Configuração interativa
- Arquivos de configuração
1
Execute o seletor de modelos
Saia de qualquer chat Hermes ativo e execute:
2
Escolha Custom endpoint
Selecione Custom endpoint (self-hosted / VLLM / etc.) na lista de provedores.
3
Preencha a configuração da BetterToken
Informe:
- Base URL:
https://bettertoken.ai/v1 - API Key: sua BetterToken API Key
- Model: um ID de modelo de um provedor compatível copiado da model plaza
4
Inicie o Hermes Agent
hermes para usar a interface de terminal clássica.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://bettertoken.ai/v1, à sua BetterToken API Key e a um ID de modelo de um provedor compatível.
Verifique a conexão
Iniciehermes --tui ou hermes e envie Reply with HERMES_OK only. Do not use tools.. A conexão funciona quando o Hermes retorna HERMES_OK sem erro de autenticação, endpoint ou ID de modelo.
Alterne entre modelos
Executehermes model fora do chat para adicionar ou reconfigurar um provedor. No chat, use /model para alternar entre provedores e modelos já configurados.
Erros comuns
Solução de problemas
- Se as solicitações falharem ou não retornarem resposta, confirme que Base URL é exatamente
https://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://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.