Can I use my ChatGPT Plus subscription with Hermes Agent?

Yes. Hermes Agent supports the openai-codex provider which authenticates via device-code OAuth and routes requests through your ChatGPT Plus subscription. You get GPT-6.1 Sol access at no extra API cost.

Do I need an API key to use Hermes Agent?

No. OpenClaw Launch includes AI credits and free models. You can also bring your own ChatGPT subscription or API key from OpenAI, Anthropic, Google, or any provider.

How much does it cost to run Hermes Agent with ChatGPT Plus?

ChatGPT Plus costs $20/mo and OpenClaw Launch Lite costs $3 for your first month, then $6/mo — so GPT-6.1 Sol access totals $23 the first month and $26/mo after, with no per-token API charges.

← Home

Guide

Use Your ChatGPT Plus Subscription with Hermes Agent

Already paying $20/mo for ChatGPT Plus? Connect it to your Hermes Agent instance and use GPT-6.1 Sol at zero extra API cost. No separate API key needed.

Running OpenClaw instead of Hermes? See the OpenClaw ChatGPT subscription guide.

How It Works

Hermes Agent supports the openai-codex provider, which routes requests through your ChatGPT subscription instead of the pay-per-token OpenAI API. You authenticate via a device-code OAuth flow, and Hermes uses your subscription's included quota — no API billing.

Cost breakdown: ChatGPT Plus ($20/mo) + OpenClaw Launch Lite ($3 first month, then $6/mo) = GPT-6.1 Sol for $23 your first month, $26/mo after. No per-token API charges.

This page is the reference. If you want the whole thing end to end, from creating the Telegram bot to its first scheduled job, follow turning ChatGPT Plus into a 24/7 Telegram bot.

What You Need

An active ChatGPT Plus ($20/mo) or ChatGPT Pro ($200/mo) subscription
A deployed Hermes Agent instance on OpenClaw Launch

Step 1: Open the Terminal

Go to your Dashboard and find your Hermes Agent instance.
Click the Terminal button to open the web terminal.

Step 2: Run the Auth Command

In the terminal, run:

hermes auth add openai-codex --type oauth

The terminal will print a device code (e.g. V0SZ-CL1YM) and a URL. Open the URL in your local browser — on your computer, not inside the terminal.

Step 3: Approve the OAuth Request

Visit https://auth.openai.com/codex/device in your browser.
Enter the device code shown in the terminal (e.g. V0SZ-CL1YM).
Sign in with the OpenAI account that has your ChatGPT Plus subscription and approve.
Once approved, the terminal will confirm: Added openai-codex OAuth credential #1: "openai-codex-oauth-1". The credential is stored at /opt/data/auth.json inside your container.

Step 4: Switch the Model

Send this command from any connected chat surface — Telegram, Discord, WhatsApp, or the web chat in your Dashboard:

/model gpt-6.1-sol --provider openai-codex --global

Hermes reads the model list live from your ChatGPT account, so it offers whatever your plan serves. We verified GPT-6.1 Sol on Hermes v2026.9.24. If an older instance does not list it yet, use the previous Sol until the instance is updated:

/model gpt-6-sol --provider openai-codex --global

The --provider openai-codex flag is required: it sets model.default to the model you selected and model.provider = openai-codex in your container's config. The change takes effect on the next message — no restart needed.

You can also pick the model from your instance card instead of typing the command: open the model menu and choose it under the OpenAI row badged Subscription, which lists the models your ChatGPT plan serves.

Step 5: Verify It Works

Send a message to your bot on Telegram, Discord, or whichever platform you connected. On a current Hermes release, the response should come from GPT-6.1 Sol via your subscription. You can also check the active model and credential status with:

hermes auth list

Available Models

Model ID	Model	Best For
`gpt-6.1-sol`	GPT-6.1 Sol	Coding and everyday agent work, recommended
`gpt-6-astra`	GPT-6 Astra	The hardest tasks, where your plan includes it
`gpt-6-sol`	GPT-6 Sol	Previous-generation workhorse
`gpt-6-luna`	GPT-6 Luna	Fast, efficient high-volume tasks

Important Notes

Weekly quota limits: ChatGPT Plus has a weekly usage cap for Codex access. Heavy usage may hit limits before the week resets.
Token refresh: OpenAI uses rotating refresh tokens. Occasionally you may need to re-run the auth command if the session expires.
For production workloads: If you need guaranteed uptime and no quota limits, consider using an OpenAI API key instead.

Other Ways to Bring Your Own Key

Don't have ChatGPT Plus? You can still bring your own API key from any provider:

OpenAI API — Pay-per-token, no subscription needed
Anthropic Claude — Claude Sonnet 4.6, Opus 4.6
OpenRouter — Access 200+ models with one key
DeepSeek — Low-cost coding and reasoning

Or skip API keys entirely — OpenClaw Launch includes AI credits and free models out of the box.

Troubleshooting

Auth command shows no device code

Make sure you're running hermes auth add openai-codex --type oauth (not the OpenClaw command). The terminal must be the Hermes web terminal, accessible from the Dashboard.

Token refresh errors

If your credential stops working, re-run:

hermes auth add openai-codex --type oauth

This replaces the stored credential at /opt/data/auth.json.

Quota exceeded

ChatGPT Plus has weekly limits. If you hit the cap, your bot will return errors until the quota resets. Upgrade to ChatGPT Pro ($200/mo) for higher limits, or switch to an API key for unlimited usage.