Hermes 消息平台接入 · 第28篇2026/8/9· Easy Understand Hermes Agent
SimpleX 接入——无 ID 的隐私聊天
Hermes 消息平台接入第28篇: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 |
定时任务默认投递对象 |
授权机制
默认情况下所有联系人都被拒绝。两种放行方式:
- 在
SIMPLEX_ALLOWED_USERS里列出允许的 contactId 或显示名 - 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