Signal消息发送

技能简介

signal-cli 是一个基于本地 signal-cli 二进制文件的 Signal 消息收发工具，支持在 macOS 上发送文本消息、附件，查询联系人列表，以及通过姓名/昵称/电话号码解析收件人。

业务背景

为团队提供安全的本地消息发送能力，无需依赖云端服务即可完成Signal通讯。适用于需要保护隐私的内部通知、客户触达或自动化告警场景，确保敏感信息在可控环境中流转，同时支持联系人智能解析，降低人工查找成本。

落地案例：某合规团队需向外部顾问发送机密文件摘要，通过该工具可直接在本地Mac设备上操作：输入顾问姓名模糊匹配到正确联系人，系统自动列出匹配选项供确认；选定后附上加密文档路径，经二次确认收件人和内容后发出。全程数据不经过第三方平台，满足审计要求。

能做什么

• 向 Signal 联系人发送文本消息和附件
• 列出已注册的 Signal 账户
• 以 JSON 格式导出联系人列表
• 通过模糊匹配查找联系人（支持姓名、昵称、电话号码）
• 将联系人名称自动解析为电话号码后发送消息

使用说明

前置条件

1. 安装 signal-cli 并完成账户注册与链接
2. 确保 Python3 环境可用

安装指令

# 通过 Homebrew 安装 signal-cli
brew install signal-cli

# 注册并链接设备（首次使用）
signal-cli link -n "设备名称"
# 或使用现有号码注册
signal-cli -u +86138xxxxxxxx register

常用操作

1. 查看已注册账户

signal-cli listAccounts

2. 列出联系人（JSON 输出）

signal-cli -o json -u "+86..." listContacts

3. 查找联系人

python3 scripts/find_contact.py --account "+86..." --query "联系人姓名"

4. 发送消息

python3 scripts/send_message.py --account "+86..." --to "联系人姓名" --text "消息内容"

若 –to 参数已为 E.164 格式电话号码（如 +86138xxxxxxxx），则直接发送无需解析。

输入与输出

见下方输入与输出表格。

风险提示

• 发送前必须向用户确认收件人和最终消息内容
• 名称解析返回多个匹配结果时，需展示选项供用户选择
• 消息包含敏感信息时，须明确征得用户同意后再发送
• 默认使用生产环境（–service-environment live），遵循标准信任机制
• 依赖本地 signal-cli 安装状态，未注册或断链将导致功能不可用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pseudobun/signal-cli/SKILL.md
来源类型：GitHub 开源技能库