Signal

Signal 是一个可下载的频道插件（@openclaw/signal）。网关通过 HTTP 与 signal-cli 通信：可以是原生守护进程（JSON-RPC + SSE），也可以是 bbernhard/signal-cli-rest-api 容器（REST + WebSocket）。OpenClaw 不内嵌 libsignal。

号码模型（请先阅读）¶

• 网关连接到一个 Signal 设备：即 signal-cli 账户。
• 在你的个人 Signal 账户上运行机器人会使其忽略你自己的消息（循环保护）。
• 对于“我给机器人发消息，它回复我”的场景，请使用独立的机器人号码。

安装¶

openclaw plugins install @openclaw/signal

@openclaw/signal 会先从 npm 安装，只有当 npm 目标不可用时，才会回退到其声明的 ClawHub 包。使用 npm: 或 clawhub: 可强制指定来源。plugins install 会注册并启用插件；无需单独的 enable 步骤。通用安装规则见 插件。

快速设置¶

1. 选择号码

为机器人使用独立的 Signal 号码（推荐）。

2. 安装插件

openclaw plugins install @openclaw/signal

3. 运行引导式设置

openclaw channels add

对于非交互式设置，openclaw channels add --channel signal 还接受 --signal-number <e164> 作为机器人电话号码，以及 --http-host <host> 和 --http-port <port> 作为 Signal 守护进程端点（默认 127.0.0.1:8080）。

4. 链接或注册账户

• QR 链接（最快）： signal-cli link -n "OpenClaw"，然后用 Signal 扫描。见 路径 A。
• SMS 注册： 专用号码，需要验证码 + SMS 验证。见 路径 B。

5. 验证并配对

openclaw channels status --probe

最小配置：

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      transport: {
        kind: "managed-native",
        cliPath: "signal-cli",
      },
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}

多账户支持：使用 channels.signal.accounts，并配置每个账户的设置和可选的 name。每个命名账户拥有自己的 transport；它不会继承顶层 transport。顶层 transport 只属于隐式的 default 账户。共享模式见 多账户频道。

账户键使用 status 显示的规范化 ID。例如，拥有自己 account 号码的 Work Phone 会以 work-phone 运行，并使用其已编写的设置，而无需运行 Doctor。如果多个键规范化为同一个 ID，则精确键优先，Doctor 会报告冲突。如果删除该账户会导致另一个已存储键选择不同身份，删除操作会拒绝移除该账户；错误会列出两个键，以便你先解决冲突。没有自己号码的旧版别名保留其现有继承行为。Doctor 可以清理无歧义的键，但当重命名别名会激活之前被忽略的设置时，它会拒绝重命名。

省略的账户 dmPolicy 和 groupPolicy 继承频道根配置；显式账户策略优先。如果两个作用域都未设置，DM 使用 pairing，群组使用 allowlist。

它是什么¶

• 确定性路由：回复始终返回 Signal。
• DM 共享代理的主会话；在默认 session.groupScope: "per-group" 下，群组是隔离的（agent:<agentId>:signal:group:<groupId>）。
• 默认情况下，Signal 可能会写入由 /config set|unset 触发的配置更新（需要 commands.config: true）。使用 channels.signal.configWrites: false 禁用。

设置路径 A：链接现有 Signal 账户（QR）¶

1. 安装 signal-cli（JVM 或原生构建），或让 openclaw channels add 为你安装。
2. 链接机器人账户：signal-cli link -n "OpenClaw"，然后在 Signal 中扫描二维码。
3. 配置 Signal 并启动网关。

设置路径 B：注册专用机器人号码（SMS，Linux）¶

对于专用机器人号码，请使用此方法，而不是链接现有 Signal 应用账户。以下流程已在 Ubuntu 24 上测试。

1. 获取一个可以接收 SMS 的号码（固定电话可使用语音验证）。专用机器人号码可避免账户/会话冲突。
2. 在网关主机上安装 signal-cli：

VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/AsamK/signal-cli/releases/latest | sed -e 's/^.*\/v//')
curl -L -O "https://github.com/AsamK/signal-cli/releases/download/v${VERSION}/signal-cli-${VERSION}-Linux-native.tar.gz"
sudo tar xf "signal-cli-${VERSION}-Linux-native.tar.gz" -C /opt
sudo ln -sf /opt/signal-cli /usr/local/bin/
signal-cli --version

如果你使用 JVM 构建（signal-cli-${VERSION}.tar.gz），请先安装 JRE。保持 signal-cli 更新；上游指出，随着 Signal 服务器 API 变化，旧版本可能会失效。

1. 注册并验证号码：

signal-cli -a +<BOT_PHONE_NUMBER> register

仍在第 3 步中，如果需要验证码（需要浏览器访问才能完成 此步骤）：

• 打开 https://signalcaptchas.org/registration/generate.html。
• 完成验证码，从“Open Signal”复制 signalcaptcha://... 链接目标。
• 尽可能从与浏览器会话相同的外部 IP 运行（验证码令牌很快过期）。
• 立即注册并验证：

signal-cli -a +<BOT_PHONE_NUMBER> register --captcha '<SIGNALCAPTCHA_URL>'
signal-cli -a +<BOT_PHONE_NUMBER> verify <VERIFICATION_CODE>

1. 配置 OpenClaw 并验证通道。配置更改遵循 热重载；如果 Gateway 处于离线状态，请启动 Gateway。如果你更改了服务的 PATH 以查找 signal-cli，请重启它。

openclaw doctor
openclaw channels status --probe

1. 配对你的 DM 发送方：
2. 向机器人号码发送任意消息。
3. 在服务器上批准：openclaw pairing approve signal <PAIRING_CODE>。
4. 在手机上将机器人号码保存为联系人，以避免出现“未知联系人”。

上游参考：

• signal-cli README：https://github.com/AsamK/signal-cli
• 验证码流程：https://github.com/AsamK/signal-cli/wiki/Registration-with-captcha
• 链接流程：https://github.com/AsamK/signal-cli/wiki/Linking-other-devices-(Provisioning)

外部原生守护进程模式¶

如果你要自行管理 signal-cli（JVM 冷启动慢、容器初始化、共享 CPU），请单独运行守护进程，并将 OpenClaw 指向它：

对于非交互式设置，在需要时显式选择端点类型：

openclaw channels add --channel signal --signal-number +15551234567 \
  --http-url http://127.0.0.1:8080 --signal-transport external-native

{
  channels: {
    signal: {
      transport: {
        kind: "external-native",
        url: "http://127.0.0.1:8080",
      },
    },
  },
}

这会跳过自动启动和 OpenClaw 的启动等待。对于启动较慢的受管守护进程，请设置 channels.signal.transport.startupTimeoutMs。

容器模式（bbernhard/signal-cli-rest-api）¶

与其以原生方式运行 signal-cli，不如使用 bbernhard/signal-cli-rest-api Docker 容器，该容器在 REST + WebSocket 接口后面封装了 signal-cli。

openclaw channels add --channel signal --signal-number +15551234567 \
  --http-url http://signal-cli:8080 --signal-transport container

要求：

• 容器必须以 MODE=json-rpc 运行，才能实时接收消息。
• 在连接 OpenClaw 之前，请在容器内注册或链接你的 Signal 账户。

示例 docker-compose.yml 服务：

signal-cli:
  image: bbernhard/signal-cli-rest-api:latest
  environment:
    MODE: json-rpc
  ports:
    - "8080:8080"
  volumes:
    - signal-cli-data:/home/.local/share/signal-cli

OpenClaw 配置：

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      transport: {
        kind: "container",
        url: "http://signal-cli:8080",
      },
    },
  },
}

transport.kind 控制 OpenClaw 使用的协议和进程生命周期：

设置和 openclaw doctor --fix 可能会探测一次现有端点，以识别其具体类型。运行时操作不会自动检测或切换协议。

在容器暴露相应 API 的情况下，容器模式支持原生模式相同的 Signal 操作：发送、接收、附件、正在输入指示器、已读/已查看回执、表情回应、群组以及样式化文本。OpenClaw 会将原生 Signal RPC 调用转换为容器的 REST 负载，包括 group.{base64(internal_id)} 群组 ID 和用于格式化文本的 text_mode: "styled"。

运维说明：

• 接收请使用 MODE=json-rpc。MODE=normal 可能使 /v1/about 看起来健康，但 /v1/receive/{account} 不会进行 WebSocket 升级，因此容器接收流式传输会探测失败。
• 对于 bbernhard REST API，请设置 kind: "container"；对于原生 signal-cli JSON-RPC/SSE，请设置 kind: "external-native"。
• 容器附件下载遵循与原生模式相同的媒体字节限制。当服务器发送 Content-Length 时，超大的响应会在完全缓冲之前被拒绝；否则会在流式传输过程中被拒绝。

可选私有 UNIX 套接字¶

在 POSIX 系统上，受管原生守护进程可以使用 UNIX 套接字而不是 HTTP 监听器。这在共享主机上很有用，其他操作系统用户不得控制 Signal 守护进程。请使用绝对路径配置 transport.socketPath（最多 103 个 UTF-8 字节，不包含 . 或 .. 路径段）：

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123",
      transport: {
        kind: "managed-native",
        socketPath: "/home/user/.local/state/signal-private/daemon.sock",
      },
    },
  },
}

套接字所在目录必须属于 Gateway 操作系统用户，并且权限为 0700（无组或其他用户访问权限）。如果该目录缺失且其父目录已存在，OpenClaw 会创建该目录；它不会修复现有目录的权限。符号链接路径会被拒绝。在 macOS 上，OpenClaw 还会检查 BSD 模式位之外的 ACL，并拒绝授予非所有者访问权限的 ACL 条目，包括可继承条目。在 Linux 上，不会检查 POSIX ACL；操作员应选择没有授予访问权限 ACL 的父目录层级。每个账户请使用不同的套接字路径。此可选项不支持 Windows。

socketPath 仅在 kind: "managed-native" 下有效，且不能与 url、httpHost 或 httpPort 组合使用。省略 receiveMode 或将其设置为 "manual"；OpenClaw 会通过套接字管理接收订阅。套接字连接或权限失败会停止此传输方式；没有 HTTP 回退。

现有托管 HTTP 默认设置、外部原生守护进程和容器配置保持不变。选择退出不会改变现有 HTTP 暴露： 回环绑定并不能阻止另一个本地操作系统用户访问未认证的守护进程。私有目录隔离的是操作系统用户，而不是以同一用户身份运行的进程或管理员。signal-cli 不会授权连接对端的 UID，因此此隔离保证依赖于文件系统授权。Signal 发送者配对和允许列表仍然是独立的消息访问控制。

访问控制（私聊 + 群组）¶

私聊：

• 默认：channels.signal.dmPolicy = "pairing"。
• 未知发送者会收到配对码；在批准之前消息会被忽略（配对码在 1 小时后过期）。
• 通过 openclaw pairing list signal 和 openclaw pairing approve signal <CODE> 批准。
• 配对是 Signal 私聊的默认令牌交换方式。详情：配对
• 仅包含 UUID 的发送者（来自 sourceUuid）会以 uuid:<id> 形式存储在 channels.signal.allowFrom 中。

群组：

• channels.signal.groupPolicy = open | allowlist | disabled。
• channels.signal.groupAllowFrom 控制在设置 allowlist 时哪些群组或发送者可以触发群组回复；条目可以是 Signal 群组 ID（原始值、group:<id> 或 signal:group:<id>）、发送者电话号码、uuid:<id> 值或 *。
• channels.signal.groups["<group-id>" | "*"] 可以使用 requireMention、tools 和 toolsBySender 覆盖群组行为。
• 在多账号配置中，使用 channels.signal.accounts.<id>.groups 进行按账号覆盖。
• 通过 groupAllowFrom 将 Signal 群组加入允许列表本身不会禁用提及门控。除非设置了 requireMention=true，否则专门配置的 channels.signal.groups["<group-id>"] 条目会处理每条群组消息。
• 当 requireMention=true 时，Signal 原生 @提及会从结构化提及元数据中匹配，并与机器人账号电话号码或 accountUuid 进行比对。纯文本匹配使用 agents.entries.*.groupChat.mentionPatterns，然后使用 messages.groupChat.mentionPatterns；当两者都未设置时，会从被路由代理的 identity.name 和 identity.emoji 派生模式。在所选层级显式设置 mentionPatterns: [] 会禁用此文本回退，但不会禁用原生 @提及。
• 运行时说明：如果 channels.signal 完全缺失，运行时会对群组检查回退到 groupPolicy="allowlist"（即使设置了 channels.defaults.groupPolicy）。

带提及门控且有界上下文的群组：

{
  channels: {
    signal: {
      account: "+15551234567",
      accountUuid: "bot-signal-uuid",
      groupPolicy: "allowlist",
      groupAllowFrom: ["group:<signal-group-id>"],
      historyLimit: 8,
      groups: {
        "<signal-group-id>": { requireMention: true },
      },
    },
  },
  messages: {
    groupChat: {
      mentionPatterns: ["\\bopenclaw\\b"],
    },
  },
}

未提及机器人的允许群组消息会保持静默，并且只保留在有界的待处理历史窗口中。当后续的原生 @提及或回退文本提及触发机器人时，OpenClaw 会包含该近期上下文并回复到同一群组。被跳过的附件正文不会被下载；它们可能仅作为紧凑媒体占位符出现在待处理上下文中。

工作原理（行为）¶

• 原生模式：signal-cli 作为守护进程运行；网关通过 SSE 读取事件。
• 容器模式：网关通过 REST API 发送，并通过 WebSocket 接收。
• 入站消息会被规范化为共享通道信封。
• 回复始终路由回同一号码或群组。
• 对入站消息的回复会在后端接受入站时间戳和作者时包含原生 Signal 引用元数据；如果引用元数据缺失或被拒绝，OpenClaw 会将回复作为普通消息发送。
• 取消源投递会停止后续发送尝试，包括仍在准备中的附件和原生引用回退。已提交到 Signal 的请求允许完成，并且其已接受的结果会被保留；取消不会撤回该消息。
• 使用 channels.signal.replyToMode = off | first | all | batched 配置原生引用使用，或使用 channels.signal.replyToModeByChatType.direct/group 进行按聊天类型覆盖。channels.signal.accounts.<id> 下的账号级值优先。

媒体 + 限制¶

• 出站文本会按 channels.signal.textChunkLimit 分块（默认 4000）。
• 可选换行分块：设置 channels.signal.streaming.chunkMode="newline" 可在长度分块之前按空行（段落边界）拆分。
• 支持附件（从 signal-cli 获取 base64）。
• 语音留言附件在 contentType 缺失时使用 signal-cli 文件名作为 MIME 回退，因此音频转录仍可以分类 AAC 语音备忘录。
• 默认媒体上限：channels.signal.mediaMaxMb（默认 8）。
• 使用 channels.signal.ignoreAttachments 跳过任何传输方式的媒体下载。
• 群组历史上下文使用 channels.signal.historyLimit（或 channels.signal.accounts.*.historyLimit），回退到 messages.groupChat.historyLimit。设置 0 可禁用（默认 50）。

正在输入 + 已读回执¶

• 正在输入指示器：OpenClaw 通过 signal-cli sendTyping 发送正在输入信号，并在回复运行期间刷新它们。
• 已读回执：当 channels.signal.sendReadReceipts 为 true 时，OpenClaw 会为允许的私聊转发已读回执。
• signal-cli 不为群组暴露已读回执。

生命周期状态反应¶

设置 messages.statusReactions.enabled: true 可让 Signal 在入站回合中显示共享的排队/思考/工具/压缩/完成/错误反应生命周期。Signal 使用入站消息时间戳作为反应目标；群组反应会附带 Signal 群组 ID，并以原始发送者作为目标作者发送。

状态反应还需要一个 ack 反应，以及匹配的 messages.ackReactionScope（direct、group-all、group-mentions 或 all）。设置 channels.signal.reactionLevel: "off" 可禁用 Signal 状态反应。

Signal 会在最终 done/error 状态后恢复初始 ack 反应。

反应（消息工具）¶

使用 message action=react 并设置 channel=signal。

• 目标：发送者 E.164 或 UUID（使用配对输出中的 uuid:<id>；直接使用裸 UUID 也可以）。
• messageId 是你正在对其做出反应的 Signal 消息的时间戳。
• 群组反应需要 targetAuthor 或 targetAuthorUuid。

message action=react channel=signal target=uuid:123e4567-e89b-12d3-a456-426614174000 messageId=1737630212345 emoji=🔥
message action=react channel=signal target=+15551234567 messageId=1737630212345 emoji=🔥 remove=true
message action=react channel=signal target=signal:group:<groupId> targetAuthor=uuid:<sender-uuid> messageId=1737630212345 emoji=✅

配置：

• channels.signal.actions.reactions：启用/禁用反应操作（默认 true）。
• channels.signal.reactionLevel：off | ack | minimal | extensive（默认 minimal）。
• off/ack 禁用代理反应（消息工具 react 会报错）。
• minimal/extensive 启用代理反应并设置指导级别。
• 按账户覆盖：channels.signal.accounts.<id>.actions.reactions、channels.signal.accounts.<id>.reactionLevel。

审批反应¶

Signal 的 exec 和插件审批提示使用顶层 approvals.exec 和 approvals.plugin 路由块。Signal 没有 channels.signal.execApprovals 块。

• 👍 批准一次。
• 👎 拒绝。
• 当请求提供持久审批时，使用 /approve <id> allow-always。

审批反应解析需要来自 channels.signal.allowFrom、channels.signal.defaultTo 或对应账户级字段的显式 Signal 审批人。即使没有显式审批人，直接同一聊天中的 exec 审批提示仍可以抑制重复的本地 /approve 回退；无审批人的群组审批会保留本地回退可见。

问题反应¶

对于包含一个非机密、单选问题且选项数为一到四个的 ask_user 提示，Signal 会在选项标签旁显示 1️⃣ 到 4️⃣。对已送达的提示使用对应数字做出反应即可作答。OpenClaw 会验证该反应指向由机器人创建的消息，然后通过 Gateway 将数字映射到规范选项。过期或重复的点击会被忽略。多问题、多选和自由文本提示仍仅限文本回复；正常的 Signal 私信/群组准入规则用于授权发送者。

投递目标（CLI/cron）¶

• 私信：signal:+15551234567（或纯 E.164）。
• UUID 私信：uuid:<id>（或裸 UUID）。
• 群组：signal:group:<groupId>。
• 用户名：username:<name>（如果你的 Signal 账户支持）。

别名¶

为经常使用的 Signal 目标配置别名，以获得稳定名称。别名仅为 OpenClaw 侧配置；它们不会创建或编辑 Signal 联系人。

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
        jane: "uuid:123e4567-e89b-12d3-a456-426614174000",
        ops: "group:<groupId>",
      },
      defaultTo: "signal:me",
    },
  },
}

在任何接受 Signal 投递目标的地方都可以使用别名：

openclaw message send --channel signal --target signal:ops --message "Deployment is complete"

按账户的别名会继承顶层别名，并可以添加或覆盖名称：

{
  channels: {
    signal: {
      aliases: {
        me: "+15557654321",
      },
      accounts: {
        work: {
          aliases: {
            ops: "group:<workGroupId>",
          },
        },
      },
    },
  },
}

openclaw directory peers list --channel signal 和 openclaw directory groups list --channel signal 会列出已配置的别名。Signal 目录由配置支撑；它不会实时查询 Signal 联系人，也不会修改 Signal 账户。

故障排查¶

先运行以下排查阶梯：

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

如有需要，再确认私信配对状态：

openclaw pairing list signal

常见故障：

• 守护进程可达但没有回复：检查 account、transport.kind、传输 URL 和接收模式。
• 私信被忽略：发送者正在等待配对批准。
• 群组消息被忽略：群组发送者/提及门控阻止了投递。
• 编辑后出现配置验证错误：运行 openclaw doctor --fix。
• 诊断中缺少 Signal：确认 channels.signal.enabled: true。

额外检查：

openclaw pairing list signal
pgrep -af signal-cli
openclaw logs --plain --limit 500 | grep -i "signal" | tail -20

分诊流程：频道故障排查。

安全说明¶

• signal-cli 在本地存储账户密钥（通常为 ~/.local/share/signal-cli/data/）。
• 在服务器迁移或重建之前备份 Signal 账户状态。
• 除非你明确希望更广泛的私信访问，否则保持 channels.signal.dmPolicy: "pairing"。
• 短信验证仅在注册或恢复流程中需要，但失去对号码/账户的控制可能会使重新注册变得复杂。

配置参考（Signal）¶

完整配置：配置

提供商选项：

• channels.signal.enabled：启用/禁用频道启动。
• channels.signal.account：机器人账户的 E.164。
• channels.signal.accountUuid：可选的机器人账户 UUID，用于原生 @提及检测和循环保护。
• channels.signal.transport：账户拥有的传输。省略它可使用托管原生默认值。
• channels.signal.transport.kind：managed-native | external-native | container。
• channels.signal.transport.url：external-native 和 container 必填；当 managed-native 的连接端点与守护进程绑定不同时可选。
• channels.signal.transport.cliPath：托管原生 signal-cli 路径。
• channels.signal.transport.configPath：可选的托管原生 signal-cli --config 目录。
• channels.signal.transport.httpHost、channels.signal.transport.httpPort：托管原生守护进程绑定（默认 127.0.0.1:8080）。
• channels.signal.transport.startupTimeoutMs：托管原生启动等待时间，单位为毫秒（最小 1000，上限 120000；默认 30000）。
• channels.signal.transport.receiveMode：托管原生 on-start | manual。
• channels.signal.ignoreAttachments：跳过此账户的入站附件下载。
• channels.signal.transport.ignoreStories：托管原生故事开关。
• channels.signal.sendReadReceipts：转发已读回执。
• channels.signal.dmPolicy：pairing | allowlist | open | disabled（默认：pairing）。
• channels.signal.allowFrom：私信允许列表（E.164 或 uuid:<id>）。open 需要 "*"。Signal 没有用户名；请使用电话号码/UUID ID。
• channels.signal.aliases：OpenClaw 侧用于私信或群组投递目标的别名。
• channels.signal.groupPolicy：open | allowlist | disabled（默认：allowlist）。
• channels.signal.groupAllowFrom：群组允许列表；接受 Signal 群组 ID（原始值、group:<id> 或 signal:group:<id>）、发送者 E.164 号码或 uuid:<id> 值。
• channels.signal.groups：按 Signal 群组 ID（或 "*"）作为键的按群组覆盖。支持字段：requireMention、tools、toolsBySender。
• channels.signal.accounts.<id>.groups：多账户设置中 channels.signal.groups 的按账户版本。
• channels.signal.accounts.<id>.aliases：按账户别名，与顶层别名合并。
• channels.signal.replyToMode：原生回复引用模式，off | first | all | batched（默认：all）。
• channels.signal.replyToModeByChatType.direct、channels.signal.replyToModeByChatType.group：按聊天类型的原生回复引用覆盖。
• channels.signal.accounts.<id>.replyToMode、channels.signal.accounts.<id>.replyToModeByChatType.direct、channels.signal.accounts.<id>.replyToModeByChatType.group：按账户的回复引用覆盖。
• channels.signal.historyLimit：作为上下文包含的最大群组消息数（0 表示禁用）。
• channels.signal.dmHistoryLimit：以用户轮次为单位的私信历史限制。按用户覆盖：channels.signal.dms["<phone_or_uuid>"].historyLimit。
• channels.signal.textChunkLimit：出站分块大小，以字符为单位（默认 4000）。
• channels.signal.markdown.tables：Markdown 表格渲染模式，off | bullets | code（默认 bullets）；block 会回退到 code（Signal 没有原生块表格）。
• channels.signal.streaming.chunkMode：length（默认）或 newline，在按长度分块前按空行（段落边界）拆分。
• channels.signal.mediaMaxMb：入站/出站媒体上限，单位为 MB（默认 8）。
• channels.signal.reactionLevel：off | ack | minimal | extensive（默认 minimal）。参见 反应。
• channels.signal.reactionNotifications：off | own | all | allowlist（默认 own）- 何时在收到来自他人的入站反应时通知代理。
• channels.signal.reactionAllowlist：当 reactionNotifications: "allowlist" 时，其反应会通知代理的发送者。
• channels.signal.streaming.block.enabled、channels.signal.streaming.block.coalesce：跨频道共享的块模式流式控制。参见 流式传输。

相关全局选项：

• agents.entries.*.groupChat.mentionPatterns（纯文本回退；当配置了机器人账户身份时，Signal 原生 @提及会从结构化元数据中检测）。
• messages.groupChat.mentionPatterns（全局回退）。
• channels.signal.responsePrefix 或账户级别的 responsePrefix。

相关¶

• 渠道概览 - 所有支持的渠道
• 配对 - DM 身份验证和配对流程
• 群组 - 群聊行为和提及控制
• 渠道路由 - 消息的会话路由
• 表情回应 - message 工具的表情回应语义
• RPC 适配器 - 此渠道背后的 signal-cli JSON-RPC-over-HTTP 守护进程模式
• 安全 - 访问模型和安全加固