A robust integration for automating Signal messenger interactions through a local CLI installation on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install signal-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install signal-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is signal-cli (Signal Messaging)?
The signal-cli skill provides a bridge between AI agents and the Signal messaging platform, leveraging a local signal-cli binary. It is designed to facilitate secure, encrypted communication by allowing agents to send messages, look up contacts, and manage accounts directly from the command line. This skill is a core part of the Openclaw Skills ecosystem, enabling privacy-focused messaging within automated developer workflows.
By utilizing specialized Python scripts for contact resolution, the skill ensures that agents can handle fuzzy name matching and multiple recipient scenarios gracefully. It prioritizes safety by requiring confirmation before dispatching messages, making it an ideal choice for developers who value both automation and security.
signal-cli (Signal Messaging) Use Cases
- Sending automated notifications or status alerts to Signal contacts or groups.
- Resolving recipient phone numbers from nicknames or partial names using fuzzy matching.
- Auditing and listing registered Signal accounts and contact databases.
- Integrating encrypted messaging into DevOps pipelines or personal productivity scripts.
How signal-cli (Signal Messaging) Works
- The agent identifies a user intent to interact with Signal (e.g., sending a message or finding a contact).
- It queries the local signal-cli installation to retrieve account details or contact lists in JSON format.
- If a name is provided instead of a number, the agent runs a Python-based lookup script to resolve the identity to an E.164 formatted phone number.
- The agent presents the resolved recipient and the intended message to the user for final verification.
- Upon confirmation, the agent executes the message dispatch command through the signal-cli interface.
signal-cli (Signal Messaging) Setup
To use this skill, ensure that signal-cli is installed and registered on your macOS system. You will also need Python 3 for the helper scripts.
Verify your account status:
signal-cli listAccounts
List your contacts to ensure the database is accessible:
signal-cli -o json -u "+YOUR_PHONE_NUMBER" listContacts
signal-cli (Signal Messaging) Data Schema & Taxonomy
The skill manages data primarily through CLI flags and JSON outputs. The following table describes the primary data elements used:
| Element | Description |
|---|---|
| Account | The E.164 phone number of the registered sender. |
| Recipient | The target phone number or name for message delivery. |
| Contact Query | A search string used for fuzzy-ish matching against nicknames or names. |
| Message Content | The text payload to be transmitted over the Signal protocol. |
signal-cli (Signal Messaging) Advanced Features
- Fuzzy contact matching: Uses specialized scripts to handle approximate name matches and multiple results.
- JSON Interoperability: Outputs contact data in structured JSON for easier agent parsing.
- Multi-Account Support: Capability to switch between different registered Signal accounts on the same machine.
- Safety Confirmation Layer: Built-in patterns to confirm recipient identity and message sensitivity before execution.
SKILL.md
Loading
Related Openclaw Skills
Nano PDF Edit
An AI-powered CLI tool that allows developers to visually edit and update PDF documents using natural language prompts.
QXMP Oracle
A high-performance oracle integration for fetching cryptographically verified real-world asset (RWA) data and proof-of-reserve status from the QELT blockchain.
QELT Indexer
A high-performance REST API skill for querying indexed QELT blockchain data including blocks, transactions, and wallet balances.
QELT DEX
A specialized tool for Uniswap v4 operations, liquidity management, and WQELT wrapping on the QELT Mainnet.
Intervals.icu API Management
A comprehensive integration for managing athlete profiles, training activities, calendar events, and wellness data via the Intervals.icu API.
Browser
A Puppeteer-powered headless browser skill for rendering web pages and extracting readable content for AI agents.
Featured*
