Let other people chat with your agent

It's simple.

Add your teammates' Telegram user IDs and they're in. The exact path depends on which kind of agent you have — pick yours below.

Which kind of agent do you have?

SUPERCLAWS has two agent flavours and they handle multi-user access differently. Use the picker below to find yours.

Hermes
Managed by SUPERCLAWS

You set up your agent at app.superclaws.io and we run it for you. If the agent's menu in your dashboard shows User Access, you have a Hermes agent. Use the green steps below →

OpenClaw
Self-hosted by you

You run the agent yourself with the openclaw command on your own machine. If you have an openclaw.json file and the openclaw CLI installed, you have an OpenClaw agent. Use the blue steps below →

Hermes — User Access menu

Hermes

Add teammates from your dashboard

1
Open your dashboard

Go to app.superclaws.io and find your agent in the list.

2
Open the menu → User Access

A small modal pops up titled User Access — <your agent name>.

3
Enter the Primary Telegram User ID

This is usually you — the person who owns the agent. If your Telegram is already linked, it may be pre-filled.

4
Add teammates in Additional Telegram User IDs and click Save

Comma-separate multiple IDs (e.g. 1948372650, 9876543210). The change rolls out in a few seconds — no restart needed on your end.

OpenClaw — Pairing code

OpenClaw

Pair each teammate from your terminal

1
Ask your teammate to message your bot

They open Telegram, find your bot, and send any message — even just "hi". They don't need an account on SUPERCLAWS.

2
The bot replies with a pairing code

A short code (8 characters, like ABCD5678). Have them send it to you. Codes expire after one hour.

3
Approve the code from your terminal

Run this command on the machine that runs your agent:

openclaw pairing approve telegram <CODE>

Repeat for each new teammate. That's it — they can now chat with the agent.

How do I get someone's Telegram user ID? Easiest: ask them to DM your bot once — their ID will appear in the bot's reply. Or use a public lookup tool like tg-user.id.
For developers — what gets stored where

Hermes writes the merged allowlist to TELEGRAM_ALLOWED_USERS in the agent's ~/.hermes/.env and restarts the gateway. The list lives on the sc_team_agents.settings_metadata column under the telegram_allowed_user_ids key.

OpenClaw persists approved IDs to ~/.openclaw/credentials/telegram-allowFrom.json. The relevant openclaw.json fields are allowFrom and dmPolicy for direct messages, and groupAllowFrom and groupPolicy for groups. List pending requests with openclaw pairing list telegram.

Next guide Put it all together — agent + team in a group