How to configure Hermes Agent Signal?

When the Hermes Agent connects to Signal, it essentially makes the signal-cli work as a linked device. The official documentation gives a clear direction: prepare the Signal number and signal-cli runtime environment first, and then do the link, allowlist and home channel configuration.

Basic steps

1. Install and confirm that the signal-cli is functioning properly on the machine.
2. To connect Hermes to Signal according to the documentation, the common practice is to register Hermes as a linked device.
3. In ~/.hermes/.env with SIGNAL_PHONE_NUMBER, SIGNAL_ALLOWED_USERS, SIGNAL_HOME_CHANNEL.
4. Perform hermes gateway install and hermes gateway start to keep the gateway online for a long time.
5. Use your mobile phone to send a message to the bot to confirm that the sending and receiving are normal.

Why a lot of people get stuck here

It's not that Hermes has complex logic, but that the Signal environment is heavily dependent. When Cannot reach signal-cli, daemon is not online, and messages are not coming in, check Java 17, signal-cli daemon, port 8080, and service status first. When you don't speak in a group chat, check if SIGNAL_GROUP_ALLOWED_USERS is configured.

In a word: The core of Signal is not to tune prompts, but to first configure signal-cli, allow users, and long-running gateway services.

Official open source address: https://github.com/NousResearch/hermes-agent; Official document entry: https://hermes-agent.nousresearch.com/.