Signal（signal-cli）
状态：外部 CLI 集成。Gateway网关通过 HTTP JSON-RPC + SSE 与signal-cli 通信。
快速设置（新手）
- 为机器人使用一个单独的 Signal 号码（推荐）。
- 安装
signal-cli（需要 Java）。 - 链接机器人设备并启动守护进程：
signal-cli link -n "OpenClaw"
- 配置 OpenClaw 并启动 Gateway网关。
它是什么
- 通过
signal-cli的 Signal 渠道（非嵌入式 libsignal）。 - 确定性路由：回复始终发回 Signal。
- 私信共享智能体的主会话；群组是隔离的（
agent:<agentId>:signal:group:<groupId>）。
配置写入
默认情况下，Signal 允许通过/config set|unset 触发的配置更新写入（需要 commands.config: true）。
通过以下方式禁用：
号码模型（重要）
- Gateway网关连接到一个 Signal 设备（
signal-cli账户）。 - 如果你在个人 Signal 账户上运行机器人，它会忽略你自己的消息（循环保护）。
- 要实现”我给机器人发消息它回复我”，请使用一个单独的机器人号码。
设置（快速路径）
- 安装
signal-cli（需要 Java）。 - 链接机器人账户：
signal-cli link -n "OpenClaw"然后在 Signal 中扫描二维码。
- 配置 Signal 并启动 Gateway网关。
channels.signal.accounts，每个账户配置独立选项和可选的 name。共享模式请参阅 gateway/configuration。
外部守护进程模式（httpUrl）
如果你想自行管理signal-cli（JVM 冷启动慢、容器初始化或共享 CPU），可以单独运行守护进程并将 OpenClaw 指向它：
channels.signal.startupTimeoutMs。
访问控制（私信 + 群组）
私信：- 默认：
channels.signal.dmPolicy = "pairing"。 - 未知发送者会收到配对码；在批准之前消息会被忽略（配对码 1 小时后过期）。
- 通过以下方式批准：
openclaw pairing list signalopenclaw pairing approve signal <CODE>
- 配对是 Signal 私信的默认令牌交换方式。详情：配对
- 仅 UUID 的发送者（来自
sourceUuid）以uuid:<id>形式存储在channels.signal.allowFrom中。
channels.signal.groupPolicy = open | allowlist | disabled。- 当设置为
allowlist时，channels.signal.groupAllowFrom控制谁可以在群组中触发。
工作原理（行为）
signal-cli作为守护进程运行；Gateway网关通过 SSE 读取事件。- 入站消息被标准化为共享的渠道信封。
- 回复始终路由回同一个号码或群组。
媒体 + 限制
- 出站文本按
channels.signal.textChunkLimit分块（默认 4000）。 - 可选的换行分块：设置
channels.signal.chunkMode="newline"在按长度分块之前按空行（段落边界）分割。 - 支持附件（从
signal-cli获取 base64）。 - 默认媒体上限：
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 不暴露群组的已读回执。
回应（message 工具）
- 使用
message action=react配合channel=signal。 - 目标：发送者 E.164 或 UUID（使用配对输出中的
uuid:<id>；裸 UUID 也可以）。 messageId是你要回应的消息的 Signal 时间戳。- 群组回应需要
targetAuthor或targetAuthorUuid。
channels.signal.actions.reactions：启用/禁用回应操作（默认 true）。channels.signal.reactionLevel：off | ack | minimal | extensive。off/ack禁用智能体回应（message 工具react会报错）。minimal/extensive启用智能体回应并设置引导级别。
- 按账户覆盖：
channels.signal.accounts.<id>.actions.reactions、channels.signal.accounts.<id>.reactionLevel。
投递目标（CLI/定时任务）
- 私信：
signal:+15551234567（或纯 E.164）。 - UUID 私信：
uuid:<id>（或裸 UUID）。 - 群组：
signal:group:<groupId>。 - 用户名：
username:<name>（如果你的 Signal 账户支持）。
配置参考（Signal）
完整配置：配置 提供商选项：channels.signal.enabled：启用/禁用渠道启动。channels.signal.account：机器人账户的 E.164。channels.signal.cliPath：signal-cli的路径。channels.signal.httpUrl：完整守护进程 URL（覆盖 host/port）。channels.signal.httpHost、channels.signal.httpPort：守护进程绑定（默认 127.0.0.1:8080）。channels.signal.autoStart：自动启动守护进程（未设置httpUrl时默认 true）。channels.signal.startupTimeoutMs：启动等待超时，单位毫秒（上限 120000）。channels.signal.receiveMode：on-start | manual。channels.signal.ignoreAttachments：跳过附件下载。channels.signal.ignoreStories：忽略来自守护进程的动态。channels.signal.sendReadReceipts：转发已读回执。channels.signal.dmPolicy：pairing | allowlist | open | disabled（默认：pairing）。channels.signal.allowFrom：私信允许列表（E.164 或uuid:<id>）。open需要"*"。Signal 没有用户名；使用电话/UUID 标识。channels.signal.groupPolicy：open | allowlist | disabled（默认：allowlist）。channels.signal.groupAllowFrom：群组发送者允许列表。channels.signal.historyLimit：包含为上下文的最大群组消息数（0 禁用）。channels.signal.dmHistoryLimit：私信历史限制（用户回合数）。按用户覆盖：channels.signal.dms["<phone_or_uuid>"].historyLimit。channels.signal.textChunkLimit：出站分块大小（字符）。channels.signal.chunkMode：length（默认）或newline，在按长度分块之前按空行（段落边界）分割。channels.signal.mediaMaxMb：入站/出站媒体上限（MB）。
agents.list[].groupChat.mentionPatterns（Signal 不支持原生提及）。messages.groupChat.mentionPatterns（全局回退）。messages.responsePrefix。