🤖HermesBlog
EN
Hermes 消息平台接入 · 第6篇2026/8/9· Easy Understand Hermes Agent

Signal 接入——注重隐私的聊天

Hermes 消息平台接入第6篇：Signal。端到端加密聊天里用 AI。

这篇教程将带你一步步把 Hermes Agent 接入 Signal，让你通过这个最注重隐私的聊天应用，随时随地和你的 AI 智能体对话。

Signal 就像聊天软件里的“保险箱”——所有消息默认端到端加密，连 Signal 公司自己都看不到内容，而且几乎不收集你的任何数据。如果你的智能体处理的是敏感信息，Signal 是最佳选择。

好消息是，接入过程不需要安装任何新的 Python 包，我们只需要一个叫 signal-cli 的外部小工具来充当“翻译官”，让 Hermes 能听懂 Signal 的语言。

准备工作：安装“翻译官”

首先，我们需要安装 signal-cli。你可以把它想象成一个帮你收发 Signal 消息的“信使”。

Mac 用户，打开终端，输入：

brew install signal-cli

Linux 用户，请直接从 GitHub 下载最新版本（它不在软件仓库里）：

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} \
  https://github.com/AsamK/signal-cli/releases/latest | sed 's/^.*\/v//')
curl -L -O "https://github.com/AsamK/signal-cli/releases/download/v${VERSION}/signal-cli-${VERSION}.tar.gz"
sudo tar xf "signal-cli-${VERSION}.tar.gz" -C /opt
sudo ln -sf "/opt/signal-cli-${VERSION}/bin/signal-cli" /usr/local/bin/

注意：signal-cli 需要 Java 17 或更高版本 才能运行，请确保你的电脑上已安装。

第 1 步：让“信使”和你的手机“配对”

signal-cli 的工作方式很像“微信网页版”——它作为你手机的辅助设备，而不是一个独立的账号。

  1. 在终端运行 signal-cli link -n "HermesAgent"，屏幕上会出现一个二维码。
  2. 打开手机上的 Signal，进入 设置 → 已连接的设备。
  3. 点击 连接新设备，然后扫描终端里的二维码。

配对成功后，你的“信使”就正式上岗了。

第 2 步：启动“信使”服务

现在，让“信使”开始工作。把下面的号码换成你自己的 Signal 手机号（记得带国家代码，比如 +86…）：

signal-cli --account +1234567890 daemon --http 127.0.0.1:8080

这个命令会让“信使”在后台监听消息。你可以用 tmux 或 systemd 让它一直运行。验证一下是否成功：

curl http://127.0.0.1:8080/api/v1/check

如果返回了类似 {"versions":{"signal-cli":...}} 的信息，就说明一切正常。

第 3 步：配置 Hermes 并连接

最简单的方式是使用 Hermes 自带的向导：

hermes gateway setup

选择 Signal，然后按照提示，输入刚才的 HTTP 地址（默认即可）和你的手机号。

想手动配置？ 打开 ~/.hermes/.env 文件，加入以下内容：

# 必填
SIGNAL_HTTP_URL=http://127.0.0.1:8080
SIGNAL_ACCOUNT=+1234567890

# 安全设置（强烈推荐）
SIGNAL_ALLOWED_USERS=+1234567890,+0987654321    # 允许跟你对话的手机号

# 可选设置
SIGNAL_GROUP_ALLOWED_USERS=*                    # * 表示允许所有群聊

保存后，启动网关：

hermes gateway

访问控制：谁能跟你的智能体说话？

这就像你家的门禁系统：

  • 设置了 SIGNAL_ALLOWED_USERS：只有名单上的人能发消息。
  • 没设置：陌生人会收到一个配对码，你需要手动批准。
  • 设置 SIGNAL_ALLOW_ALL_USERS=true：任何人都能发消息（慎用！）。

群聊的控制方式类似，由 SIGNAL_GROUP_ALLOWED_USERS 决定。默认情况下，智能体不理会任何群消息，只回复私聊。

特色功能一览

  • 收发文件：支持图片、语音、视频和文档，最大 100 MB。
  • 原生排版：消息里的加粗、斜体、代码 等会以真实样式显示，而不是一堆符号。
  • 回复引用：智能体回复时会自动引用你的原话。
  • 表情回应：智能体可以用表情符号回应你的消息。
  • 私密笔记：如果你用自己的手机号运行，可以直接给“文件传输助手”（Note to Self）发消息，智能体就会回复你，非常方便！
  • 自动重连：网络断了会自动恢复连接。

常见问题速查

问题 解决方法
连不上 signal-cli 确认第 2 步的守护进程是否在运行。
收不到消息 检查 SIGNAL_ALLOWED_USERS 里是否包含了发送者的号码（带 + 前缀）。
群消息被忽略 设置 SIGNAL_GROUP_ALLOWED_USERS 为 * 或指定群 ID。

总结一下：接入 Signal 只需三步——安装“信使”、配对手机、配置 Hermes。整个过程非常注重隐私和安全，适合处理敏感任务。

下篇预告：我们已经打通了 Telegram 和 Signal，下一个要接入的是哪个主流平台呢？敬请期待「消息平台接入系列」的下一篇文章！

📖 官方文档

本文根据 Hermes Agent 官方文档编写，原文见：官方文档 › user-guide/messaging/signal

← 返回全部文章