Hermes Agent

Hermes Agent: Phone and schedules

This is page 4 of 8 in the Hermes Agent guide. It connects Hermes to a chat app on your phone and sets up scheduled jobs, then weighs each setting that trades safety for capability.

Wait until the first job on page 2 looked right. Facts here were checked on 14 November 2026.

Your phone and schedules

Hermes does not install on your phone. Instead, you chat with a bot inside an app like Telegram, and that bot talks to the Hermes gateway on your computer.

The computer must stay on. If your computer sleeps, or the gateway is closed, the phone bot does not answer and scheduled jobs do not run. Hermes Cloud keeps an agent running for you, but it comes with paid Nous Portal plans, and Plus, at $20 a month, includes one.

Telegram is the easiest bot. The desktop app has a "Create with QR" option. From a terminal, the commands are hermes gateway setup, then hermes gateway start.

Allow only yourself. When a stranger messages your bot, Hermes sends them a pairing code instead of answering. Approve only a code you asked for yourself, with hermes pairing approve <platform> <code>. You can also put only your own Telegram user ID in the .env file as TELEGRAM_ALLOWED_USERS. To find your user ID, send any message to @userinfobot in Telegram. In the desktop app, Create with QR fills it in for you. Never set GATEWAY_ALLOW_ALL_USERS.

Skip WhatsApp. Hermes's built-in WhatsApp link pretends to be WhatsApp Web, and Hermes's own docs say this can get the number banned. If you try it anyway, use a spare phone number, not your own.

Schedules. You can ask in plain words, like "every morning at 9, send me a summary." You can also type a command, for example:

/cron add "every 2h" "Check server status"

Cron is the name for scheduled jobs, and the gateway checks for due jobs every 60 seconds. If a scheduled job tries a dangerous command, Hermes blocks it by default, so leave it that way.

In a phone chat, type /new now and then, because otherwise one long chat keeps growing and gets more expensive.

What you should see your bot answers only you, and a scheduled job shows up in your chat while the computer is on.

Trade-offs: safety versus capability

Approval mode. The setting approvals.mode decides who answers when a command matches Hermes's dangerous list. With manual you answer every time, and with off nobody is asked at all. With smart, the default, a second model allows the command, blocks it, or asks you.

Starting folder. The setting terminal.cwd decides where scheduled jobs and phone chats start, and HERMES_WRITE_SAFE_ROOT, when set to a folder, stops Hermes's two file-writing tools from saving outside it. This guide could not confirm how to set it in the desktop app.

Skill writes. With skills.write_approval: true, new skills wait for /skills approve, while the default lets Hermes write and rewrite its own skills freely.

Local or Docker backend. The setting terminal.backend decides where commands run. With local, the default, they run on your real computer with "no isolation." With docker, they run inside a container, and Hermes turns its approval questions off because the container is the wall.

Phone chat and schedules. The gateway lets you message Hermes from Telegram and runs scheduled jobs, but only while it is running on a computer that stays on. Scheduled jobs that hit a dangerous command are blocked by default.

For the three questions behind this advice, see Safety versus capability.

Sources

Research in this repo:

Official Hermes pages (checked 14 November 2026):

Next

Continue to Nine jobs for Hermes.

Checked 14 November 2026 · prices, limits, and versions change