Signal

​

Capabilities

​

Requirements

• A dedicated phone number for the bot
• signald running on the same machine as profClaw

​

Setup

# Ubuntu/Debian
apt install signald

# Or run via Docker
docker run -v /var/run/signald:/var/run/signald signald/signald

signaldctl account register +1234567890
# Receive SMS verification code
signaldctl account verify +1234567890 CODE

SIGNAL_SOCKET_PATH=/var/run/signald/signald.sock
SIGNAL_PHONE_NUMBER=+1234567890
# Optional: restrict to specific numbers
SIGNAL_ALLOWED_NUMBERS=+0987654321,+1122334455

profclaw doctor --provider signal

​

Environment Variables

​

Configuration Example

SIGNAL_SOCKET_PATH=/var/run/signald/signald.sock
SIGNAL_PHONE_NUMBER=+12125551234
SIGNAL_ALLOWED_NUMBERS=+19876543210

chat:
  signal:
    socket_path: "${SIGNAL_SOCKET_PATH}"
    phone_number: "${SIGNAL_PHONE_NUMBER}"
    allowed_numbers:
      - "+19876543210"

services:
  profclaw:
    image: profclaw/profclaw:latest
    volumes:
      - signald_socket:/var/run/signald
    environment:
      SIGNAL_SOCKET_PATH: /var/run/signald/signald.sock
      SIGNAL_PHONE_NUMBER: "+12125551234"
  signald:
    image: signald/signald:latest
    volumes:
      - signald_socket:/var/run/signald
      - signald_data:/signald
volumes:
  signald_socket:
  signald_data:

​

Notes

• Status: Beta
• signald is an unofficial Signal client - it may break when Signal updates its protocol.
• The SIGNAL_ALLOWED_NUMBERS allowlist is strongly recommended for security.
• Signal requires a real phone number capable of receiving SMS.
• signald stores Signal keys locally - keep signald_data secure.

​

Related

• Chat Providers Overview - Compare all 27 supported channels
• Matrix - Federated E2EE messaging with official protocol support
• Telegram - Simpler bot setup without the signald dependency
• Security Overview - Protecting your profClaw deployment