跳转至

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
向导会检测 signal-cli 是否在 PATH 中;如果缺失,会提供安装选项:在 Linux x86-64 上下载官方原生 GraalVM 构建,或在 macOS 及其他架构上通过 Homebrew 安装。随后它会提示输入机器人号码和 signal-cli 路径。

对于非交互式设置,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
发送第一条私聊消息并批准配对:openclaw pairing approve signal <CODE>。

最小配置:

{
  channels: {
    signal: {
      enabled: true,
      account: "+15551234567",
      transport: {
        kind: "managed-native",
        cliPath: "signal-cli",
      },
      dmPolicy: "pairing",
      allowFrom: ["+15557654321"],
    },
  },
}
字段 说明
account 以 E.164 格式表示的机器人电话号码(+15551234567)
transport 账户拥有的 Signal 连接和进程模式
dmPolicy 私聊访问策略(推荐 pairing)
allowFrom 允许私聊的电话号码或 uuid:<id> 值

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

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

省略的账户 dmPolicy 和 groupPolicy 会继承通道根配置;显式账户策略优先。如果两个作用域都未设置,则私聊使用 pairing,群组使用 allowlist。

功能说明

  • 确定性路由:回复始终返回 Signal。
  • 私聊共享代理的主会话;在默认 session.groupScope: "per-group" 下,群组是隔离的(agent:<agentId>:signal:group:<groupId>)。
  • 默认情况下,Signal 可能会写入由 /config set|unset 触发的配置更新(需要 commands.config: true)。使用 channels.signal.configWrites: false 禁用。
  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 离线,请启动它。如果你更改了服务的 PATH 以查找 signal-cli,请重启它。
openclaw doctor
openclaw channels status --probe
  1. 配对你的私信发送方:
  2. 向机器人号码发送任意消息。
  3. 在服务器上批准:openclaw pairing approve signal <PAIRING_CODE>。
  4. 在手机上将机器人号码保存为联系人,以避免“未知联系人”。

Warning

使用 signal-cli 注册电话号码账户可能会使该号码的主 Signal 应用会话失去认证。建议使用专用的机器人号码,或使用 QR 链接模式以保留现有手机应用设置。

上游参考:

  • 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 使用的协议和进程生命周期:

值 行为
"managed-native" 启动原生 signal-cli,并在 /api/v1/rpc 使用 JSON-RPC,在 /api/v1/events 使用 SSE;url 可以选择与守护进程绑定不同的连接端点
"external-native" 连接到已在运行的原生 signal-cli 守护进程
"container" 连接到 bbernhard REST 的 /v2/send 和 WebSocket 的 /v1/receive/{account}

设置和 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 监听器。这在共享主机上很有用,其他 OS 用户不得控制 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 OS 用户,并具有模式 0700(无组或其他访问权限)。如果该目录缺失且其父目录已存在,OpenClaw 会创建该目录;它不会修复现有目录的权限。符号链接路径会被拒绝。在 macOS 上,OpenClaw 还会检查 BSD 模式位之外的 ACL,并拒绝为非所有者授予访问权限的 ACL 条目,包括可继承条目。在 Linux 上,不会检查 POSIX ACL;操作员应选择没有授予访问权限 ACL 的父级层次结构。为每个账户使用不同的套接字路径。此可选功能不支持 Windows。

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

现有托管 HTTP 默认设置、外部原生守护进程和容器配置保持不变。选择退出不会改变现有 HTTP 暴露: 回环绑定并不能阻止另一个本地 OS 用户访问未认证守护进程。私有目录隔离的是 OS 用户,而不是以同一用户身份运行的进程或管理员。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 群组加入允许列表,本身不会禁用提及门控。明确配置的 channels.signal.groups["<group-id>"] 条目会处理每条群组消息,除非设置了 requireMention=true。
  • 当 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 在入站回合中显示共享的 queued/thinking/tool/compaction/done/error 反应生命周期。Signal 使用入站消息时间戳作为反应目标;群组反应会附带 Signal 群组 ID 以及原始发送者作为目标作者发送。

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

Signal 会在最终完成/错误状态之后恢复最初的 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。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw