From 85b8a5b1ef20812a346544edd81da96a51d11f7a Mon Sep 17 00:00:00 2001 From: tiennm99 Date: Tue, 6 Oct 2026 08:49:35 +0700 Subject: [PATCH] docs(hermes): document replying only when tagged in Telegram groups --- {code-server => code-server-linuxserver}/.env.example | 0 {code-server => code-server-linuxserver}/Dockerfile | 0 {code-server => code-server-linuxserver}/README.md | 0 {code-server => code-server-linuxserver}/compose.yml | 0 hermes/README.md | 10 ++++++++++ 5 files changed, 10 insertions(+) rename {code-server => code-server-linuxserver}/.env.example (100%) rename {code-server => code-server-linuxserver}/Dockerfile (100%) rename {code-server => code-server-linuxserver}/README.md (100%) rename {code-server => code-server-linuxserver}/compose.yml (100%) diff --git a/code-server/.env.example b/code-server-linuxserver/.env.example similarity index 100% rename from code-server/.env.example rename to code-server-linuxserver/.env.example diff --git a/code-server/Dockerfile b/code-server-linuxserver/Dockerfile similarity index 100% rename from code-server/Dockerfile rename to code-server-linuxserver/Dockerfile diff --git a/code-server/README.md b/code-server-linuxserver/README.md similarity index 100% rename from code-server/README.md rename to code-server-linuxserver/README.md diff --git a/code-server/compose.yml b/code-server-linuxserver/compose.yml similarity index 100% rename from code-server/compose.yml rename to code-server-linuxserver/compose.yml diff --git a/hermes/README.md b/hermes/README.md index 28a1bf2..2a4a20f 100644 --- a/hermes/README.md +++ b/hermes/README.md @@ -66,6 +66,16 @@ To edit a value by hand, change it in `/opt/data/.env` from a shell in the container, as the `hermes` user, then run `/opt/hermes/.venv/bin/hermes gateway restart`. +In groups the bot answers only when tagged: `telegram.require_mention` is +`true` in `/opt/data/config.yaml`, set with +`/opt/hermes/.venv/bin/hermes config set telegram.require_mention true` +followed by a gateway restart. A group message then needs an `@botusername` +mention, a `/command@botusername`, or a reply to one of the bot's messages; +DMs are not gated. Upstream defaults it to `false`, answering every group +message the bot can see. It lives in the volume for the same reason as the +allow-lists: the gateway reads it from the profile, not the container +environment. + ## Storage | Volume | Mount | Holds |