hermes-agent/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/messaging/simplex.md
ethernet 547b5de29d docs(pm): route dependency setup through public operations
Direct package installs bypass PM's dependency selection and do not survive
new generations. Document explicit runtime extras, recorded repair, fresh
build outputs, and lock generation through PM instead.

Keep the prepared-interpreter prerequisite and explicit removal requirement
for disposable test environments. Preserve Nix and external-project package
manager ownership. Correct platform and Python-marker claims where the
manifest contradicts the installation hints.

Checked the public CLI help, literal PM calls against public signatures and
extra declarations, fenced blocks, and whitespace. No dependency build or
site build ran. The docs toolchain is not installed in this checkout.
2026-09-11 18:12:49 -04:00

3.4 KiB
Raw Permalink Blame History

SimpleX Chat

SimpleX Chat 是一个私密的去中心化即时通讯平台,用户完全掌控自己的联系人和群组。与其他平台不同,SimpleX 不分配任何持久用户 ID——每个联系人在建立连接时由系统生成一个不透明的内部 ID,这使其成为目前隐私性最强的即时通讯工具之一。

前提条件

  • 已安装并以守护进程方式运行的 simplex-chat CLI
  • Python 包 websockets(hermes pm repair)

安装 simplex-chat

从 simplex-chat GitHub releases 页面下载最新版本:

# Linux / macOS binary
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 项目未发布聊天客户端的预构建 Docker 镜像;如需在 Docker 下运行,请从 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=<contact-id-1>,<contact-id-2>
SIMPLEX_HOME_CHANNEL=<contact-id>
变量 是否必填 说明
SIMPLEX_WS_URL 是 simplex-chat 守护进程的 WebSocket URL
SIMPLEX_ALLOWED_USERS 建议填写 允许使用 Agent 的联系人 ID,以逗号分隔
SIMPLEX_ALLOW_ALL_USERS 可选 设为 true 以允许所有联系人(请谨慎使用)
SIMPLEX_HOME_CHANNEL 可选 cron 任务投递的默认联系人 ID
SIMPLEX_HOME_CHANNEL_NAME 可选 主频道的可读标签

查找联系人 ID

启动守护进程后,与你的 Agent 联系人开启一段对话。联系人 ID 将出现在会话日志中,或通过 hermes send_message action=list 查看。

授权

默认情况下所有联系人均被拒绝访问。你必须选择以下方式之一:

  1. 将 SIMPLEX_ALLOWED_USERS 设置为以逗号分隔的联系人 ID 列表,或
  2. 使用 DM 配对——向 Bot 发送任意消息,Bot 将回复一个配对码。通过 hermes pairing approve simplex <CODE> 输入该配对码。

在 cron 任务中使用 SimpleX

cronjob(
    action="create",
    schedule="every 1h",
    deliver="simplex",          # uses SIMPLEX_HOME_CHANNEL
    prompt="Check for alerts and summarise."
)

或指定特定联系人:

send_message(target="simplex:<contact-id>", message="Done!")

隐私说明

  • SimpleX 从不暴露手机号或电子邮件地址——联系人使用不透明 ID 标识
  • Hermes 与守护进程之间的连接为本地 WebSocket(ws://127.0.0.1:5225)——数据不会离开你的机器
  • 消息在到达守护进程之前已由 SimpleX 协议进行端到端加密

故障排查

"Cannot reach daemon" — 确保 simplex-chat -p 5225 正在运行,且端口与 SIMPLEX_WS_URL 一致。

"websockets not installed" — 运行 hermes pm repair。

消息未收到 — 检查该联系人的 ID 是否已加入 SIMPLEX_ALLOWED_USERS,或通过 DM 配对方式批准该联系人。