Skip to content
BrainRoad BrainRoad
Documentation Menu

Signal Setup

Connect your agent to Signal for secure messaging.

On this page

How Signal Connection Works

Your agent connects to Signal as a linked device, the same way Signal Desktop works. Your phone stays the primary device, and your agent operates as an additional endpoint. All messages remain end-to-end encrypted — the platform never sees message content.

How to Connect Signal

After your agent finishes onboarding, you can connect Signal in two ways:

From the Dashboard

  1. Go to your agent’s detail page
  2. Click “Add Channel” in the Getting Started panel
  3. Select Signal
  4. Follow the on-screen instructions
  5. When prompted, scan the QR code with your phone and approve the link

From the Console

Open the Console and run:

openclaw channels add

Then select Signal, or run directly:

openclaw channels login signal

A QR code appears in the terminal. Scan it with Signal on your phone to link the device.

Linking Your Signal Account

  1. Make sure you have Signal open on your phone
  2. Go to Settings and tap Linked Devices
  3. Tap the + button or Link New Device
  4. Scan the QR code from your agent’s setup dialog or console
  5. Confirm the link on your phone when prompted

Signal takes a moment to sync after linking. Once complete, your agent is ready to receive and send Signal messages.

After Setup

Your agent can read and respond to Signal messages using your Signal identity. Contacts message your Signal number as usual, and your agent handles replies on your behalf.

Signal’s linked device sessions can expire if your phone is offline for an extended period. If this happens, the agent logs a disconnection in the Activity feed. To reconnect, repeat the setup process above.

Privacy

Signal’s end-to-end encryption applies to your agent’s linked device session. Messages are decrypted only on your phone and inside your agent’s isolated container. No other user or system on the platform can access your Signal messages.