Second Key

From its catalog listing

Team approvals for shared Hermes bots. Dangerous commands need N votes from your roster by Telegram DM, sized to the risk. The requester never counts, and an agent that edits its own approval settings is stopped on its next tool call. No answer, an error or too few approvers always means deny.

Good to know before installing

Disclosure: Network: `api.telegram.org` only, with the bot token from `SECONDKEY_TELEGRAM_BOT_TOKEN`. Redirects are refused; What approvers see: the command after Hermes' own redaction, Hermes' reason for asking, and the requester's display name, platform and platform user id. While a ballot is open the DMs are edited in place about every 15 seconds with the current votes and time left. The same ballot text, plus a note that their own vote does not count, is also posted to the Telegram chat the request came from (which may be a group) or to the requester's DM; Re-arming after a change that weakens the settings opens its own critical ballot to the previously armed roster; Background thread: one long-poll thread reads the bot's updates while a request is waiting for votes, and for five minutes after `/secondkey enroll`. It stops on its own once neither holds, and when the plugin unloads; Files: writes its ledger, the armed settings (`armed.json`) and a pane state file (`state.json`: open and last eight closed ballots with the redacted command, requester name and approver names) under `plugin-data/second-key/`. Reads Hermes' `config.yaml` (read-only) before tool calls and in its Desktop Approvals pane, whose dashboard route is read-only; Credentials: reads the bot token through `agent.secret_scope.get_secret`. It never reads `.env`, `auth.json` or any other credential store; No telemetry, no self-updater, no shell commands, no dependencies beyond the standard library.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs SECONDKEY_TELEGRAM_BOT_TOKEN), then asks whether to turn it on.
    hermes plugins install second-key
  2. Said no? Turn it on later:
    hermes plugins enable second-key
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Chat apps & voice
Maintained by
kamalbuilds (Community)
Needs
SECONDKEY_TELEGRAM_BOT_TOKEN API key
Adds hooks
pre_approval_request pre_gateway_dispatch pre_tool_call
Needs Hermes
0.23.0 or newer
Version
0.2.0
In the catalog
2026-11-10
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in chat apps & voice

All chat apps & voice plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins