iMessage for macOS for Openclaw

A specialized skill for sending iMessages and SMS via the native macOS Messages app using automated AppleScript commands.

dezhihe91
v1.0.0
Mar 10, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install send-imessage

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install send-imessage 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 iMessage for macOS?

The iMessage skill enables AI agents to interact directly with the macOS Messages application to send text-based communications. By leveraging AppleScript, this Openclaw Skills extension bridges the gap between local system automation and AI-driven workflows, allowing for hands-free messaging.

This tool is particularly effective for developers and power users who need to programmatically trigger notifications or personal messages without leaving their development environment. It supports a wide range of character sets, including English and Chinese, ensuring global compatibility for automated messaging tasks.

iMessage for macOS Use Cases

  • Sending automated notifications or status updates to a mobile device via SMS.
  • Triggering personal reminders to colleagues or family members through iMessage.
  • Integrating messaging capabilities into larger AI-driven automation workflows on macOS.
  • Managing multilingual communication by sending Chinese or English text programmatically.

How iMessage for macOS Works

  1. The agent identifies a messaging intent and extracts the recipient's phone number and the message body.
  2. The skill normalizes the contact data, ensuring the +1 prefix is applied for US-based phone numbers.
  3. A local osascript command is generated to target the application "Messages".
  4. The script activates the Messages app and uses the buddy object to deliver the specified string.
  5. The system returns a confirmation or error log based on the execution of the AppleScript.

iMessage for macOS Setup

To utilize this within your Openclaw Skills library, ensure your macOS environment is properly configured:

  1. Ensure you are logged into iMessage/FaceTime on your Mac.
  2. Grant necessary permissions: Go to System Settings > Privacy & Security > Accessibility and ensure your terminal or AI host is allowed to control your computer.
  3. Test the bridge manually using this bash command:
osascript << 'EOF'
tell application "Messages"
    activate
    send "Test Message" to buddy "+1YOURNUMBER"
end tell
EOF

iMessage for macOS Data Schema & Taxonomy

The iMessage skill processes data through a simple but strict schema to ensure delivery reliability:

Attribute Format Description
Recipient E.164 String Phone number must include the +1 country code for US destinations.
Message UTF-8 String Supports plain text, emojis, and international characters (e.g., Chinese).
Protocol AppleScript Uses the internal buddy method of the macOS Messages dictionary.

iMessage for macOS Advanced Features

  • Multi-language Support: Seamlessly handles UTF-8 encoded text for international messaging.
  • Native Integration: Operates through the official macOS Messages app, maintaining a synced history across all your Apple devices.
  • Workflow Extensibility: Can be combined with other Openclaw Skills to send alerts based on CLI tool outputs or cloud deployment statuses.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*