add-imessage

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

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-imessage-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-imessage
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-imessage
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-imessage-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chat-adapter-imessage.

What problem does it solve? NanoClaw does not ship channel integrations in its main branch, so adding iMessage support requires manually copying adapter code, registering it, installing dependencies, and configuring credentials. This Skill automates that entire idempotent setup workflow. ## Core Features & Use Cases - Adapter Installation: Fetches the iMessage adapter and its registration test from the channels branch, wires the self-registration import, and installs the pinned chat-adapter-imessage package. - Dual Credential Modes: Supports local mode on macOS (requiring Full Disk Access for the Node binary) and remote mode via the Photon API with a server URL and API key. - Validation & Removal: Verifies the build and registration test before proceeding, and includes a companion REMOVE.md for cleanly uninstalling the channel. - Use Case: You want your NanoClaw bot to send and receive iMessages from your Mac. Run this Skill to copy the adapter, grant Full Disk Access to Node, 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 and walk you through the Full Disk Access 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 [email protected], and validate with a build and registration test. Then configure credentials in .env.

What is the difference between local and remote iMessage mode?

Local mode runs on macOS and requires granting Full Disk Access to the Node.js binary to read iMessage data. Remote mode connects through the Photon API using a server URL and API key, so it works without direct macOS message database access.

Does iMessage integration work on Linux or Windows?

Local mode requires macOS because it reads the iMessage database with Full Disk Access. On other platforms you can use remote mode with a Photon server, and the service restart step supports Linux via systemctl.

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 and confirm pnpm run build passes cleanly.

How do I remove the iMessage channel after installing it?

Follow REMOVE.md: delete the self-registration import, remove the adapter and test files, strip the IMESSAGE_* variables from .env, uninstall chat-adapter-imessage, then rebuild and restart the service. Every step is idempotent.