OpenClaw Signal 渠道接入指南-05r

OpenClaw 通过 signal-cli 与 Signal 集成。Gateway 通过 HTTP JSON-RPC + SSE 与 signal-cli 通信。

前置要求

服务器上已安装 OpenClaw（下面流程在 Ubuntu 24 上测试）
Gateway 运行的主机上安装好 signal-cli
一个可以接收验证 SMS 的手机号（用于 SMS 注册）
浏览器访问 Signal captcha（signalcaptchas.org）完成注册

快速开始（新手）

使用独立的 Signal 号码作为机器人（推荐）
安装 signal-cli（需要 Java）
选择一种设置方式：
- 方式A (QR链接): signal-cli link -n "OpenClaw" 然后在 Signal 中扫描
- 方式B (SMS注册): 使用 captcha + SMS 验证注册专用号码
配置 OpenClaw 并重启 Gateway
发送第一条私信并批准配对：openclaw pairing approve signal [CODE]

最小配置

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

字段说明

字段	说明
account	机器人手机号，E.164格式（如 +15551234567）
cliPath	signal-cli 路径（如果在 PATH 中则用 “signal-cli”）
dmPolicy	私信访问策略（推荐 “pairing”）
allowFrom	允许私信的号码或 uuid:id 值

号码模型（重要）

Gateway 连接到Signal 设备（signal-cli 账号）
如果机器人在你的个人 Signal 账号上运行，它会忽略你自己的消息（循环保护）
需要”我发消息给机器人，它回复”，请使用独立的机器人号码

设置方式A：链接现有 Signal 账号（QR）

安装 signal-cli（JVM 或原生构建）
链接机器人账号：
signal-cli link -n "OpenClaw" 然后在 Signal 中扫描 QR 码
配置 Signal 并启动 Gateway

设置方式B：注册专用机器人号码（SMS，Linux）

获取一个可以接收 SMS 的号码

在 Gateway 主机安装 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

注册并验证号码：
```
signal-cli -a + register
```
如需 captcha：
1. 打开 https://signalcaptchas.org/registration/generate.html
2. 完成 captcha，复制 “Open Signal” 中的 signalcaptcha://... 链接
3. 重新运行注册（captcha 令牌很快过期）：
```
signal-cli -a + register --captcha ''
signal-cli -a + verify 
```