Signal - profClaw

profClaw connects to Signal via signald, an unofficial Signal daemon that exposes a local UNIX socket API. All messages are end-to-end encrypted by Signal’s protocol.

Capabilities

Feature	Supported
Direct messages	Yes
Group messages	Yes
End-to-end encryption	Yes (Signal protocol)
Media messages	Yes
Voice/video calls	No
Phone number allowlist	Yes

Requirements

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

Setup

Install signald

# 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

Configure profClaw

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

Verify

profclaw doctor --provider signal

Environment Variables

SIGNAL_SOCKET_PATH

string

required

Path to the signald UNIX socket. Default: /var/run/signald/signald.sock

SIGNAL_PHONE_NUMBER

string

required

Bot phone number in E.164 format (e.g., +12125551234).

SIGNAL_ALLOWED_NUMBERS

string

Comma-separated allowlist of phone numbers that can interact with the bot.

Configuration Example

.env
settings.yml
Docker Compose

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.

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

Chat Providers

​Capabilities

​Requirements

​Setup

​Environment Variables

​Configuration Example

​Notes

​Related

Capabilities

Requirements

Setup

Environment Variables

Configuration Example

Notes

Related