词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Signal"
Signal 配置
无需新增 Python 依赖
httpx（已是 Hermes 的核心依赖）进行所有通信，无需安装额外的 Python 包。你只需在外部安装 signal-cli。前提条件
安装 signal-cli
注意
第一步：关联你的 Signal 账号
1.
2.
3.
4.
第二步：启动 signal-cli 守护进程
提示
systemd、tmux、screen，或将其作为服务运行。第三步：配置 Hermes
1.
2.
http://127.0.0.1:8080）3.
4.
5.
手动配置
~/.hermes/.env 中添加：访问控制
私信访问
1.
SIGNAL_ALLOWED_USERS → 仅允许这些用户发送消息2.
hermes pairing approve signal CODE 审批）3.
SIGNAL_ALLOW_ALL_USERS=true → 任何人均可发送消息（谨慎使用）群组访问
SIGNAL_GROUP_ALLOWED_USERS 环境变量控制：| 配置 | 行为 |
|---|---|
| 未设置（默认） | 忽略所有群组消息，机器人仅响应私信。 |
| 设置群组 ID | 仅监听列出的群组（如 groupId1,groupId2 ）。 |
设置为 * | 机器人在其所在的任意群组中均会响应。 |
功能特性
附件
MEDIA: 标签发送媒体文件，支持以下投递方式：send_multiple_images 和 send_image_file 将 PNG、JPEG、GIF、WebP 作为原生 Signal 附件发送send_voice 将音频文件（OGG、MP3、WAV、M4A、AAC）作为附件发送send_video 发送 MP4 视频文件send_document 发送任意文件类型（PDF、ZIP 等）警告
原生格式、引用回复与表情回应
**粗体**、*斜体*、`代码`、~~删除线~~、||剧透||、标题）转换为 Signal bodyRanges，使文本在接收方客户端以真实样式显示，而非可见的 ** 或 ` 字符。signal-cli 版本过旧，Hermes 会回退到纯文本投递，并记录一次性警告日志。正在输入指示器
手机号脱敏
+15551234567 → +155****4567给自己发消息（单号码配置）
syncMessage.sentMessage 信封形式到达SIGNAL_ACCOUNT 与你的手机号匹配，此功能自动生效。健康监控
故障排查
| 问题 | 解决方案 |
|---|---|
| 配置时提示 "Cannot reach signal-cli" | 确保 signal-cli 守护进程正在运行：signal-cli --account +YOUR_NUMBER daemon --http 127.0.0.1:8080 |
| 消息未收到 | 检查 SIGNAL_ALLOWED_USERS 是否包含发送方号码（E.164 格式，带 + 前缀） |
| "signal-cli not found on PATH" | 安装 signal-cli 并确保其在 PATH 中，或使用 Docker |
| 连接持续断开 | 检查 signal-cli 日志中的错误信息，确保已安装 Java 17+。 |
| 群组消息被忽略 | 使用具体群组 ID 配置 SIGNAL_GROUP_ALLOWED_USERS，或设为 * 允许所有群组。 |
| 机器人对所有人无响应 | 配置 SIGNAL_ALLOWED_USERS，使用私信配对，或通过 gateway 策略显式允许所有用户（如需更广泛的访问权限）。 |
| 消息重复 | 确保只有一个 signal-cli 实例在监听你的手机号 |
安全
警告
SIGNAL_ALLOWED_USERS 或私信配对，gateway 会拒绝所有入站消息作为安全措施。~/.local/share/signal-cli/ 中的 signal-cli 会话数据包含账号凭据——请像保护密码一样保护它环境变量参考
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
SIGNAL_HTTP_URL | 是 | — | signal-cli HTTP 端点 |
SIGNAL_ACCOUNT | 是 | — | 机器人手机号（E.164） |
SIGNAL_ALLOWED_USERS | 否 | — | 逗号分隔的手机号/UUID |
SIGNAL_GROUP_ALLOWED_USERS | 否 | — | 要监听的群组 ID，或 * 表示全部（省略则禁用群组） |
SIGNAL_ALLOW_ALL_USERS | 否 | false | 允许任意用户交互（跳过白名单） |
SIGNAL_HOME_CHANNEL | 否 | — | cron 任务的默认投递目标 |