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

SimpleX 接入——无 ID 的隐私聊天

Hermes 消息平台接入第28篇:SimpleX。没有用户名的隐私聊天。

SimpleX:匿名信箱隐身衣

SimpleX 接入——无 ID 的隐私聊天

你有没有想过,一个聊天软件可以完全没有用户 ID?不用手机号、不用邮箱、不用用户名,每个联系人都是连接时随机生成的不透明编号——这就是 SimpleX,可能是目前最注重隐私的聊天工具之一。

今天咱们就来看看怎么把 Hermes 接到 SimpleX 上,整个过程比你想的简单。

准备工作

先装好两样东西:

  • simplex-chat 命令行工具(要跑成后台守护进程)
  • Python 的 websockets 包:pip install websockets

安装 simplex-chat

GitHub Releases 页面 下载最新版:

curl -L https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-chat-ubuntu-22_04-x86_64 -o simplex-chat
chmod +x simplex-chat

然后启动守护进程:

simplex-chat -p 5225

默认会在 ws://127.0.0.1:5225 监听 WebSocket 连接。

配置 Hermes

最简单的办法是走向导:

hermes gateway setup

SimpleX Chat 跟着提示走就行。也可以手动改 ~/.hermes/.env

SIMPLEX_WS_URL=ws://127.0.0.1:5225
SIMPLEX_ALLOWED_USERS=4,alice
SIMPLEX_HOME_CHANNEL=4

几个关键变量:

变量 说明
SIMPLEX_WS_URL 必填,守护进程地址
SIMPLEX_ALLOWED_USERS 推荐填,允许名单,支持数字 ID 或显示名
SIMPLEX_GROUP_ALLOWED 群聊 ID 列表,* 表示所有群
SIMPLEX_HOME_CHANNEL 定时任务默认投递对象

授权机制

默认情况下所有联系人都被拒绝。两种放行方式:

  1. SIMPLEX_ALLOWED_USERS 里列出允许的 contactId 或显示名
  2. DM 配对——给机器人发任意消息,它会回复配对码,然后执行:
hermes pairing approve simplex <CODE>

群聊支持

默认忽略群消息(不然机器人得处理每个成员的发言)。想开就加:

SIMPLEX_GROUP_ALLOWED=12,34    # 指定群
# 或
SIMPLEX_GROUP_ALLOWED=*        # 所有群

群聊地址用 group: 前缀,比如 simplex:group:12

发消息

SimpleX 可以独立作为发送目标,守护进程跑着就行:

hermes send --to simplex:alice "你好"        # 按显示名发 DM
hermes send --to simplex:group:12 "大家好"   # 按 ID 发群聊
hermes send --to simplex "默认频道"          # 用 HOME_CHANNEL

附件收发

图片、语音、文件都支持!入站消息自动通过 XFTP 流程接收,出站消息用结构化格式发送,图片和语音在对方客户端里直接内联显示,不用下载。

定时任务

cronjob(
    action="create",
    schedule="every 1h",
    deliver="simplex",
    prompt="检查告警并总结。"
)

隐私亮点

  • 不暴露手机号和邮箱,全是匿名 ID
  • Hermes 和守护进程走本地 WebSocket,数据不出机器
  • SimpleX 协议端到端加密

常见问题

“Cannot reach daemon” —— 确认 simplex-chat 在跑,端口没被占用。


试试看,让你的 Hermes 也拥有一个真正匿名的聊天通道吧!

📖 官方文档

本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/messaging/simplex