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