SimpleX 接入——无 ID 的隐私聊天 | Easy Understand Hermes Agent

这篇教程将带你一步步把 Hermes Agent 接入 SimpleX Chat，让你拥有一个不绑定手机号、不暴露身份的隐私聊天机器人。

为什么选 SimpleX？

想象一下，你收到的每一封邮件都写着你的身份证号——这就是大多数聊天软件的现状。而 SimpleX 像匿名信箱：每个联系人拿到一个随机编号，没有全局 ID，连服务商都不知道“你是谁”和“谁在跟你聊”。Hermes 接入它，等于给你的 AI 助手穿上隐身衣。

第 1 步：安装聊天守护进程

SimpleX 的机器人需要一个“传话员”常驻后台，这个传话员就是 simplex-chat 命令行工具。

打开终端，下载并赋予执行权限：

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

没有预编译的 Docker 镜像，想用容器需自行从源码构建。

第 2 步：启动守护进程

把传话员叫醒，监听 5225 端口：

simplex-chat -p 5225

它默认在本地 ws://127.0.0.1:5225 提供 WebSocket 服务——数据不出你的电脑。

第 3 步：配置 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`	是	守护进程的 WebSocket 地址
`SIMPLEX_ALLOWED_USERS`	推荐	允许访问的联系人白名单，数字 ID 或显示名都行
`SIMPLEX_ALLOW_ALL_USERS`	否	设为 `true` 放行所有人（慎用！）
`SIMPLEX_AUTO_ACCEPT`	否	自动接受好友请求（默认 `true`）
`SIMPLEX_GROUP_ALLOWED`	否	参与的群组 ID，`*` 表示所有群
`SIMPLEX_HOME_CHANNEL`	否	定时任务默认投递的联系人/群
`HERMES_SIMPLEX_TEXT_BATCH_DELAY`	否	合并连续消息的静默秒数（默认 0.8）

第 4 步：找到你的联系人 ID

启动守护进程后，用 SimpleX 客户端给你的机器人发条消息。数字 ID 会出现在会话日志里，或者直接用 UI 上显示的昵称——白名单两种都认。

第 5 步：授权与配对

默认所有联系人被拒绝。两种放行方式：

白名单：在 SIMPLEX_ALLOWED_USERS 里写明 ID 或昵称。
DM 配对：给机器人随便发条消息，它会回复配对码，然后执行：

hermes pairing approve simplex <CODE>

第 6 步：群聊与发送消息

默认忽略群消息（否则机器人会回复群里每个人）。想参与，设置：

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

群聊地址用 group: 前缀：

hermes send --to simplex:alice "你好"        # 私聊
hermes send --to simplex:group:12 "大家好"   # 群聊
hermes send --to simplex "默认频道"          # 用 HOME_CHANNEL

第 7 步：收发附件与定时任务

图片、语音、文件双向支持——收到的附件会以 media_urls 呈现，发送时用 send_image_file 等方法，对方能直接内联预览，不用下载。

定时任务也能用：

cronjob(
    action="create",
    schedule="every 1h",
    deliver="simplex",          # 投递到 HOME_CHANNEL
    prompt="检查警报并总结。"
)

常见问题

连不上守护进程：确认 simplex-chat -p 5225 在跑，端口和 SIMPLEX_WS_URL 一致。
报错 websockets 缺失：执行 pip install websockets。
收不到消息：检查联系人 ID 是否在白名单，或用 DM 配对批准。

小结

至此，你的 Hermes 已经能通过 SimpleX 匿名收发消息、处理附件、跑定时任务。隐私与智能并不冲突——只是多了一个“匿名信箱”而已。

下篇预告：我们将接入另一个平台——可能是 Telegram 或 Discord，看看“公开社区”与“私密聊天”如何共存于同一个 AI 助手。敬请期待！