channel guides / signal

CONNECT
SIGNAL.

The most private channel option. Requires installing signal-cli on your server first — a little more setup, worth it if privacy matters to you.

Need OpenClaw running first? → Get the 30-minute setup guide

Before you start: Signal requires a dedicated phone number registered with signal-cli on your VPS. You can use a spare phone number or a VoIP number (e.g. Google Voice). This number will be your bot's identity on Signal.
Step 1 of 3

Install signal-cli on Your Server

Paste this into your VPS terminal. Replace +1YOURNUMBER with your actual phone number including country code.

apt install -y default-jre
curl -LO https://github.com/AsamK/signal-cli/releases/latest/download/signal-cli.tar.gz
tar -xzf signal-cli.tar.gz -C /opt
ln -sf /opt/signal-cli/bin/signal-cli /usr/local/bin/signal-cli
signal-cli -u +1YOURNUMBER register

Signal will send a verification code to that number via SMS or voice call.

Step 2 of 3

Add the Channel in OpenClaw

  • 1Click Channels → Add Channel → Signal
  • 2Enter the phone number you registered with signal-cli
  • 3Enter the verification code Signal sent to that number
  • 4Click Connect
Step 3 of 3

Send a Test Message

  • 1In OpenClaw go to Channels → Signal → Test
  • 2Enter a Signal-registered phone number
  • 3Click Send Test Message

Message delivered? Signal is live. Your OpenClaw will now respond to Signal messages sent to your registered number.

// If it's not working

Registration failed? Make sure default-jre installed cleanly — run java -version to confirm Java is available.
Verification code not arriving? Wait 60 seconds and try the voice call option instead of SMS.
Still stuck? Message us — [email protected] — happy to help.