OpenClaw 通过 signal-cli 接入 Signal，Gateway 与 signal-cli 通过 HTTP JSON-RPC + SSE 通信。
前置条件
- OpenClaw 已安装（Linux，以下流程基于 Ubuntu 24 测试）
signal-cli可在 Gateway 宿主机上运行- 一个能接收短信的手机号（注册路径需要）
强烈建议使用独立号码作为 Bot 号，避免与个人 Signal 账号混用。
快速接入（5 步）
- 准备一个独立 Signal 号
- 安装
signal-cli - 选择接入路径：Path A（QR 扫码）或 Path B（SMS 注册）
- 配置 OpenClaw 并重启 Gateway
- 发送第一条 DM，完成配对审批
最简配置
json
{
"channels": {
"signal": {
"enabled": true,
"account": "+8613800138000",
"cliPath": "signal-cli",
"dmPolicy": "pairing",
"allowFrom": ["+8613900139000"]
}
}
}Path A：QR 扫码链接现有账号
bash
signal-cli link -n "OpenClaw"用 Signal App 扫描 QR 码完成链接，配置 OpenClaw 后启动 Gateway。
Path B：SMS 注册专用 Bot 号（Linux）
安装 signal-cli
bash
VERSION=$(curl -Ls -o /dev/null -w %{url_effective} \
https://github.com/AsamK/signal-cli/releases/latest | sed '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/注册号码
bash
signal-cli -a +<BOT_PHONE_NUMBER> register
# 如需 Captcha：
signal-cli -a +<BOT_PHONE_NUMBER> register --captcha '<SIGNALCAPTCHA_URL>'
signal-cli -a +<BOT_PHONE_NUMBER> verify <VERIFICATION_CODE>验证并配对
bash
systemctl --user restart openclaw-gateway
openclaw doctor
openclaw pairing approve signal <PAIRING_CODE>外部 Daemon 模式
json
{
"channels": {
"signal": {
"httpUrl": "http://127.0.0.1:8080",
"autoStart": false
}
}
}访问控制
json
{
"channels": {
"signal": {
"dmPolicy": "pairing",
"allowFrom": ["+8613800138000"],
"groupPolicy": "allowlist",
"groupAllowFrom": ["+8613800138000"]
}
}
}消息行为
- 文本分块：
textChunkLimit（默认 4000 字符），支持chunkMode: "newline"段落分割 - 媒体大小上限：
mediaMaxMb（默认 8MB） - 自动发送打字指示器，
sendReadReceipts: true转发已读回执（群组不支持）
投递目标格式
| 类型 | 格式 |
|---|---|
| DM（手机号） | signal:+8613800138000 |
| DM（UUID） | uuid:<id> |
| 群组 | signal:group:<groupId> |
故障排查
bash
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
openclaw pairing list signal
pgrep -af signal-cli安全注意
- signal-cli 账号密钥在
~/.local/share/signal-cli/data/，迁移服务器前备份 - 保持
dmPolicy: "pairing"策略 - 不要让个人 Signal 主账号与 Bot 共用同一号码
原文：Signal - OpenClaw | 来源：OpenClaw 官方文档