iMessage - OpenClaw Skill — OpenClaw Tutorials

Install Command

npx clawhub@latest install imessage

Installation Guide

Check Environment

Make sure Node.js 22+ and OpenClaw are installed. Run openclaw --version in your terminal to verify.

Run Installation

Run the install command above in your terminal. ClawHub will automatically download and install iMessage to the ~/.openclaw/skills/ directory.

Verify Installation

Run openclaw skills list to check your installed skills and confirm iMessage appears in the list.

Configure (Optional)

Follow the configuration instructions in the description below to add skill settings to ~/.config/openclaw/openclaw.json5.

Manual Installation: Copy the Skill folder to ~/.openclaw/skills/ or the skills/ directory in your project root. Make sure the folder contains a SKILL.md file.

macOS Native Auto-Reply Apple Ecosystem

Detailed Description

The iMessage skill leverages macOS native AppleScript capabilities, letting OpenClaw directly read and reply to iMessage messages without any third-party services.

Core Features

Message Receiving: Monitor new iMessage messages and trigger OpenClaw processing
Auto-Reply: Automatically generate and send replies based on message content
History Query: Read chat history with specified contacts
Group Support: Support sending and receiving iMessage group messages

Configuration

macOS only. The OpenClaw process needs Accessibility and Automation permissions.

{
  skills: {
    imessage: {
      allowedContacts: [],  // Empty = all contacts
      autoReply: true,
      replyDelay: 2         // Reply delay (seconds)
    }
  }
}

Use Cases

Personal AI assistant for Apple ecosystem users
Smart auto-replies when family and friends send messages
Use iMessage as an interaction entry point for OpenClaw

Notes

This skill is only available on macOS and requires the Messages app to remain running. On first use, the system will display a permission request dialog that must be manually authorized.

← Back to Skills List