Table of contents
Install signal-cli
macOS (Homebrew)
brew install signal-cliLinux (Debian/Ubuntu)
sudo apt-get install signal-cliWindows
Download the latest release from GitHub and extract to a folder on your PATH.
Register Your Number
Register your Signal number with signal-cli:
signal-cli -u +15555550123 registerYou’ll receive an SMS with a verification code. Verify:
signal-cli -u +15555550123 verify YOUR_CODELogin Command
Run the OpenClaw Signal login:
openclaw channels login signal --number +15555550123Replace +15555550123 with your Signal number.
Send First Message
Send a test message to your Signal number to verify the connection.
Next Steps
- Getting Started Overview
- Allowlists and Sender Policies
- Daily Brief Workflow
- Signal Setup Guide
- Signal Troubleshooting
FAQ
Q: Do I need to keep Signal app on my phone?
A: No. signal-cli works independently. However, keep your phone for initial registration.
Q: Can I use a landline?
A: No. Signal requires a mobile number for registration.
Q: What if I lose my registration?
A: Re-register with signal-cli -u YOUR_NUMBER register.
Q: How do I set up a second number?
A: Register each number separately and configure multiple Signal channels in OpenClaw.
Q: How do I disconnect?
A: Run openclaw channels logout signal.