add-imessage

Wire the iMessage adapter into NanoClaw for local macOS or Photon API modes.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/wrightchin/nanoclaw-playground --skill add-imessage-wrightchin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-imessage
Source: https://github.com/wrightchin/nanoclaw-playground/tree/main/.claude/skills/add-imessage
Command: npx skills add https://github.com/wrightchin/nanoclaw-playground --skill add-imessage-wrightchin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables NanoClaw to communicate with iMessage by wiring in an iMessage adapter and supporting both local macOS mode and remote Photon API mode.

Core Features & Use Cases

  • Local macOS mode (with Full Disk Access) for iMessage integration on the host
  • Remote mode via Photon API for iMessage interactions without local setup
  • Self-registration and incremental integration into the channels system for a running agent

Quick Start

Fetch the iMessage adapter, wire it into your build, configure environment variables, and restart the container to enable iMessage integration.

Frequently Asked Questions about add-imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate iMessage with a chat agent on macOS?

Integrating iMessage requires fetching the iMessage adapter, copying it into your build, and appending a self-registration import. You then configure environment variables like IMESSAGE_ENABLED in .env and restart the container to activate iMessage integration.

What environment variables do I need to configure for iMessage channel integration?

You must configure IMESSAGE_ENABLED, IMESSAGE_LOCAL, IMESSAGE_SERVER_URL, and IMESSAGE_API_KEY in your .env file. These variables toggle the iMessage channel, switch between local macOS and remote modes, and authenticate the remote Photon API connection.

Does iMessage integration work without local macOS setup?

Yes, iMessage integration works without a local macOS setup by using the remote Photon API mode. You set IMESSAGE_LOCAL to false and configure IMESSAGE_SERVER_URL and IMESSAGE_API_KEY to route iMessage interactions through the remote server.

How do I wire the iMessage adapter into the NanoClaw build?

Wiring the iMessage adapter involves fetching the channels branch, copying the adapter files, appending the self-registration import, installing the adapter package, and running the build process. This enables self-registration into the channels system.

Why do I need Full Disk Access for local iMessage integration?

Full Disk Access is required for local iMessage integration because the macOS operating system restricts access to the local iMessage database and chat attachments. Granting Full Disk Access allows the local adapter to read and send messages.