II. 频道系统 - 5. Signal

📍 课程位置
阶段：II. 频道系统
课序：第 5 课
前置知识：II-4. Slack
后续课程：II-6. iMessage

🎯 本课核心问题（你不懂我就这样教你）

Signal 接入的典型困惑：

Signal 不是开放平台，我怎么接 Bot？
signal-cli 是什么？为什么要用它？
注册/绑定流程为什么这么“麻烦”？
怎么保证安全，不让任何人都能随便给我发命令？

一句话回答：
OpenClaw 的 Signal 通道一般依赖 signal-cli 作为“桥”，它代表一个 Signal 账号收发消息。

🧠 心智模型：Signal = “用命令行客户端模拟一个账号”

类比：

Telegram/Slack/Discord：官方给你 Bot 平台（token）
Signal：没有官方 bot 平台
所以我们用 signal-cli 让一台机器“登录一个 Signal 账号”，再由 OpenClaw 驱动它收发

这就像：
你没有 API，只能找一个“代聊手机”登录账号，然后让程序控制它。

✅ 验收标准

[ ] signal-cli 已安装并可运行
[ ] signal-cli 已注册并绑定到某个号码
[ ] OpenClaw Signal 通道能收消息
[ ] 能回消息
[ ] 配好 dmPolicy（pairing/allowlist）确保安全

🔧 第一步：准备 signal-cli

你需要先确保环境里有 signal-cli（具体安装方式以官方/平台文档为准）。

验证：
signal-cli --version

🔧 第二步：注册/绑定 Signal 账号（核心步骤）

Signal 的“机器人账号”本质上就是一个普通号码。

典型流程：

使用 signal-cli 注册（会发验证码）
输入验证码完成验证
绑定成功后，signal-cli 能代表这个号码收发消息

注意：注册过程会涉及短信/语音验证，可能需要你人工协助一次。

🔧 第三步：在 OpenClaw 配置启用 Signal

在 ~/.openclaw/openclaw.json：

{
channels: {
signal: {
enabled: true,

  // 这里通常需要告诉 OpenClaw signal-cli 在哪、用哪个号码
  // 字段名以官方文档为准（不同版本可能略有差异）
  number: "+86xxxxxxxxxxx",

  // 安全策略（最重要）
  dmPolicy: "pairing",        // pairing | allowlist | open | disabled
  allowFrom: ["sig:+86yyyyyyyyyyy"],
}

}
}

建议：如果你只给自己用，直接 allowlist 最稳。

🧩 安全建议：Signal 一定要做“最小入口”

因为 Signal 不是 bot 平台，而是“真实账号”，所以更要谨慎：

dmPolicy 推荐 pairing 或 allowlist
不要 open
群聊场景更要谨慎（能不用群就别用群）

⚠️ 常见坑与排查

现象	常见原因	排查
收不到消息	signal-cli 未登录/未绑定	先用 signal-cli 自测
发不出去	账号被封/网络问题	检查 signal-cli 日志
注册失败	验证码/频控	换短信/语音；稍后重试
乱入风险	dmPolicy=open	改 pairing/allowlist

📝 学习心得

Signal 这章的关键不是“字段多”，而是：

它不是标准 bot 平台
你是在“运营一个账号”

因此我给的建议是：

先让 signal-cli 自测收发 OK
再接入 OpenClaw
安全优先：allowlist/pairing

✅ 本课总结（记住 5 句话）

Signal 通道通常依赖 signal-cli 来“模拟一个登录账号”。
先让 signal-cli 自测跑通，再接 OpenClaw。
Signal 的账号就是普通号码，注册/验证需要人工一次。
安全优先：dmPolicy 用 pairing/allowlist，不要 open。
排障先看 signal-cli 是否能独立收发，再看 OpenClaw 配置。

🔗 相关资源

官方文档：https://docs.openclaw.ai/channels/signal
配置参考：https://docs.openclaw.ai/gateway/configuration-reference
下一课：II-6. iMessage