signal-cli

What This Skill Does

The signal-cli skill enables your OpenClaw agent to interface directly with the Signal private messaging service using a locally installed signal-cli binary on your macOS machine. It acts as a bridge between natural language commands and the secure messaging protocol, allowing for seamless contact management, recipient resolution, and message transmission. By utilizing this skill, you can automate routine communications, send attachments, or check your Signal messages without leaving the terminal or your integrated AI environment.

Installation

To integrate this functionality, ensure that signal-cli is already installed, configured, and registered on your system. Once your local environment is ready, install the skill via the terminal using the command: clawhub install openclaw/skills/skills/pseudobun/signal-cli. After installation, the agent will detect the available accounts and provide interface methods to interact with your Signal contacts.

Use Cases

This skill is designed for power users who want to streamline their communication workflow. Primary use cases include: sending quick updates to team members or family without manually opening the app, looking up phone numbers associated with Signal contacts for verification, and batching messages to multiple recipients. It is particularly useful for users who spend significant time in CLI environments but need to stay connected to encrypted messaging channels.

Example Prompts

1. "Send a Signal message to Sarah saying that I will be 15 minutes late for our meeting."
2. "Can you check my Signal contacts and find the phone number for my contact named 'Project Lead'?"
3. "Send a Signal message to +15550109999 with the text 'Deploying the latest updates to the staging server.'"

Tips & Limitations

Safety is paramount when automating messages. Always confirm the recipient and message content when the agent performs a lookup, especially if the query returns multiple matches for a given name. The skill leverages python3 helper scripts to perform fuzzy matching, which improves accuracy but may occasionally require manual intervention if your contact list has duplicate names or complex nicknames. Ensure your local signal-cli binary is updated frequently to maintain compatibility with the Signal protocol. Note that this skill does not support advanced group management or voice/video calls; it is strictly limited to text and basic attachment messaging.