Signal Troubleshooting

Fix signal-cli connection issues

Signal Integration Troubleshooting

Re-link signal-cli Device

Signal sessions expire. Re-link by running:

signal-cli -u +1XXXXXXXXXX link -n "openclaw-bot"

JVM Version Compatibility

signal-cli requires Java 17+. Check your version:

java --version

If below 17, install OpenJDK 17: sudo apt install openjdk-17-jre

signal-cli Daemon Not Running

# Start signal-cli in daemon mode
signal-cli -u +1XXXXXXXXXX daemon --socket /tmp/signal.sock &

Then configure OpenClaw to use the socket file.

Messages Not Delivered

Run signal-cli receive manually to check for pending messages and verify connectivity:

signal-cli -u +1XXXXXXXXXX receive
Launch Your Personal AI Agent
OpenClaw connects to WhatsApp, Telegram, Slack and more. Get started in minutes.
Explore OpenClaw Setup →