Signal 通道
通过 Signal 与 Moltbot 进行交互。
先决条件
- Signal 账号(用于注册机器人)
- 独立的手机号(建议使用虚拟号码)
- Docker(推荐)或手动安装信号-cli
配置
使用 Docker(推荐)
bash
# 启动 Signal 容器
docker run -d \
--name moltbot-signal \
-v ~/.moltbot/signal:/data \
-e TZ=Asia/Shanghai \
bbernhard/signal-cli-rest-api
# 添加通道
moltbot channels add --channel signal --account default --signal-http-api http://localhost:8080手动安装
bash
# 安装 signal-cli
# macOS
brew install signal-cli
# Linux
# 参考 https://github.com/AsamK/signal-cli/wiki/Installation注册信号机器人
bash
# 首次运行需要注册
signal-cli -a +1234567890 register
# 验证验证码
signal-cli -a +1234567890 verify 123456添加通道
bash
moltbot channels add --channel signal --account default --phone +1234567890使用
发送消息
bash
moltbot message send --channel signal --target +1234567890 --message "Hello via Signal!"发送图片
bash
moltbot message send --channel signal --target +1234567890 --image /path/to/image.jpg发送附件
bash
moltbot message send --channel signal --target +1234567890 --file /path/to/file.pdf功能
支持的消息类型
- ✅ 文本消息
- ✅ 图片(PNG、JPG、GIF)
- ✅ 音频文件
- ✅ PDF 和文档
- ✅ 群组消息
- ✅ 引用回复
- ❌ 语音消息(不支持直接发送)
- ❌ 视频通话(不支持)
限制
- 附件大小限制:100MB
- 每分钟消息数限制
- 需遵守 Signal 服务条款
故障排除
容器无法启动
bash
# 检查 Docker 状态
docker ps
# 查看容器日志
docker logs moltbot-signal验证码问题
bash
# 请求重新发送验证码
signal-cli -a +1234567890 verify --voice消息未送达
bash
# 检查通道状态
moltbot channels status --channel signal
# 查看详细日志
moltbot channels logs --channel signal注意事项
- 隐私:使用独立的虚拟号码保护隐私
- 合规:确保遵守 Signal 服务条款
- 资源:Docker 容器需要持续运行