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/reolink-camera
tools
VerifiedTrustedCommunity
Use exact configured Reolink cameras through the local Home Hub for availability and power status, fresh stills, visual commentary, protected Dylan/Julia/household sharing, and reversible spotlight control. Supports trusted owner tasks and explicitly scoped proactive automations; not for Nest or Ring cameras, arbitrary recipients, recordings, account changes, or raw camera APIs.
2SKILL.mdUpdated Jul 28, 2026
Dbochman/plant-tracker
data-ai
VerifiedTrustedCommunity
Privately manage Dylan and Julia's household plant inventory and care history by physical location, bed, and exact Flower Cam view. Use for confirmed plant onboarding from camera conversations, camera- or bed-filtered inventory, record corrections, individual or whole-bed care, and private filtered exports. Pair with reolink-camera when an owner asks about plants visible in Flower Cam images.
2SKILL.mdUpdated Jul 28, 2026
Dbochman/reachy-control
testing
VerifiedTrustedCommunity
Inspect and control the physically secured Reachy Mini at Crosstown through ClawBody. Use for requests to check Reachy, look around, express an emotion, play any official emotion or dance preset, speak proactively, mute or unmute its microphone, stop movement, or describe what its camera sees.
2SKILL.mdUpdated Jul 16, 2026
Dbochman/reachy-continuity
tools
VerifiedTrustedCommunity
Handle Reachy/iMessage handoffs, selective durable memory, forgetting, and diagnostics; automatic context comes from the gateway plugin.
2SKILL.mdUpdated Jul 16, 2026