O
OpenClaw

Signal 接入

将 OpenClaw 接入 Signal，在注重隐私的加密通讯应用中使用 AI 助手。

Beta 功能： Signal 接入目前处于测试阶段， 功能和稳定性可能不如其他频道完善。

前置要求

  • 一个 Signal 账号
  • Signal CLI 工具（独立进程）
  • （可选）Signal 桌面应用

配置步骤

1. 安装 Signal CLI

Signal 接入需要 signal-cli 作为依赖：

# macOS brew install signal-cli # Linux (Debian/Ubuntu) # 下载预编译版本或从源码编译 # 参考：https://github.com/AsamK/signal-cli

2. 注册 Signal 账号（如未注册）

signal-cli -a +86138xxxxxxxx register

你会收到验证码，然后使用：

signal-cli -a +86138xxxxxxxx verify 123456

3. 配置 OpenClaw

编辑配置文件：

{
  "channels": {
    "signal": {
      "enabled": true,
      "account": "+86138xxxxxxxx",
      "allowFrom": ["+86139xxxxxxxx"]
    }
  }
}

4. 启动 Gateway

openclaw gateway restart

配置选项

选项说明
accountSignal 账号（手机号，带国家代码）
allowFrom允许访问的手机号列表

已知限制

  • 需要独立运行 signal-cli 进程
  • 群聊支持有限
  • 媒体消息（图片/视频）处理不完善
  • 在某些地区可能需要网络工具

故障排查

无法连接 signal-cli

确保 signal-cli 在 PATH 中可访问，或指定完整路径：

which signal-cli

收不到消息

  • 检查 signal-cli 是否已注册并登录
  • 尝试手动发送测试消息：signal-cli send -m "test" +86139xxxxxxxx
  • 查看 OpenClaw 日志中的错误信息