Connect Hermes Agent to LLMEasy with a custom model

Hermes Agent is an AI agent for local terminal workflows. You can use it as a daily development assistant, or combine skills, MCP, scheduled tasks, and subagents for longer automation work. When connecting LLMEasy, use a GPT Key group API Key and call models through the OpenAI-compatible endpoint.

This page only covers the GPT Key group setup for Hermes Agent. Copy model IDs from the model plaza.

Prerequisites

LLMEasy API Key (register here)
The API Key belongs to the GPT Key group
A GPT Key group model ID copied from the model plaza
macOS, Linux, or Windows WSL2

Install Hermes Agent

macOS / Linux / WSL2
Windows

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Setup

Interactive setup
CLI config
Environment variables

Run the model selector

hermes model

Choose the OpenAI or OpenAI Compatible provider

Select OpenAI or OpenAI Compatible from the provider list.

Fill in the LLMEasy config

Enter:

Base URL: https://www.llmeasy.ru/v1
API Key: your LLMEasy API Key
Model: a GPT Key group model ID copied from the model plaza

Restart Hermes Agent

After updating the config, quit the current Hermes Agent session and start it again.

Start Hermes Agent

hermes

If you prefer copy-paste commands, write the Hermes Agent config directly.

hermes config set llm.provider openai
hermes config set llm.base_url "https://www.llmeasy.ru/v1"
hermes config set llm.api_key "YOUR_LLMEASY_API_KEY"
hermes config set llm.model "YOUR_GPT_MODEL_ID"

Replace YOUR_LLMEASY_API_KEY with your LLMEasy API Key, and replace YOUR_GPT_MODEL_ID with a GPT Key group model ID from the model plaza.Then start Hermes Agent:

hermes

If you do not want to store the API Key in the Hermes Agent config, export it in the current shell.

export OPENAI_API_BASE="https://www.llmeasy.ru/v1"
export OPENAI_API_KEY="YOUR_LLMEASY_API_KEY"
export HERMES_MODEL="YOUR_GPT_MODEL_ID"
hermes

These variables only apply to the current shell session. Export them again in a new terminal, or add them to your own shell profile.

Feature quick reference

Feature	What it is for
Terminal UI	Chat with the agent directly in your terminal
Skills	Save reusable workflows for repeated tasks
MCP	Connect local or remote tool capabilities
Scheduled tasks	Run timed jobs and recurring workflows
Subagents	Split complex work across focused agents
Message gateway	Connect the agent to more message entry points

Migrate from OpenClaw

If you already use OpenClaw, first check whether your current Hermes Agent version provides the migration command. Run a dry run before changing anything.

hermes claw migrate --dry-run

After you confirm the output, run the migration:

hermes claw migrate

After migration, still review the Hermes Agent Base URL, API Key, and model ID. They should match https://www.llmeasy.ru/v1, your LLMEasy API Key, and a GPT Key group model ID.

Troubleshooting

If requests fail or return no response, confirm that Base URL is exactly https://www.llmeasy.ru/v1. Do not append /chat/completions in this field.
If Hermes reports that the model does not exist, confirm that Model is a GPT Key group model ID from the model plaza.
If authentication fails, check for copied spaces and confirm that the API Key belongs to the GPT Key group.
If Hermes still uses the old model after a change, quit the current Hermes Agent session and run hermes again.
LLMEasy usually does not require an extra User-Agent or custom headers. Only add headers when your custom gateway, tenant routing, observability, or caching layer explicitly requires them.

Do not commit real API Keys to your repository. For team-shared setup, prefer environment variables or local config.

​Prerequisites

​Install Hermes Agent

​Setup

​Feature quick reference

​Migrate from OpenClaw

​Troubleshooting

​Related FAQ

Prerequisites

Install Hermes Agent

Setup

Feature quick reference

Migrate from OpenClaw

Troubleshooting

Related FAQ