Qual chave de provedor de IA usar com o Hermes Agent

Resposta curta. O Hermes Agent não inclui um modelo: ele precisa de uma conta em um provedor de IA. Na PlayNHost você cola uma chave de API da OpenAI, Anthropic, Google Gemini, xAI ou OpenRouter, e uma chave basta. O Hermes Agent escolhe o provedor pela chave, e você escolhe o modelo pelo chat com /model. Se quiser muitos modelos com uma chave e uma fatura, use a OpenRouter. Seu provedor cobra diretamente pelo uso do modelo; o plano do servidor não inclui isso.

Verificado em 7 de novembro de 2026, correto para o Hermes Agent v0.23.0.

Este guia usa a documentação de provedores e de configuração do Hermes Agent, o código-fonte da v0.23.0 onde a documentação é omissa, e o painel da PlayNHost como ele funciona hoje.

As cinco chaves que o painel aceita

Uma chave de API é cobrada por uso. Uma assinatura de consumidor não é a mesma coisa: a documentação do Hermes Agent diz que um plano Claude Pro não pode ser usado pelo login dele, e que a alternativa aceita é uma chave de API da Anthropic, cobrada por token.

Qual escolher

• Você já paga um provedor: use essa chave.
• Você quer testar vários modelos: a OpenRouter reúne muitos provedores atrás de uma chave e uma fatura. A própria documentação do Hermes Agent a lista como “recommended for flexibility” (recomendada pela flexibilidade).
• Você está pensando em um plano gratuito: a documentação do Hermes Agent alerta que uma chave gratuita do Google Gemini pode acabar depois de poucos turnos do agente, porque uma mensagem sua pode gerar várias chamadas ao modelo. Outras cotas gratuitas pequenas acabam pelo mesmo motivo.
• O modelo precisa de um contexto grande. O Hermes Agent exige pelo menos 64.000 tokens de contexto e recusa janelas menores na inicialização. Confira a janela de contexto do modelo que escolher, principalmente se for pequeno.
• Não disponível na PlayNHost: o Nous Portal e outros logins (uma conta do ChatGPT, Claude Max ou SuperGrok) precisam de hermes model ou hermes setup em uma linha de comando, e modelos locais (Ollama, LM Studio) precisam de um servidor de modelos que o plano não inclui. O painel aceita chaves de API.

Adicione a chave na PlayNHost

1. Abra o seu servidor em panel.playnhost.com e depois a aba Agente.
2. Em Provedor de IA (“Uma chave basta. Cada provedor cobra na sua própria conta o que o seu agente usa.”), clique em Definir na linha do seu provedor, cole a chave e clique em Salvar. A linha passa a mostrar só os quatro últimos caracteres. A chave é guardada criptografada e nunca mais é exibida; Substituir e Remover a alteram depois.
3. Adicione um token de bot do Telegram ou do Discord se ainda não fez isso (Telegram, Discord) e depois inicie ou reinicie o agente: “As alterações valem na próxima vez que o seu agente iniciar.”

A chave chega ao Hermes Agent pelo ambiente dele, com o nome da tabela. O Hermes Agent guarda uma impressão digital dela em auth.json, não a chave em si (conferimos isso em um servidor de teste).

Escolha o modelo pelo chat

A PlayNHost não tem um campo de modelo para o Hermes Agent: você escolhe no chat, com o comando do próprio Hermes Agent.

• Envie /model ao seu bot. No Telegram ele abre um seletor: primeiro os provedores de que você tem chave, depois os modelos deles. O modelo atual aparece no topo.
• Se você sabe o nome do modelo, envie /model <name>. Acrescente --global para mantê-lo também nas novas conversas.
• /model só alterna entre provedores de que você tem chave. Para outro provedor, adicione a chave dele na página Agente e reinicie.

A documentação do Hermes Agent acrescenta uma observação de custo: trocar de modelo no meio de uma conversa longa faz a próxima mensagem reler a conversa inteira a preço cheio, porque o cache de prompts do provedor pertence ao modelo antigo. Troque cedo, ou depois de /new.

Várias chaves ao mesmo tempo

Você pode definir mais de uma. Quando nenhum provedor foi escolhido nas configurações do Hermes Agent, o código da v0.23.0 pega primeiro uma chave da OpenRouter; sem ela, pega o primeiro provedor com chave na lista embutida dele. Para evitar surpresas, mantenha uma só chave, ou escolha o provedor com /model.

Mantenha a fatura sob controle

• Quem cobra é o seu provedor, não nós. A PlayNHost não revende o uso de modelos nem o soma à sua fatura; o plano paga o servidor.
• Defina um limite de gasto ou um alerta de orçamento no seu provedor. O Hermes Agent pode executar tarefas agendadas sozinho, e cada execução usa a sua chave enquanto você não está olhando.
• Tarefas secundárias usam o seu modelo principal. Por padrão o Hermes Agent envia as tarefas secundárias dele (compactação de contexto, leitura de imagens, títulos de sessão, avaliação de se um comando é arriscado) ao seu modelo principal. A documentação observa que, com um modelo caro, elas somam um custo significativo.
• Só você pode falar com ele. As listas de IDs de usuário da página Agente impedem que desconhecidos gastem os seus créditos.

Na sua própria máquina

Rode hermes model para escolher provedor e modelo (ele pede a chave ou executa o login do provedor), ou coloque a chave em ~/.hermes/.env:

OPENROUTER_API_KEY=sk-or-...

Depois reinicie o gateway. Veja como rodar o Hermes Agent 24/7, ou crie um servidor Hermes Agent e cole a sua chave no painel.

A PlayNHost não é afiliada à Nous Research. O Hermes Agent é um software de código aberto sob a licença MIT.