add-imessage

Installs and configures an iMessage channel adapter for NanoClaw via the Chat SDK bridge.

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-imessage-rosedwayane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-imessage
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-imessage
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-imessage-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chat-adapter-imessage.

What problem does it solve? NanoClaw does not ship channel adapters in its trunk, so connecting an agent to iMessage requires manually fetching the adapter, registering it, installing its package, and configuring credentials. This Skill automates that entire integration workflow with idempotent, re-runnable steps. ## Core Features & Use Cases - Adapter Installation: Copies the iMessage adapter and its registration test from the channels branch, appends the self-registration import, and installs the pinned chat-adapter-imessage package. - Dual Connection Modes: Supports local mode on macOS (with Full Disk Access for the Node binary) and remote mode via the Photon API with a server URL and API key. - Build Validation: Runs the TypeScript build and a registration integration test to confirm the adapter is wired into the channel registry before going live. - Use Case: You want your NanoClaw agent to answer personal iMessage conversations on your Mac. Run this Skill to install the adapter, grant Full Disk Access, set IMESSAGE_ENABLED=true in .env, and rebuild the service. ## Quick Start Ask the assistant to add the iMessage channel to NanoClaw in local mode on this Mac and walk through the credential setup.

Frequently Asked Questions about add-imessage

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

FAQPage Schema
How do I add iMessage support to NanoClaw?

Run this Skill to copy the iMessage adapter from the channels branch, append the self-registration import to src/channels/index.ts, install chat-adapter-imessage, then build and run the registration test. Finally set the iMessage environment variables and sync them to the container.

How do I connect iMessage to an AI agent on macOS?

Use local mode, which requires granting Full Disk Access to the Node.js binary in System Settings under Privacy & Security. Then set IMESSAGE_ENABLED=true and IMESSAGE_LOCAL=true in the .env file and sync it to the container.

Can I use iMessage integration without a Mac?

Yes, remote mode connects through the Photon API instead of local macOS access. Set IMESSAGE_LOCAL=false along with IMESSAGE_SERVER_URL and IMESSAGE_API_KEY from your Photon account in the .env file.

Why does the iMessage registration test fail?

The test fails if the import './imessage.js' line is missing from the channel barrel, if the barrel fails to evaluate, or if chat-adapter-imessage is not installed. Re-run the install steps, which are idempotent, then rebuild and rerun the test.

How do I remove the iMessage channel from NanoClaw?

Delete the self-registration import, remove the adapter and test files, uninstall chat-adapter-imessage, strip the IMESSAGE_* variables from .env, then rebuild and restart the service. The REMOVE.md file documents each idempotent step.