Dbochman/openclaw-imessage-ack-reaction
.claude/skills/openclaw-imessage-ack-reaction/SKILL.md
Configure OpenClaw iMessage reactions/tapbacks. Use when: (1) want OpenClaw agent to react to iMessage messages with a tapback (love, like, laugh, etc.), (2) ackReaction config in openclaw.json doesn't produce iMessage tapbacks, (3) need to understand which reaction types iMessage supports. As of v2026.3.2, the agent can send native iMessage tapbacks via the `message` tool with `action: "react"`. The `ackReactionScope` config remains a no-op for iMessage (only wired for Slack/Discord/Telegram in the gateway).
$ install --global
skillsauthnpx skillsauth add Dbochman/dotfiles openclaw-imessage-ack-reactionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 1:49 AM4.9s1 file scanned
SKILL.md
- name:
- openclaw-imessage-ack-reaction
- description:
- |
- Configure OpenClaw iMessage reactions/tapbacks. Use when:
- (1) want OpenClaw agent
- `action:
- react"`. The `ackReactionScope` config remains a no-op for iMessage
- author:
- Claude Code
- version:
- 2.0.0
- date:
- 2026-03-06
OpenClaw iMessage Reactions / Tapbacks
Current Status (v2026.3.2+)
Native iMessage reactions work as of v2026.3.2-beta.1. The agent can send tapbacks
via the message tool with action: "react" and a message_id from inbound metadata.
What Works
- Agent-initiated reactions: The agent can react to any inbound message using the
messagetool withaction: "react". This sends a native iMessage tapback (not a text bubble). - Supported tapback types:
love,like,dislike,laugh,emphasize,question(Apple limitation: no custom emoji reactions on iMessage) - Requires
message_id: The inbound message metadata must include amessage_idfor the agent to target. This is provided automatically by the BlueBubbles provider.
What Does NOT Work
ackReactionScopeconfig: Themessages.ackReactionScopesetting inopenclaw.jsonis a no-op for iMessage. It is only wired for Slack, Discord, and Telegram in the gateway code. Setting it has no effect on iMessage channels.ackReactionconfig: Similarly,messages.ackReactiondoes not trigger automatic tapbacks on iMessage. The gateway's ack flow only handles Slack/Discord/Telegram.
How to Use Reactions
Option 1: Agent-Driven (via SOUL.md instructions)
Instruct the agent in SOUL.md to react to messages:
## Acknowledgment
When you receive an iMessage, react to it with a tapback before responding.
Use the message tool with action "react" and the inbound message_id.
The agent will use the message tool with action: "react" to send a native tapback.
Option 2: Programmatic (via cron job or skill)
Cron jobs and skills can instruct the agent to react as part of their workflow.
Verification
- Send a message to OpenClaw via iMessage
- Confirm a native tapback appears on the message (not a text bubble)
- Check gateway logs: look for react-related delivery entries
Notes
- Tapbacks are native Apple reactions — they appear as the small icon on the message bubble, not as a separate text message
- The
imsg reactCLI still exists but is NOT used by the gateway; reactions go through the BlueBubbles Private API (POST /api/v1/message/react) - Prior to v2026.3.2, reactions were broken (v2026.2.26) or unsupported (v2026.2.14). The old workaround of sending a "eyes" text message is no longer needed.
- Mac Mini SSH user is
dbochman, notdylanbochman
Related Skills
Dbochman/web-search
development
VerifiedTrustedCommunity
Search the web for current information, news, facts, and answers. Use when asked questions about current events, needing to look something up, finding websites, researching topics, or when you need up-to-date information beyond your training data.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/summarize
development
VerifiedTrustedCommunity
Summarize any URL, YouTube video, podcast, PDF, or file into concise text. Use when asked to read an article, summarize a link, get the gist of a video or podcast, extract content from a URL, or when you need to understand what a web page or document contains.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/spotify-speakers
development
VerifiedTrustedCommunity
Play music via Spotify and control Google Home speakers. Use when asked to play music, songs, artists, playlists, podcasts, or control speakers/volume/audio.
1SKILL.mdUpdated Apr 17, 2026
Dbochman/skill-creator
testing
VerifiedTrustedCommunity
Create new OpenClaw skills, modify and improve existing skills, and measure skill performance with evals. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. Also use when asked to "make a skill", "turn this into a skill", "improve this skill", or "test this skill".
1SKILL.mdUpdated Apr 17, 2026