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 助手。敬請期待！