Skip to content
TakoAPI
Back to skills

signal-messenger-standalone

by lucksus

Coding Agents & IDEs
379Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Full Signal messenger integration for OpenClaw agents.

Description

What This Skill Does

Connects OpenClaw agents to Signal messenger via signal-cli. Handles sending and receiving text, voice notes, images, and attachments with a three-tier contact permission system (owner, trusted, untrusted). Unknown senders are quarantined until the owner approves them, blocking unsolicited prompt injection.

It triggers OpenClaw's wake hook on message arrival so the agent responds immediately instead of waiting for the next scheduled heartbeat.

When to Use It

  • Receiving task instructions from a trusted contact over Signal
  • Sending voice replies to Signal messages using a local TTS engine
  • Approving or rejecting new Signal contacts before the agent engages
  • Transcribing incoming Signal voice notes for agent processing
  • Triggering immediate agent wake when a new Signal message arrives

Example Workflow

INPUT

User asks: sends a voice note to the agent's Signal number

AGENT
  1. 1

    signal-poll.sh receives the incoming voice message and writes it to the conversation log

  2. 2

    Poll script POSTs to OpenClaw /hooks/wake API to wake the agent immediately

  3. 3

    Agent reads pending_wakes and loads the sender's conversation history

  4. 4

    Agent transcribes the voice attachment using Whisper

  5. 5

    Agent generates a reply, converts it to m4a via ffmpeg, and sends it as a voice attachment via signal-send.sh

OUTPUT

Agent sends a spoken reply back to the contact's Signal number within seconds of receiving the message

Requirements

  • signal-cli v0.13.x or later (non-standard install, see github.com/AsamK/signal-cli)
  • Phone number or VoIP number for Signal account registration
  • Java 21+ runtime (required by signal-cli)
  • ffmpeg for audio format conversion
  • Whisper or compatible STT engine (required only for voice transcription)

Installation

clawhub install lucksus/signal-messenger-standalone

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links