My bot stopped replying

1. Check the laptop is awake, online and plugged in. 2. Try this in your private bot chat. A stopped gateway cannot receive it. /restart 3. Mac: press Command + Space, then open Terminal. Windows: open Start and search PowerShell. 4. Restart the gateway. Spell h-e-r-m-e-s. hermes gateway restart 5. If it says no gateway is running, start it. hermes gateway start 6. If still silent, run the health check. Cover secrets before sharing its output. hermes doctor

A different bot answered me.

1. Open Saved Messages. 2. Copy your own bot's exact @username into Telegram search. Open that bot's private chat.

It answers me but not in my Telegram group.

1. Use the Telegram group guide when your trainer asks. 2. Check the same bot is a group administrator first. Do not change privacy mode unless confirmed.

It says no gateway was running

1. Open Terminal or PowerShell on your laptop. 2. Start the gateway. hermes gateway start 3. Keep the window open until it reports its result. Send hi to your bot from the phone. 4. If a Y/N question appears, read the full question first. Do not guess.

Where do I find Terminal or PowerShell?

1. Mac: press Command+Space. Type Terminal. Press Enter. 2. Windows: open Start. Type PowerShell. Open Windows PowerShell. 3. Paste the command using this guide’s Copy button. Check h-e-r-m-e-s before pressing Enter.

I typed hermas gateway

1. The name is h-e-r-m-e-s, not hermas. 2. Use this guide’s copy button for the restart command. hermes gateway restart

I click Y ya? Windows asks Y/N

1. Read the complete question above Y/N. 2. Y means yes. N means no. The question determines what you are agreeing to. 3. If it asks about an unfamiliar change, stop and send Sean the wording with secrets covered.

Can I use my phone to talk to the bot?

1. Yes. Telegram on your phone sends messages to the agent on your laptop. 2. The laptop must stay awake, online and running its gateway. 3. Telegram Web cannot wake a sleeping laptop.

What do Allow Once, Session and Always mean?

1. Read the action first. Choose Always tonight for actions you understand. 2. Always means your agent won’t ask again for this kind of action. 3. Allow Once runs it once; Session remembers this conversation; Deny stops it. 4. Money, deleting or messaging others? Choose Deny and ask in the workshop.

The bot is still silent after gateway start

1. Run the read-only health check on your laptop. hermes doctor 2. Read the result. Cover tokens, login details and personal data before sharing a photo. 3. Ask ChatGPT if available, or send Sean the covered photo.

Doctor suggests --fix

1. hermes doctor --fix changes your setup. 2. Use the read-only hermes doctor result first. 3. Ask Sean before running the repair option. It may alter settings.

I am using a company laptop

1. Stop if the laptop is managed by your company. 2. Ask your company administrator or Sean about an approved computer. Do not bypass its restrictions.

My bot does not reply privately either

1. Open the same bot’s private chat. Send hi. 2. If silent there too, fix the host laptop and gateway before changing group settings. 3. Follow My bot stopped replying.

My bot has no access to messages

1. Open the group’s Administrators list. 2. Select your own bot as an administrator. Follow Phase 3 for your selected device. 3. Keep extra rights off. Test hi in General again.

Telegram will not let me add my bot

1. Open the official @BotFather chat. 2. Send /setjoingroups. Choose your bot. 3. Choose Enable when offered. Wait for confirmation. 4. Return to the group and try Add Members again.

My main agent confirmed privacy mode is the problem

1. Use this branch only after your trainer or main agent confirms privacy mode is the cause. 2. Open @BotFather. Send /setprivacy and select your bot. 3. Choose Disable. Wait for confirmation. 4. Remove the bot from this group. Add the same bot again. 5. Restore its administrator role with extra rights off. Test hi in General.

The right admin bot is still silent in the group

1. Tell your main agent privately the group name, bot username and whether a tagged hi worked. 2. Ask it to check group authorization and mention requirements. 3. Never send a token. On Windows, it must ask you before any gateway restart.

1. Open your group’s settings using your selected device path. 2. Look for Topics. The owner or an administrator must change this setting. 3. If your screen differs, send Sean a covered photo. Do not alter Hermes settings.

I cannot access settings on Android

1. Open the group. Tap its name at the top. 2. Tap the pencil. 3. Open Topics or Administrators, depending on your phase.

I am stuck getting the group ID

1. The main path does not require you to find a group ID. 2. Tell your main agent the group name, bot username and General test result privately. 3. Ask whether it truly needs an ID. If still required, ask Sean. Do not guess.

Plain hi fails, but @botusername hi works

1. The bot may require a mention in this group. 2. Use @ followed by your own bot’s exact username, then hi. 3. Tell your main agent the plain and tagged results privately. Do not change privacy as the first fix.

How do I make the bot admin on iPhone?

1. Open the group. Tap its name. 2. Tap Edit. Open Administrators. 3. Tap Add Admin. Choose the correct bot. 4. Keep Admin Rights on and extra rights off. 5. Tap Add Bot as Admin if shown. Tap Done.

The agent asks me for a token inside the group

1. Do not send any token in the group or the private bot chat. 2. Use your main bot’s token only in Hermes settings on the host laptop. 3. Sub-agent tokens are workshop material. Ask your trainer if blocked.

1. Open your group settings. 2. Open Group Type. Choose Private for this workshop group. 3. Do not add strangers or publish its invite link.

What are helper bots or sub-agents?

1. Helper agents handle separate jobs for your main agent. 2. Bring your working main bot. Keep helper tokens out of every chat. 3. Do not create extra bots tonight. 4. We set this up together in the workshop.

Where is the command for sub-topics?

1. Topics organise separate chats within one group. 2. The group guide prepares General and Ideas. Your trainer introduces the larger structure. 3. Bring one example of work you want organised. 4. We set this up together in the workshop.

What is a second brain?

1. A second brain is an organised place for useful business knowledge. 2. Bring one non-sensitive note or repeated business question. 3. Keep private client files out until the trainer explains the storage choices. 4. We set this up together in the workshop.

What should my agent remember?

1. Memory helps the agent keep useful context between tasks. 2. Bring a short business description and the preferences you want it to remember. 3. Do not change memory settings before class. 4. We set this up together in the workshop.

What is a brief or debrief?

1. A brief explains the task and the result you want. 2. A debrief reviews what happened and what to improve. 3. Bring one real task with a clear outcome. 4. We set this up together in the workshop.

Can my agent build a website? What about Vercel or Netlify?

1. Website tools build and host pages on the internet. 2. Bring your website goal, approved wording and a few reference links. 3. Do not buy hosting, change domains or enter payment details tonight. 4. We set this up together in the workshop.

Can it connect to SQL or accounting APIs?

1. An API is a supported connection between software systems. 2. Bring the software name and the task you need. 3. Ask your administrator about a test account. Keep credentials out of chats. 4. We set this up together in the workshop.

Can it log into banking or insurance sites?

1. Account actions can expose private information or affect money. 2. Bring the workflow description without passwords, account numbers or client details. 3. Do not give an agent financial-site access tonight. 4. We set this up together in the workshop.

Do I need VPN, IP or SSH setup?

1. These tools control network access or remote computers. 2. Bring the connection goal and your administrator’s approved requirements. 3. Do not change network or remote-access settings tonight. 4. We set this up together in the workshop.

Can it use HeyGen or make videos?

1. Video tools turn approved content into video assets. 2. Bring the intended audience and an approved script. 3. Avoid buying a new plan or uploading personal photos before the trainer explains the workflow. 4. We set this up together in the workshop.

Should I install skills before the workshop?

1. Skills give the agent reusable instructions for a task. 2. Bring one repeated task you want help with. 3. Do not install random skills or change tools before class. 4. We set this up together in the workshop.

How do I make my bot admin on Telegram Desktop?

1. Open the group’s three-dot menu. Click Manage group. 2. Open Administrators. Click Add Administrator. 3. Choose your own bot. Keep extra rights off. 4. Click Save.

Put your bot in a Telegram group

Also in: 中文Bahasa Melayu

Where will you create the group?

Your agent lives on your laptop

Four phases, then a final check. Your bot must already reply privately.

Your phone · Telegram↕Telegram↕Your laptop · Hermes · stay awake↕ChatGPT · the brain

Never paste a bot token in a group. Helper bots are workshop material.

Join a free AI agent class

Learn what an AI agent can do for your business.

Create your group

Create one private group with your existing bot.

You’ll needTelegram and your working bot

Never paste a bot token in a group. Helper bots are workshop material.

Tap New Message (the pencil) in the top-right corner.
A menu appears.

Telegram’s new-message menu shows New Group.Your screen may look a little different.Tap the image to enlarge
Done
Tap New Group.
Telegram opens the member search screen.
Done
Tap Search and type the bot's exact @username.
The matching bot appears.

Telegram search shows the matching bot username.Your screen may look a little different.Tap the image to enlarge
Done
Tap the matching bot.
The bot is selected.
Done
Tap Next.
Telegram opens the group name screen.
Done
Type My Agent Group.
The name appears in the name box.
My Agent Group

The new-group screen has the name field and Create button.Your screen may look a little different.Tap the image to enlarge
Done
Tap Create.
The new group opens.
Done
Tap the group photo or name at the top.
The group information page opens.
Done
Tap Edit.
The next control appears.
Done
Tap Group Type.
The group type page opens.
Done
Choose Private.
The next control appears.
Done
Tap Done.
The group stays private and has no public username or public link.
Done
Tap the circular pencil button.
A menu appears.

Telegram’s new-message menu shows New Group.Your screen may look a little different.Tap the image to enlarge
Done
Tap New Group.
Telegram opens the member search screen.
Done
Tap Search and type the bot's exact @username.
The matching bot appears.

The member picker shows the bot search results.Your screen may look a little different.Tap the image to enlarge
Done
Tap the matching bot.
The bot is selected.
Done
Tap the arrow in the bottom-right corner.
Telegram opens the group name screen.
Done
Type My Agent Group.
The name appears in the name box.
My Agent Group

The new-group screen has the name field and Create button.Your screen may look a little different.Tap the image to enlarge
Done
Tap the checkmark in the bottom-right corner.
The new group opens.
Done
Tap the group name at the top.
The group information page opens.
Done
Tap the pencil.
The next control appears.
Done
Tap Group Type.
The group type page opens.
Done
Choose Private.
The next control appears.
Done
Tap the checkmark.
The group stays private and has no public username or public link.
Done
Click the menu button in the top-left corner.
The Telegram Desktop menu opens.

Telegram’s new-message menu shows New Group.Your screen may look a little different.Tap the image to enlarge
Done
Click New Group.
The group name dialog opens.
Done
Type My Agent Group.
The next control appears.
My Agent Group
Done
Click Next.
The Add Members dialog opens.

Telegram’s group-name dialog has a name field.Your screen may look a little different.Tap the image to enlarge
Done
Click Add Members and type the bot's exact @username.
The matching bot appears.
Done
Click the matching bot.
The bot is selected.
Done
Click Create.
The new group opens.

The Desktop member picker shows matching bots.Your screen may look a little different.Tap the image to enlarge
Done
Click the three-dot button in the top-right corner.
The next control appears.
Done
Click Manage group.
The group management panel opens.
Done
Click Edit group.
The next control appears.
Done
Click Group Type.
The group type setting opens.

The group settings dialog includes Group Type and Topics.Your screen may look a little different.Tap the image to enlarge
Done
Choose Private.
The next control appears.
Done
Click Save.
The group has no public username or public link.
Done

Can you see this?

Can you see your bot in My Agent Group?

Turn on Topics and add Ideas

Topics are smaller chats inside your group. Create one called Ideas.

You’ll needTelegram and your working bot

Tap the group photo or name at the top.
The group information page opens.
Done
Tap Edit.
The next control appears.
Done
Tap Topics.
The Topics setting opens.
Done
Turn on Enable Topics.
Telegram shows the topic view choice, if your version asks for one.
Done
Choose List when Telegram asks how to show topics.
The group returns to a list of topics.
Done
Open the topic menu and tap New Topic.
A topic name box appears.

The topic menu shows New Topic.Your screen may look a little different.Tap the image to enlarge
Done
Type Ideas.
The next control appears.
Ideas
Done
Tap Create.
The Ideas topic opens.
Done
Tap Back once to return to the topic list.
General and Ideas are both listed.
Done
Tap the group name at the top.
The group information page opens.
Done
Tap the pencil.
The next control appears.
Done
Tap Topics.
The Topics setting opens.
Done
Turn on Enable Topics.
Telegram shows the topic view choice, if your version asks for one.
Done
Choose List when Telegram asks how to show topics.
The group returns to a list of topics.
Done
Open the topic menu and tap New Topic.
A topic name box appears.
Done
Type Ideas.
The next control appears.
Ideas
Done
Tap CREATE.
The Ideas topic opens.

The Android group settings include the Topics switch.Your screen may look a little different.Tap the image to enlarge
Done
Tap Back once to return to the topic list.
General and Ideas are both listed.
Done
Click the three-dot button.
The next control appears.
Done
Click Manage group.
The group management panel opens.
Done
Click Edit group.
The next control appears.
Done
Click Topics.
The Topics setting opens.

The group settings dialog includes Group Type and Topics.Your screen may look a little different.Tap the image to enlarge
Done
Turn on Enable Topics.
The next control appears.
Done
Click Save.
The group uses Topics.
Done
Click CREATE NEW TOPIC.
The new topic form opens.

The Desktop Topics dialog has an enable switch.Your screen may look a little different.Tap the image to enlarge
Done
Type Ideas.
The next control appears.
Ideas
Done
Click the checkmark.
The Ideas topic opens.
Done
Click General or the back arrow to return to the topic list.
General and Ideas are both listed.
Done

Can you see this?

Can you see General and Ideas?

Give your bot group access

Administrator access lets the bot receive your group messages.

You’ll needTelegram and your working bot

Tap the group photo or name.
The next control appears.
Done
Tap Edit.
The group settings open.
Done
Tap Administrators.
The administrator list opens.
Done
Tap Add Admin.
The next control appears.
Done
Select the correct bot @username.
The bot rights page opens.

The bot’s administrator screen shows its permissions.Your screen may look a little different.Tap the image to enlarge
Done
Keep Admin Rights on.
The bot can receive group messages.
Done
Leave extra rights off.
Keep Change Group Info, Delete Messages and Ban Users off. Keep Invite Users via Link and Pin Messages off. Keep Manage Video Chats, Remain Anonymous and Add New Admins off.
Done
Tap Add Bot as Admin.
The next control appears.
Done
Tap Done.
The bot appears in the administrator list.
Done
Tap the group name.
The next control appears.
Done
Tap the pencil.
The group settings open.
Done
Tap Administrators.
The administrator list opens.
Done
Tap Add Administrator.
The next control appears.
Done
Select the correct bot @username.
The Admin Rights page opens.

The bot’s administrator screen shows its permissions.Your screen may look a little different.Tap the image to enlarge
Done
Keep the administrator switch on.
The bot can receive group messages.
Done
Leave extra rights off.
Keep Change Group Info, Delete Messages and Ban Users off. Keep Invite Users via Link and Pin Messages off. Keep Manage Video Chats, Remain Anonymous and Add New Admins off.
Done
Tap the checkmark.
The bot appears in the administrator list.
Done
Click the three-dot button.
The next control appears.
Done
Click Manage group.
The group management panel opens.
Done
Click Administrators.
The administrator list opens.
Done
Click Add Administrator.
The next control appears.
Done
Select the correct bot @username.
The administrator rights page opens.

The bot’s administrator screen shows its permissions.Your screen may look a little different.Tap the image to enlarge
Done
Keep administrator access on.
The bot can receive group messages.
Done
Leave extra rights off.
Keep Change Group Info, Delete Messages and Ban Users off. Keep Invite Users via Link and Pin Messages off. Keep Manage Video Chats, Remain Anonymous and Add New Admins off.
Done
Click Save.
The bot appears in the administrator list with access to messages.
Done

Can you see this?

Is the correct bot listed in Administrators?

Test in General

Test whether your bot answers in General.

You’ll needTelegram and your working bot

Open General.
The main group chat opens.
Done
Tap the message box.
The keyboard opens.
Done
Type hi.
hi appears in the message box.
hi
Done
Tap Send.
Your hi message appears in General.
Done
Wait up to one minute.
A reply from the correct bot appears below your message.
Done
Open General.
The main group chat opens.
Done
Tap the message box.
The keyboard opens.
Done
Type hi.
hi appears in the message box.
hi
Done
Tap Send.
Your hi message appears in General.
Done
Wait up to one minute.
A reply from the correct bot appears below your message.
Done
Click General.
The main group chat opens.
Done
Click the message box.
The cursor appears in the message box.
Done
Type hi.
hi appears in the message box.
hi
Done
Press Enter or click Send.
Your hi message appears in General.
Done
Wait up to one minute.
A reply from the correct bot appears below your message.

The group chat shows the bot’s reply.Your screen may look a little different.Tap the image to enlarge
Done

Can you see this?

Did the bot reply in General?

You’re done 🎉

Your group is ready for the workshop.

Take a screenshot of the reply in General.

Attach a photo with tokens and personal details covered.

Bring it to the workshop.

Your trainer will guide helper bots and the next topics.

Open the setup guide

Join a free AI agent class

Learn what an AI agent can do for your business.

Install Hermes Agent and get your bot replying Put your bot in a Telegram group Help centre Join a free AI agent class

Never send tokens, passwords, login codes or card numbers to anyone’s chat.